Giải thích API của Claude Code

Claude Code là một tác nhân chạy trong terminal, nhưng bên trong, mọi hành động đều là lệnh gọi đến cùng Anthropic Messages API mà bạn có thể sử dụng trực tiếp. Điều này mang lại lợi ích thiết thực: bạn kiểm soát điểm cuối mà công cụ kết nối, khóa được dùng để tính phí và do đó cả chi phí của một phiên. Trang này giải thích các thành phần hoạt động và cung cấp liên kết đến hướng dẫn thiết lập chi tiết.

“Claude Code API” thực sự có nghĩa là gì

Không có sản phẩm riêng nào mang tên Claude Code API. Claude Code xác thực thông qua gói đăng ký Claude (Pro/Max) hoặc khóa API, và ở chế độ API, công cụ gửi các yêu cầu Messages API tiêu chuẩn — lời nhắc hệ thống, cuộc hội thoại, định nghĩa công cụ và kết quả công cụ — đến điểm cuối được chỉ định trong môi trường của nó.

Điểm cuối đó có thể được cấu hình. Hai biến môi trường kiểm soát mọi thứ: ANTHROPIC_BASE_URL (nơi gửi yêu cầu) và ANTHROPIC_AUTH_TOKEN hoặc ANTHROPIC_API_KEY (tài khoản chịu phí). Trỏ chúng trực tiếp đến Anthropic hoặc đến cổng API tương thích với Anthropic, Claude Code vẫn hoạt động như nhau.

Sử dụng khóa API của riêng bạn với Claude Code

Đặt hai biến trong tệp cấu hình shell hoặc trong ~/.claude/settings.json rồi khởi chạy claude như bình thường. Hướng dẫn đầy đủ kèm ví dụ settings.json có trong <a href="/vi/learn/claude-code-api-key-setup/">hướng dẫn thiết lập khóa API cho Claude Code</a> của chúng tôi.

Một điểm cần lưu ý: nếu ANTHROPIC_API_KEY được đặt trong shell, Claude Code sẽ tính phí theo mức giá API ngay cả khi bạn cũng có gói đăng ký — biến môi trường được ưu tiên. Hãy bỏ đặt biến này nếu bạn định sử dụng gói Pro/Max.

Chi phí của một phiên Claude Code

Các phiên tác nhân tiêu thụ nhiều token: mọi tệp được đọc, kết quả công cụ và bản diff đều được đưa vào ngữ cảnh. Một giờ làm việc tập trung có thể tiêu thụ hàng triệu token đầu vào, vì vậy việc lưu đệm lời nhắc rất quan trọng — ngữ cảnh lặp lại được đọc lại từ bộ nhớ đệm với chi phí chỉ bằng một phần nhỏ trên các điểm cuối hỗ trợ.

Chúng tôi phân tích số liệu thực tế theo từng phiên, cách bộ nhớ đệm hoạt động và cách duy trì chi phí hợp lý cho các phiên dài trong <a href="/vi/learn/claude-code-api-costs/">hướng dẫn chi phí API của Claude Code</a>.

Anthropic trực tiếp so với cổng API

Truy cập trực tiếp Anthropic API mang lại cơ chế tính phí theo mức sử dụng và hỗ trợ từ chính nhà cung cấp — lựa chọn mặc định phù hợp cho các nhóm có ngân sách ổn định. Các cổng API độc lập như AI Prime Tech (không liên kết với hoặc được Anthropic chứng thực) bán lại quyền truy cập với mức giá cố định hoặc ưu đãi và cung cấp cùng định dạng truyền dữ liệu, nên Claude Code hoạt động chỉ bằng cách thay đổi URL cơ sở và khóa.

Dù chọn cách nào, hãy xác minh rằng truyền phát hoạt động xuyên suốt và các mô hình bạn cần có sẵn với đúng ID mà Claude Code yêu cầu — xem <a href="/vi/learn/use-claude-api-with-claude-code/">sử dụng Claude API với Claude Code</a> để biết danh sách kiểm tra đầy đủ.

# Claude Code with your own key + custom endpoint
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

# or persist in ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

Câu hỏi thường gặp

AI Prime Tech là một cổng API độc lập. AI Prime Tech không liên kết với, không được Anthropic chứng thực và không phải là đại lý bán lại của Anthropic. Claude và các tên mô hình liên quan là nhãn hiệu của chủ sở hữu tương ứng.