Chi phí, thanh toán và vận hành22 tháng 10, 2026Flatkey Team

Khóa API Anthropic (2026): Cách lấy, các loại khóa, thiết lập Claude Code và sửa lỗi

Hướng dẫn từng bước về khóa API Anthropic năm 2026: thiết lập Console, khóa cá nhân và khóa tài khoản dịch vụ, quy tắc hết hạn, request đầu tiên, Claude Code, chi phí và cách sửa lỗi.

Khóa API Anthropic (2026): Cách lấy, các loại khóa, thiết lập Claude Code và sửa lỗi

Để lấy khóa API Anthropic, hãy đăng nhập Claude Console, mở API keys, nhấn Create key, chọn tên, thời hạn và tài khoản liên kết (chính bạn hoặc một tài khoản dịch vụ), rồi sao chép khóa bắt đầu bằng sk-ant- vì Console chỉ hiển thị khóa một lần. Hãy thêm phương thức thanh toán hoặc nạp tín dụng trước khi gọi API: mức sử dụng được tính theo token và tài khoản mới chỉ nhận một ít tín dụng dùng thử miễn phí, theo trang giá của Anthropic tại ngày 22/10/2026. Cùng một khóa dùng được cho mọi mô hình Claude; không có "khóa Claude API" hay "khóa Sonnet" riêng.

Hướng dẫn này dành cho lập trình viên cần khóa cho script, agent lập trình như Claude Code hoặc dịch vụ production. Bài viết bao gồm các loại khóa năm 2026 (khóa cá nhân, khóa tài khoản dịch vụ và khóa workspace kiểu cũ), quy tắc hết hạn, header anthropic-workspace-id khiến nhiều request đầu tiên thất bại, mã chạy được, các lỗi 401/400/429 thường gặp và khi nào dùng một khóa cho nhiều nhà cung cấp sẽ hợp lý hơn.

Khóa API Anthropic trong 60 giây

Bước	Ở đâu	Cần biết (kiểm tra ngày 22/10/2026)
1. Đăng nhập	platform.claude.com	Khóa API nằm trong Claude Console, không phải ứng dụng chat claude.ai
2. Mở API keys	Settings → API keys	Nếu Create key bị mờ, vai trò của bạn không được phép tạo khóa
3. Tạo khóa	Tên, thời hạn, tài khoản liên kết, workspace (tùy chọn)	Thời hạn có sẵn: 3 giờ, 1 ngày, 7 ngày, 30 ngày, tùy chỉnh hoặc Never
4. Sao chép một lần	Chỉ hiển thị khi tạo	Bắt đầu bằng `sk-ant-`; khóa bị mất không thể xem lại
5. Thêm thanh toán	Settings → Billing	Trả theo mức dùng bằng USD; mỗi cấp có giới hạn chi tiêu hằng tháng
6. Kiểm tra	`POST https://api.anthropic.com/v1/messages`	Gửi khóa qua `Authorization: Bearer` (hoặc `x-api-key` kiểu cũ)

Nguồn: tài liệu Get your Claude API key và Authentication của Anthropic, kiểm tra ngày 22/10/2026.

Từng bước: tạo khóa API Anthropic

Tạo hoặc đăng nhập tài khoản Console tại platform.claude.com. Gói chat Claude và API được tính tiền riêng, dù các gói Max có kèm tín dụng API hằng tháng (chi tiết bên dưới và trong hướng dẫn giá API Anthropic của chúng tôi).
Mở trang API keys. Nếu tổ chức của bạn có nhiều workspace, bạn có thể chọn một workspace để giới hạn khóa trong đó.
Nhấn Create key và điền ba trường: tên dễ nhận biết (ví dụ ci-staging-claude), thời hạn và Linked account. Liên kết với chính bạn tạo khóa cá nhân; liên kết với tài khoản dịch vụ tạo khóa cho các tác vụ dùng chung.
Sao chép khóa ngay lập tức. Tài liệu của Anthropic cho biết khóa đầy đủ chỉ hiển thị một lần. Hãy lưu vào trình quản lý mật khẩu hoặc trình quản lý bí mật, tuyệt đối không đưa vào kho Git.
Nạp tín dụng hoặc thêm thẻ ở trang Billing. Không có số dư, request đầu tiên sẽ lỗi dù khóa hợp lệ.
Xuất thành biến môi trường để các SDK tự động đọc:

export ANTHROPIC_API_KEY="sk-ant-api03-..."   # macOS/Linux, current shell only
# Windows PowerShell:
# setx ANTHROPIC_API_KEY "sk-ant-api03-..."

Nên chọn loại khóa nào?

Năm 2026 Anthropic phân biệt ba loại khóa. Chọn sai loại là lý do phổ biến nhất khiến khóa "đột nhiên ngừng hoạt động" khi có người rời nhóm.

