Cách lấy API key Claude (hướng dẫn 2026)

Trả lời nhanh: ba bước để có API key Claude

Để lấy API key Claude từ Anthropic: tạo tài khoản tại console.anthropic.com, mua credit trả trước trong mục Plans and billing (cần thẻ tín dụng hoặc thẻ ghi nợ), rồi mở Settings, vào API Keys, và bấm Create Key. Key bắt đầu bằng sk-ant- và chỉ hiển thị đúng một lần, nên hãy copy ngay vào password manager hoặc biến môi trường. Có hai điều khiến người dùng vấp phải. Thứ nhất, subscription chat Claude Pro hoặc Max không bao gồm truy cập API; Console là sản phẩm riêng với billing riêng. Thứ hai, request sẽ fail với lỗi credit cho tới khi bạn thực sự mua credit, dù bản thân việc tạo key hoạt động mà không cần thanh toán. Nếu lệnh gọi đầu tiên của bạn trả về lỗi liên quan số dư, đó chính là lý do. Nếu bạn không thể thêm thẻ, hoặc muốn một key duy nhất chạm được cả Claude lẫn các model family khác, một gateway trả trước là lựa chọn thực tế. Cách đó được nói tới ở cuối bài, kèm các đánh đổi được trình bày thẳng thắn.

Bước 1: tạo tài khoản Anthropic Console

Console tại console.anthropic.com là dashboard developer của Anthropic, khác với ứng dụng chat claude.ai. Đăng ký bằng email hoặc tài khoản Google. Anthropic yêu cầu xác minh số điện thoại trong quá trình onboarding, và truy cập API bị giới hạn ở các quốc gia được hỗ trợ, nên hãy kiểm tra danh sách khu vực khả dụng của Anthropic nếu luồng đăng ký chặn bạn ở bước này. Trong quá trình thiết lập bạn tạo một tổ chức (organization). Key, credit, rate limit, và usage log đều thuộc về tổ chức chứ không phải tài khoản cá nhân. Điều này quan trọng sau này khi bạn mời đồng đội: mọi người dùng chung một pool credit, và admin có thể xem usage phân theo từng key. Chưa mất tiền ở giai đoạn này. Bạn có thể duyệt danh sách model, đọc API reference, và mở Workbench, một playground trên trình duyệt để test prompt với các model Claude, trước khi thêm bất kỳ thông tin billing nào. Workbench hữu ích để kiểm tra prompt hoạt động như mong đợi trước khi bạn viết một dòng code tích hợp nào.

Bước 2: thiết lập billing trước request đầu tiên

API của Anthropic là trả trước. Trong mục Plans and billing, thêm thẻ và mua một block credit ban đầu; mức mua tối thiểu khá nhỏ, trước đây là năm đô la. Mỗi lệnh gọi API trừ dần số dư này theo giá mỗi token, nên không có hóa đơn bất ngờ cuối tháng. Khi số dư về 0, request sẽ dừng. Có hai cài đặt đáng thiết lập ngay từ ngày đầu. Auto-reload tự động nạp thêm số dư khi nó xuống dưới ngưỡng bạn đặt. Bật tính năng này cho workload production để số dư cạn kiệt không bao giờ biến thành sự cố ngừng hoạt động. Tắt nó với các thử nghiệm, để một vòng lặp chạy vượt tầm kiểm soát không thể tiêu nhiều hơn số bạn cố ý nạp. Rate limit tăng theo usage tier. Tổ chức mới bắt đầu ở tier thấp nhất, và giới hạn request mỗi phút cùng token mỗi phút tăng lên khi tổng chi tiêu tích lũy của bạn tăng. Nếu bạn thấy response 429 khi traffic tăng đột biến trên một tài khoản còn non trẻ, nguyên nhân thường là hệ thống tier, không phải code của bạn.

Bước 3: tạo key và thực hiện lệnh gọi đầu tiên

Trong Console, mở Settings, rồi API Keys, rồi Create Key. Đặt tên cho key để nhận biết nó thuộc app hay môi trường nào, vì rồi bạn sẽ có nhiều key và những key không tên trở nên không thể audit được. Giá trị đầy đủ của key chỉ hiển thị lúc tạo; sau khi bạn đóng dialog, Console chỉ hiển thị phiên bản rút gọn. Export key thành biến môi trường và test từ terminal trước khi động vào code ứng dụng. Có hai chi tiết đặc thù của Anthropic khiến người chuyển từ provider khác vấp phải: xác thực dùng header x-api-key thay vì Authorization: Bearer, và mọi request phải kèm header anthropic-version. Thiếu header version sẽ fail với thông báo lỗi rõ ràng, nên hãy đọc response body khi có gì đó hỏng.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

