Ôn nhanh CCDV-F

Bảng tra cứu cô đọng từ tài liệu ôn.

• Khối lượng lớn, không gấp, chạy qua đêm — Message Batches API (rẻ 50%, ≤ 24 giờ)
• Người dùng đang chờ câu trả lời dài — Messages API realtime + streaming
• Output dừng giữa câu — stop_reason: "max_tokens" → tăng max_tokens hoặc yêu cầu ngắn hơn
• pause_turn sau nhiều lượt web search — Gửi lại nguyên nội dung assistant để tiếp tục
• Phần đầu prompt giống nhau ở mọi request, chi phí cao — Prompt caching: phần cố định trước, cache_control cuối phần cố định
• cache_read_input_tokens luôn bằng 0 — Tiền tố bị đổi (timestamp, thứ tự tool) hoặc ngắn hơn 512 token
• Nội dung từ web, email, tài liệu ngoài — Không tin cậy: bọc là dữ liệu, least privilege, xác nhận trước hành động nhạy cảm
• "Phải xảy ra mọi lần" (audit, chặn theo chính sách) — Hook hoặc code ứng dụng — không phải prompt
• Chặn lệnh phá hoại trong Claude Code — Hook PreToolUse + exit code 2 (hoặc JSON deny)
• Dịch vụ nội bộ dùng chung cho nhiều app — MCP server
• Chỉ một app cần gọi API nội bộ — Custom tool
• Trace: tool trả 401 hoặc timeout — Lỗi tích hợp → sửa tích hợp, báo qua is_error — không sửa prompt
• 429 có header retry-after — Retry exponential backoff + jitter, tôn trọng retry-after
• 429 không có retry-after, mãi không hết — Thường là spend cap — retry thêm vô ích
• "Đặt temperature: 0 cho nhất quán" — Model hiện tại trả 400 → dùng chỉ dẫn, ví dụ, structured outputs
• Quá chậm hoặc quá đắt — Giảm effort trước khi đổi model; đo bằng eval
• JSON đúng schema nhưng dữ liệu sai — Vẫn kiểm tra quy tắc nghiệp vụ; check stop_reason trước khi parse
• Số bước không đoán trước được — Agent; bước cố định → workflow
• Subtask chỉ biết lúc chạy — Orchestrator–workers
• Inference phải chạy ở Mỹ — inference_geo: "us"
• Workload bắt buộc ZDR — Kiểm tra từng tính năng; Managed Agents không đủ điều kiện
• API key bị lộ — Vô hiệu hóa/xóa ngay, tạo key mới, kiểm tra usage
• Hàng trăm tool, Claude chọn sai — Tool search tool + defer_loading; mô tả tool rõ hơn
• Prompt dài 20k+ token — Tài liệu ở đầu, câu hỏi ở cuối
• Chạy Claude Code trong CI — claude -p + --output-format json, thêm --bare
• Quy ước chỉ cho một vùng code — .claude/rules/ với paths — chỉ nạp khi làm với file khớp
• Sở thích cá nhân trong một dự án — CLAUDE.local.md (gitignore)
• Prompt chạy trong Claude Code nhưng qua API thì không — API không nạp CLAUDE.md → đưa chỉ dẫn vào system
• Người dùng chờ, câu trả lời ngắn — Messages API đồng bộ
• Người dùng chờ, output dài — Streaming (tránh kết nối rảnh bị cắt)
• Việc lớn, chấp nhận chờ tới 24 giờ — Message Batches (có thể kèm cache 1 giờ)
• Tiền tố dùng lại ≥ 512 token — Cache: breakpoint ở cuối phần cố định
• Cấm Claude dùng tool ở lượt này — tool_choice: none
• Cần ép gọi tool trên Opus 5.5 / Sonnet 5.5 / Fable 5.1 — auto + strict tool use + chỉ dẫn rõ (any/tool trả 400)
• Gọi MCP server từ xa từ app dùng Messages API — MCP connector (mcp_servers, beta)
• Phân loại/trích xuất khối lượng lớn, độ trễ thấp — Haiku 5.5
• Không chắc chọn model nào — Bắt đầu với Opus 5.5
• Agent chạy hàng giờ, nghiên cứu sâu — Fable 5.1
• 429 / 500 / 529 — Retry có backoff + jitter
• 400 / 401 / 403 / 413 — Sửa request hoặc credential — không retry
• Chỉ cần chạy hàm của tôi trong vòng lặp tool — Tool runner (beta) của SDK
• Cần vòng lặp, tool và context của Claude Code dạng thư viện — Agent SDK
• Harness + sandbox được host, việc dài, bất đồng bộ — Managed Agents (beta, không ZDR)
• end_turn — Claude trả lời xong tự nhiên
• max_tokens — Chạm giới hạn max_tokens — output bị cắt
• stop_sequence — Claude sinh ra một trong các stop_sequences của bạn
• tool_use — Claude gọi tool — chạy tool, gửi tool_result
• pause_turn — Vòng lặp server tool chạm giới hạn — gửi lại để tiếp tục
• refusal — Claude từ chối — đọc stop_details, xử lý nhánh riêng
• model_context_window_exceeded — Đầy context window — coi như bị cắt
• 429 — rate_limit_error (rate limit hoặc spend cap)
• 500 — api_error — lỗi nội bộ, retry có backoff
• 529 — overloaded_error — API quá tải tạm thời
• 413 — request_too_large — request vượt giới hạn byte
• Header request-id — ID để truy vết từng request, ghi log
• anthropic-version — Header phiên bản API; mới nhất 2026-10-21
• Ghi cache 5 phút / 1 giờ — 1,25× / 2× giá input
• Đọc cache — 0,1× (0,05× Opus/Sonnet 5.5; 0,025× Fable 5.1)
• Tiền tố cache tối thiểu (model hiện tại) — 512 token
• Message Batches — Rẻ 50%, hết hạn 24 giờ, kết quả giữ 29 ngày
• Effort mặc định Opus 5.5 / Haiku 5.5 — medium (model khác: high)
• claude -c / --resume — Tiếp tục phiên gần nhất / mở phiên cụ thể
• --fork-session — Tạo session ID mới khi resume
• --bare — Bỏ tự nạp hook, skill, MCP, CLAUDE.md
• Hook exit code 2 — Chặn hành động; stderr gửi cho Claude
• defer_loading: true — Tool chỉ được nạp khi tool search tìm tới
• is_error: true — Báo tool lỗi trong tool_result