Loại khóa	Hoạt động với danh nghĩa	Ngừng hoạt động khi	Dùng cho
Khóa cá nhân	Chính bạn, với vai trò của bạn	Bạn rời tổ chức, hoặc khóa chỉ cho một workspace mất quyền vào workspace đó	Phát triển cục bộ, script của bạn, Claude Code của bạn
Khóa tài khoản dịch vụ	Một tài khoản dịch vụ	Tài khoản dịch vụ bị lưu trữ hoặc bị gỡ khỏi workspace	Pipeline CI, dịch vụ production, agent dùng chung
Khóa workspace (kiểu cũ)	Không ai cả (thuộc về workspace)	Hết hạn, bị vô hiệu hóa/xóa, hoặc workspace bị lưu trữ	Chỉ cho tích hợp hiện có; nên chuyển đổi

Dữ liệu từ trang Authentication của Anthropic, ngày 22/10/2026. Anthropic khuyến nghị khóa cá nhân hoặc khóa tài khoản dịch vụ vì chúng gắn với danh tính và không thể tồn tại lâu hơn người hoặc tác vụ sở hữu chúng. Với production trên AWS, Google Cloud, Azure, GitHub Actions hoặc Kubernetes, cùng trang này khuyến nghị Workload Identity Federation, thay khóa tĩnh bằng token ngắn hạn.

Quy tắc hết hạn nên biết

Thời hạn được chọn khi tạo và không thể thay đổi sau đó.
Anthropic gửi email cho người tạo 7 ngày trước khi hết hạn với khóa có thời hạn từ 14 ngày, và 1 ngày trước với khóa từ 7 ngày; khóa ngắn hơn hết hạn mà không báo trước.
Sau khi hết hạn, request trả về 401 authentication_error, và khóa hết hạn không thể kích hoạt lại, chỉ có thể xóa.
Disable có thể hoàn tác; Delete là vĩnh viễn.

Một cách làm thực tế: dùng khóa 30 ngày cho laptop và agent lập trình, và khóa tài khoản dịch vụ lưu trong trình quản lý bí mật (có xoay vòng) cho máy chủ. Hướng dẫn quản lý khóa API an toàn cho sản phẩm AI và xoay vòng khóa sau gateway của chúng tôi đi sâu hơn.

Kiểm tra khóa: request đầu tiên bằng curl, Python và Node.js

ID mô hình bên dưới, claude-sonnet-5-5, là mô hình Sonnet hiện tại trong tổng quan mô hình của Anthropic tại ngày 22/10/2026.

curl https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Reply with the word ok if this key works."}]
  }'

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Reply with the word ok if this key works."}],
)
print(next(b.text for b in msg.content if b.type == "text"))
print("tokens:", msg.usage.input_tokens, "in /", msg.usage.output_tokens, "out")

// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY
const msg = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 256,
  messages: [{ role: "user", content: "Reply with the word ok if this key works." }],
});
console.log(msg.content.find((b) => b.type === "text")?.text);

Một bài kiểm tra như vậy tốn chưa tới một xu: với giá chính thức của Sonnet 5.5 là $2 cho mỗi triệu token đầu vào và $10 cho mỗi triệu token đầu ra (giá Anthropic, 22/10/2026), 30 token đầu vào và 5 token đầu ra tốn khoảng $0,0001.

Header workspace làm hỏng request đầu tiên

Nếu khóa của bạn không được giới hạn trong một workspace, mọi request phải có anthropic-workspace-id, nếu không API sẽ trả về 400 invalid_request_error với thông báo "This API key is not scoped to a workspace...". Bạn có thể tìm ID ở trang Workspaces trong Console. Cách sửa trong Python:

client = anthropic.Anthropic(
    default_headers={"anthropic-workspace-id": "wrkspc_..."}  # only for keys not scoped to a workspace
)

Khóa tạo cho một workspace duy nhất có thể bỏ qua header này, đó là lý do Anthropic khuyên giới hạn khóa ngay khi tạo (tài liệu Authentication).

Dùng khóa API Anthropic với Claude Code

Claude Code có thể xác thực bằng gói claude.ai, đăng nhập Console, nhà cung cấp đám mây hoặc khóa API. Theo tài liệu xác thực của Claude Code, kiểm tra ngày 22/10/2026:

Nếu đã đặt ANTHROPIC_API_KEY, Claude Code sẽ hỏi có dùng khóa đó không ở lần chạy đầu và bỏ qua bước đăng nhập qua trình duyệt khi bạn đồng ý.
ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN và thiết lập apiKeyHelper áp dụng cho CLI, tiện ích VS Code, Agent SDK và GitHub Actions, nhưng không áp dụng cho Claude Desktop hay phiên trên đám mây.
apiKeyHelper chạy một script trả về khóa, hữu ích để lấy khóa ngắn hạn từ kho bí mật. Nếu script lỗi ba lần, request sẽ thất bại.
Người dùng Console giờ có thể đăng nhập mà không cần tạo khóa API (Claude Code v2.1.242 trở lên), khi đó hệ thống lưu hồ sơ OAuth thay vì khóa tĩnh. Hãy bỏ đặt ANTHROPIC_API_KEY trước khi làm vậy.

export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude        # approve the key when prompted
# inside Claude Code, /status shows which credential is active

Nếu Claude Code báo lỗi token hoặc đăng nhập, xem hướng dẫn lỗi token xác thực Claude Code. Để Claude Code đi qua router thay vì gọi trực tiếp Anthropic, xem thiết lập router API cho Claude Code.

Khóa API Anthropic có miễn phí không?

Tạo khóa thì miễn phí, nhưng dùng thì không. FAQ về giá của Anthropic cho biết người dùng mới nhận "một ít tín dụng miễn phí để thử API"; sau đó mọi request đều tính tiền theo token. Có một ngoại lệ đáng biết: trên claude.com/pricing, kiểm tra ngày 22/10/2026, gói Max 5x ($100/tháng) kèm $100 mỗi tháng và Max 20x kèm $200 mỗi tháng tín dụng API cho Claude Platform; gói Pro ($20/tháng nếu trả theo tháng) không kèm. Giá niêm yết hiện tại cho mỗi triệu token trên trang giá của Anthropic, ngày 22/10/2026:

Mô hình	ID mô hình	Đầu vào	Đầu ra	Đọc cache
Claude Fable 5.1	`claude-fable-5-1`	$10.00	$50.00	$0.25
Claude Opus 5.5	`claude-opus-5-5`	$4.00	$20.00	$0.20
Claude Sonnet 5.5	`claude-sonnet-5-5`	$2.00	$10.00	$0.10
Claude Haiku 5.5 (prompt tối đa 100K)	`claude-haiku-5-5`	$0.10	$0.50	$0.01

Batch API giảm một nửa giá đầu vào và đầu ra, còn suy luận chỉ tại Mỹ (inference_geo: "us") áp hệ số 1,1x. Để tính chi phí theo khối lượng công việc, xem hướng dẫn giá API Anthropic đầy đủ của chúng tôi. Nếu cần mô hình thực sự miễn phí để làm prototype, bài so sánh API LLM miễn phí liệt kê các lựa chọn kèm giới hạn thực tế.

Khóa đi kèm giới hạn chi tiêu và giới hạn tốc độ

Cấp sử dụng của tổ chức quyết định cả giới hạn tốc độ lẫn mức trần chi tiêu hằng tháng. Theo trang giới hạn tốc độ của Anthropic, kiểm tra ngày 22/10/2026, mức trần là $500 (Start), $1.000 (Build) và $200.000 (Scale) mỗi tháng; tổ chức mới có thể bắt đầu ở cấp Evaluation thấp hơn. Khi chạm trần, API trả về HTTP 429 cho đến 00:00 UTC ngày đầu tiên của tháng sau, trừ khi bạn yêu cầu cấp cao hơn. Bạn cũng có thể tự đặt giới hạn thấp hơn ở trang Billing, một thói quen tốt cho mọi khóa mà agent tự động sử dụng.

Các lỗi khóa API Anthropic thường gặp và cách sửa

Lỗi	Nguyên nhân có thể	Cách sửa
`401 authentication_error`	Gõ sai, khóa bị thu hồi, vô hiệu hóa hoặc hết hạn	Tạo khóa mới; khóa hết hạn không thể kích hoạt lại
`400 invalid_request_error` nhắc đến workspace	Khóa không giới hạn workspace và không gửi header	Thêm `anthropic-workspace-id` hoặc tạo khóa giới hạn workspace
`404 not_found_error` "Workspace ... not found"	Sai ID workspace, hoặc danh tính của khóa không có quyền	Kiểm tra ID ở trang Workspaces
`429` "reached your API usage limits"	Đã chạm trần chi tiêu hằng tháng của cấp	Yêu cầu nâng cấp hoặc chờ đặt lại hằng tháng
`429` kèm `retry-after`	Vượt số request hoặc token mỗi phút	Chờ rồi thử lại; xem giải thích giới hạn tốc độ LLM
`529 overloaded_error`	Do năng lực của Anthropic, không phải khóa của bạn	Thử lại với backoff hoặc chuyển dự phòng; xem lỗi API 529
Nút Create key bị vô hiệu	Vai trò Console của bạn không được tạo khóa	Nhờ quản trị viên đổi vai trò hoặc cấp khóa tài khoản dịch vụ