Bảo mật key: năm thói quen ngăn một tuần tồi tệ

Những thói quen này rẻ để áp dụng từ ngày đầu và đắt để thêm vào sau khi đã xảy ra sự cố. Nếu bạn lỡ commit một key, hãy coi như nó đã rò rỉ dù là trong repository private: thu hồi, xoay vòng, và xóa sạch lịch sử commit. Secret scanner như gitleaks trong pre-commit hook bắt được sai lầm này trước khi nó rời khỏi máy của bạn.

• Chỉ dùng biến môi trường hoặc secrets manager. Key dán vào source code cuối cùng sẽ bị commit, và scraper theo dõi các repository công khai để tìm chính xác tiền tố sk-ant-.
• Mỗi app và mỗi môi trường một key riêng. Key riêng cho development, staging, và production giúp usage log dễ đọc và cho phép bạn thu hồi một luồng mà không làm hỏng các luồng khác.
• Không bao giờ đưa key vào code trình duyệt hay mobile. Bất cứ thứ gì trong JavaScript phía client đều công khai theo định nghĩa. Định tuyến lệnh gọi qua backend của riêng bạn và giữ key ở phía server.
• Thu hồi ngay khi nghi ngờ rò rỉ. Xóa một key trong Console vô hiệu hóa nó ngay lập tức; hãy tạo key thay thế trước nếu app cần duy trì hoạt động trong lúc xoay vòng.
• Thiết lập thông báo chi tiêu. Ngưỡng cảnh báo billing biến một key bị rò rỉ hoặc chạy lặp vô hạn từ một hóa đơn lớn thành một hóa đơn nhỏ, và không tốn gì để thiết lập.

Chi phí một lệnh gọi Claude, kèm các lựa chọn rẻ hơn gần đó

Claude được tính phí theo token, với giá input và output riêng biệt, và output token chiếm phần lớn hóa đơn trong sinh văn bản dài. So sánh cả hai cột, không chỉ giá input nổi bật. Để có cảm nhận về quy mô, bảng dưới liệt kê Claude cạnh các model khác có trong catalog gateway được mô tả ở phần sau. DeepSeek là lựa chọn được cộng đồng ưa chuộng nhất cho traffic khối lượng lớn tiết kiệm, còn Claude vẫn là lựa chọn khi chất lượng văn bản là ưu tiên.

Không có thẻ? Lấy một key hoạt động qua gateway

Nếu yêu cầu thẻ, chặn theo khu vực, hoặc chính việc tạo tài khoản là trở ngại, APIsRouter là đường gateway mà trang này ghi lại. Đây là một gateway tương thích OpenAI: checkout tại /topup không cần đăng ký, bạn trả tiền trước, và key gửi qua email. Billing là trả theo lượng dùng, không subscription. Model toàn cầu chạy rẻ hơn 20% giá niêm yết chính thức, model Trung Quốc nằm dưới giá chính thức, và lần nạp đầu tiên của bạn cộng thêm 100% số dư. Trỏ bất kỳ OpenAI SDK nào vào https://api.apisrouter.com/v1 và truyền một model ID trong catalog: claude-sonnet-4-6 hoặc claude-opus-4-7 cho dòng Claude, deepseek-v4-flash hoặc glm-5 khi bạn muốn token rẻ hơn từ cùng một key. Cùng key đó cũng hoạt động trong các app đầu cuối. Người dùng SillyTavern dán base URL kết thúc ở /v1 và danh sách model tự động điền từ /v1/models. JanitorAI cần endpoint đầy đủ https://api.apisrouter.com/v1/chat/completions cộng tên model và key. Đánh đổi so với một key Anthropic trực tiếp thì thẳng thắn và đơn giản: bạn đang tin tưởng một bên trung gian với traffic của mình, và các tính năng phía Anthropic đến theo lịch trình của gateway. Điểm được là một số dư và một endpoint duy nhất trên Claude, GPT, Gemini, DeepSeek, và GLM thay vì một tài khoản billing riêng cho mỗi provider.

from openai import OpenAI

client = OpenAI(
    api_key="sk-...",  # gửi qua email sau khi checkout
    base_url="https://api.apisrouter.com/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(response.choices[0].message.content)

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