Nguồn: tài liệu Authentication, giới hạn tốc độ và lỗi của Anthropic, kiểm tra ngày 22/10/2026.

Giữ khóa an toàn

Không bao giờ dán khóa vào mã front-end, ứng dụng di động hay notebook công khai. Với ứng dụng iOS và macOS cần gọi Claude trực tiếp, Anthropic cung cấp App Attest, cấp token thiết bị hết hạn sau 1 giờ.
Dùng một khóa cho mỗi môi trường và mỗi agent để có thể thu hồi một khóa mà không ảnh hưởng các khóa khác.
Luôn đặt thời hạn, dù dài, để khóa bị lộ có "hạn sử dụng".
Chạy quét bí mật trong CI; hướng dẫn quét bí mật API AI của chúng tôi có ví dụ thiết lập.
Theo dõi mức sử dụng trong Console và đặt giới hạn chi tiêu thấp hơn trần của cấp.

Khi nào một khóa cho nhiều mô hình đơn giản hơn

Khóa Anthropic chỉ mở được Claude. Nếu sản phẩm hoặc agent lập trình của bạn còn gọi GPT, Gemini, DeepSeek, Qwen hay Kimi, bạn sẽ phải quản lý năm khóa, năm số dư và năm bộ giới hạn. Một API hợp nhất như Flatkey cấp một khóa cho tất cả. Ngày 22/10/2026, trang mô hình của Flatkey niêm yết Claude Sonnet 5.5 ở mức $1,60 đầu vào / $8,00 đầu ra cho mỗi triệu token và Claude Opus 5.5 ở mức $3,20 / $16,00, so với giá niêm yết của Anthropic là $2 / $10 và $4 / $20. Anthropic SDK hoạt động chỉ bằng cách đổi base URL, theo hướng dẫn Anthropic SDK của Flatkey:

import anthropic

client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Summarize this changelog in 3 bullets."}],
)
print(next(b.text for b in msg.content if b.type == "text"))

Hãy dùng khóa Anthropic trực tiếp nếu bạn cần tính năng riêng của Anthropic ngay ngày ra mắt, Workload Identity Federation, kiểm soát lưu trú dữ liệu hoặc hợp đồng doanh nghiệp. Để so sánh rộng hơn, đọc Flatkey so với tài khoản trực tiếp tại nhà cung cấp và một khóa API cho nhiều mô hình AI.

FAQ

Làm sao để lấy khóa API Anthropic?

Đăng nhập Claude Console tại platform.claude.com, vào Settings → API keys, nhấn Create key, đặt tên, thời hạn và tài khoản liên kết, rồi sao chép khóa sk-ant- chỉ hiển thị một lần. Nạp tín dụng ở trang Billing trước khi gửi request.

Khóa API Anthropic có miễn phí không?

Tạo khóa miễn phí và tài khoản mới có một ít tín dụng dùng thử, nhưng sau đó mức dùng API được tính theo token. Tại ngày 22/10/2026, Claude API không có gói miễn phí vĩnh viễn.

Khóa Claude API và khóa API Anthropic có giống nhau không?

Có. Tài liệu của Anthropic cho biết khóa của Claude API còn được gọi là khóa API Anthropic. Một khóa dùng được cho mọi mô hình Claude mà tổ chức của bạn có quyền truy cập.

Tìm khóa API Anthropic hiện có ở đâu?

Tại platform.claude.com/settings/keys bạn xem được tên, gợi ý và thời hạn của từng khóa, nhưng không xem được toàn bộ khóa. Nếu làm mất, hãy tạo khóa mới và xóa khóa cũ.

Gói Claude Pro hoặc Max có kèm tín dụng API không?

Pro thì không. Các gói Max có ghi tín dụng API hằng tháng trên claude.com/pricing tại ngày 22/10/2026 ($100/tháng với Max 5x, $200/tháng với Max 20x). Vượt quá số tín dụng đó, mức dùng API qua khóa Console được tính theo token, tách biệt với gói chat.

Vì sao khóa API Anthropic của tôi trả về 401?

Khóa bị gõ sai, bị vô hiệu hóa, bị xóa hoặc đã hết hạn. Khóa hết hạn không thể kích hoạt lại; hãy tạo khóa mới. Nếu lỗi nhắc đến workspace, thực ra đó là lỗi 400 do thiếu header anthropic-workspace-id.

Dùng khóa API Anthropic với Claude Code như thế nào?

Đặt ANTHROPIC_API_KEY trong shell, chạy claude và chấp thuận khóa khi được hỏi. Dùng /status trong Claude Code để xác nhận thông tin xác thực nào đang hoạt động.