Khóa API Claude Code. Một chiếc chìa khóa nhỏ được tra vào ổ khóa hình terminal, bên cạnh là bảng thiết lập ngăn nắp và một dây cáp ngắn.

Khóa API Claude Code — ANTHROPIC_API_KEY: cách lấy, thiết lập và khi nào nên dùng claude setup-token thay thế

Claude Code cần khóa API để hoạt động. Dù bạn đang thiết lập Claude Code lần đầu hay chuyển từ tài khoản Anthropic trực tiếp sang gateway có mức phí cố định, quy trình đều gồm tạo khóa, cấu hình hai biến môi trường và xác minh kết nối.

Khóa API Claude Code: tóm tắt

Khóa API Claude Code là một khóa thông thường theo định dạng Anthropic (sk-...) mà Claude Code đọc từ ANTHROPIC_API_KEY. Lấy khóa trong Claude Console (Cài đặt → Khóa API, chỉ hiển thị một lần) hoặc trong bảng điều khiển của gateway này (có thể xem bất cứ lúc nào), xuất khóa thành biến môi trường và Claude Code sẽ khởi động mà không cần đăng nhập qua trình duyệt. Với khóa gateway, bạn cũng đặt ANTHROPIC_BASE_URL thành địa chỉ máy chủ gateway. Đó là toàn bộ phần thiết lập; phần còn lại của trang này trình bày chi tiết — sự khác biệt giữa khóa API, token OAuth từ /login và khóa phiên claude.ai, các bước cho từng hệ điều hành cùng những lỗi thường gặp.

Khóa API Claude Code là gì

Khóa API Claude Code là thông tin xác thực cho phép CLI của Claude Code gửi yêu cầu đến nhà cung cấp mô hình Claude. Nếu không có khóa, mọi lệnh bạn chạy trong Claude Code đều trả về lỗi xác thực. Khóa là một chuỗi được lưu trong biến môi trường — ANTHROPIC_API_KEY (được gửi qua header x-api-key) hoặc ANTHROPIC_AUTH_TOKEN (được gửi dưới dạng token Bearer). Cả hai đều hoạt động với AI Prime Tech.

Khi bạn dùng gateway như AI Prime Tech thay vì dùng trực tiếp Anthropic, khóa được lấy từ bảng điều khiển của gateway thay vì Anthropic Console. Định dạng khóa có thể khác, nhưng quy trình thiết lập trong Claude Code vẫn giống nhau: đặt khóa trong môi trường, trỏ URL cơ sở đến gateway và Claude Code xử lý phần còn lại. Khóa của bạn gắn với số dư hoặc gói đăng ký của tài khoản gateway, không gắn với việc thanh toán cho Anthropic.

Một khóa có thể được dùng đồng thời trên nhiều máy và trong nhiều phiên Claude Code. Tuy nhiên, nếu bạn chia sẻ khóa trong nhóm, toàn bộ mức sử dụng đều được tính vào giới hạn tốc độ và số dư của cùng một tài khoản. Khi thiết lập cho nhóm, hãy tạo một khóa riêng cho mỗi nhà phát triển từ bảng điều khiển để việc theo dõi mức sử dụng và giới hạn tốc độ hoạt động chính xác cho từng người.

Khóa API và token OAuth — và “khóa phiên” là gì

Claude Code chấp nhận hai loại thông tin xác thực. Khóa API (ANTHROPIC_API_KEY, hoặc ANTHROPIC_AUTH_TOKEN được gửi dưới dạng token Bearer) tính phí theo token vào số dư API — đây là loại bạn dùng với gateway. Token OAuth đến từ gói đăng ký Claude Pro hoặc Max: /login trong Claude Code giúp bạn đăng nhập, còn claude setup-token tạo token có thời hạn dài mà bạn có thể đặt trong CI hoặc trên máy không có giao diện để sử dụng gói đăng ký thay vì số dư API.

“Khóa phiên Claude” không thuộc loại nào trong hai loại trên: đó là cookie phiên trình duyệt từ claude.ai, được một số ứng dụng khách không chính thức trích xuất để điều khiển giao diện trò chuyện. Nó không phải thông tin xác thực API, vi phạm điều khoản dành cho người dùng cá nhân, có thời hạn hết hiệu lực và có thể khiến tài khoản bị đình chỉ. Nếu bạn muốn truy cập bằng chương trình, hãy dùng khóa API — từ bảng điều khiển của Anthropic hoặc từ một gateway như gateway này.

Bước 1 — Lấy khóa: Claude Console hoặc bảng điều khiển gateway

Có hai nơi cấp khóa mà Claude Code chấp nhận. Trong Claude Console (nền tảng Claude tại platform.claude.com), mở Cài đặt → Khóa API, nhấp Tạo khóa, đặt tên rồi sao chép giá trị bí mật của khóa — Console chỉ hiển thị giá trị này một lần và sau đó chỉ liệt kê tên cùng tiền tố, nên việc quản lý khóa tại đây đồng nghĩa với tạo khóa mới thay vì lấy lại khóa cũ.

Claude Code cần khóa thông thường; khóa API quản trị là loại thông tin xác thực khác dùng để quản lý tổ chức và không thể xác thực yêu cầu. Sau đó export ANTHROPIC_API_KEY=sk-ant-... trong shell của bạn và Claude Code sẽ dùng khóa mà không cần /login. Anthropic tính phí theo token và yêu cầu tài khoản có phương thức thanh toán trước.

Cách nhanh hơn là dùng khóa gateway: đăng ký tại aiprimetech.io, mở Khóa API trong bảng điều khiển, nhấp Tạo và khóa sẽ luôn có thể xem trong bảng điều khiển — bạn có thể sao chép lại, đổi tên hoặc thu hồi bất cứ khi nào. Khóa có cùng định dạng sk- và hoạt động với cùng biến; bước bổ sung duy nhất là ANTHROPIC_BASE_URL, được trình bày trong Bước 2.

Đến đây bạn đã có khóa nhưng chưa có số dư. Hãy nạp một khoản nhỏ trước khi thử — trang mô hình cho biết một đô la mua được bao nhiêu mức sử dụng cho từng mô hình — hoặc chọn gói không giới hạn tại /plans/ nếu bạn đã biết mình sẽ chạy Claude Code cả ngày.

Bước 2 — Đặt biến môi trường

Claude Code đọc hai biến môi trường để cấu hình gateway: ANTHROPIC_BASE_URL và ANTHROPIC_API_KEY. Đặt ANTHROPIC_BASE_URL thành địa chỉ máy chủ gốc của gateway, không kèm hậu tố đường dẫn. SDK của Anthropic tự động nối thêm /v1/messages — nếu bạn đưa /v1 vào URL cơ sở, yêu cầu sẽ đến /v1/v1/messages và trả về lỗi 404.

Trên Linux hoặc macOS, thêm các dòng sau vào tệp cấu hình shell (~/.bashrc, ~/.zshrc hoặc ~/.profile): export ANTHROPIC_BASE_URL="https://aiprimetech.io" và export ANTHROPIC_API_KEY="your-key-here". Trên Windows, đặt chúng làm biến môi trường hệ thống qua Cài đặt > Hệ thống > Cài đặt hệ thống nâng cao > Biến môi trường, hoặc thêm chúng vào $PROFILE của PowerShell.

Để cấu hình theo từng dự án, tạo tệp .env trong thư mục gốc của dự án với cùng các biến. Claude Code nạp tệp .env từ thư mục làm việc và các biến này được ưu tiên hơn biến ở cấp hệ thống. Điều này hữu ích nếu bạn dùng các nhà cung cấp API khác nhau cho các dự án khác nhau. Hãy nhớ thêm .env vào .gitignore để tránh vô tình đưa khóa vào hệ thống quản lý phiên bản.

Bước 3 — Xác minh kết nối

Sau khi đặt các biến môi trường, mở một phiên terminal mới (để các biến được nạp) rồi chạy Claude Code. Nhập một tin nhắn đơn giản như 'Xin chào, hãy xác nhận bạn có thể phản hồi.' Nếu nhận được phản hồi từ Claude, thiết lập của bạn đang hoạt động xuyên suốt. Khóa hợp lệ, URL cơ sở chính xác và gateway đang định tuyến thành công yêu cầu của bạn đến Claude.

Nếu xác minh thất bại, thông báo lỗi sẽ cho biết vấn đề nằm ở đâu. Lỗi 401 hoặc 403 có nghĩa là khóa API không hợp lệ hoặc đã hết hạn — hãy sao chép lại khóa từ bảng điều khiển. Lỗi 404 gần như luôn có nghĩa là URL cơ sở sai — hãy kiểm tra xem có vô tình thêm hậu tố /v1 hoặc dấu gạch chéo ở cuối hay không. Lỗi kết nối bị từ chối có nghĩa là không thể truy cập gateway — hãy kiểm tra mạng, VPN hoặc cài đặt tường lửa.

Bạn cũng có thể xác minh bằng chương trình bằng cách gọi endpoint trạng thái của gateway bằng curl: curl -H 'Authorization: Bearer YOUR_KEY' https://aiprimetech.io/v1/models — lệnh này trả về danh sách mô hình khả dụng nếu khóa hợp lệ. Nếu lệnh này hoạt động nhưng Claude Code không hoạt động, vấn đề nằm ở việc nạp biến môi trường, không nằm ở bản thân khóa hay gateway.

Bước 4 — Cấu hình tùy chọn mô hình

Theo mặc định, Claude Code dùng các lựa chọn mô hình tích hợp cho từng cấp (Sonnet, Opus, Haiku). Bạn có thể ghi đè các lựa chọn này bằng các biến môi trường bổ sung: ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL và ANTHROPIC_DEFAULT_FABLE_MODEL. Đặt chúng thành đúng các mã định danh mô hình mà gateway hỗ trợ.

Với hầu hết nhà phát triển, đặt ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 và ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6 là đủ. Claude Code mặc định dùng Sonnet cho phần lớn tương tác và dùng Opus khi bạn chọn qua lệnh /model hoặc khi chế độ lập kế hoạch chuyển sang mô hình mạnh hơn. Gateway hỗ trợ tất cả các phiên bản mô hình Claude hiện hành.

Bật tính năng khám phá mô hình của gateway bằng cách đặt CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1. Thiết lập này yêu cầu Claude Code truy vấn gateway để lấy các mô hình khả dụng thay vì dùng danh sách được mã hóa cố định. Đồng thời đặt CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 để ngăn các yêu cầu đo lường từ xa được gửi đến gateway — điều này giảm lưu lượng không cần thiết và cải thiện nhẹ độ trễ yêu cầu.

Khắc phục các lỗi xác thực thường gặp

Vấn đề thường gặp nhất là các biến môi trường chưa được nạp. Sau khi đặt chúng trong tệp cấu hình, bạn phải mở terminal mới — các terminal hiện có vẫn dùng môi trường cũ. Trên Windows, bạn có thể cần khởi động lại toàn bộ ứng dụng terminal, chứ không chỉ mở tab mới. Kiểm tra bằng echo $ANTHROPIC_BASE_URL (bash/zsh) hoặc echo $env:ANTHROPIC_BASE_URL (PowerShell).

Nếu bạn gặp lỗi 'không tìm thấy mô hình' dù kết nối hợp lệ, mã định danh mô hình không khớp với mô hình mà gateway cung cấp. ID mô hình phân biệt chữ hoa, chữ thường và gắn với từng phiên bản cụ thể. Kiểm tra bảng điều khiển hoặc endpoint /v1/models để biết chính xác các mã định danh được hỗ trợ. Những lỗi thường gặp gồm dùng 'claude-3-opus' thay vì 'claude-opus-4-6' hoặc thêm khoảng trắng thừa vào giá trị biến môi trường.

Kiểm tra số dư trong bảng điều khiển của bạn. Để tiếp tục sử dụng mà không bị gián đoạn, hãy nạp thêm số dư trả theo mức sử dụng hoặc nâng cấp lên gói không giới hạn — 1 ngày ($9) hoặc 1 tuần ($39) để truy cập tất cả mô hình với mức giá cố định, không tính phí theo token.

# Add to ~/.bashrc or ~/.zshrc:
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_API_KEY="your-key-from-dashboard"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# Verify connection:
# $ source ~/.bashrc && claude
# Or test the gateway directly:
# $ curl -H "x-api-key: $ANTHROPIC_API_KEY" https://aiprimetech.io/v1/models

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

ANTHROPIC_API_KEY — lấy như thế nào?

Tạo khóa trong Claude Console (Cài đặt → Khóa API → Tạo khóa; sao chép giá trị bí mật của khóa khi được hiển thị một lần) hoặc tạo khóa trong bảng điều khiển cổng API tại đây, nơi khóa luôn được hiển thị. Xuất khóa thành biến ANTHROPIC_API_KEY; nếu dùng khóa của cổng API, hãy đặt thêm ANTHROPIC_BASE_URL.

Tôi có cần khóa riêng cho Claude Code và các công cụ khác không?

Không. Cùng một khóa API có thể dùng cho Claude Code, Cursor, Cline, Aider và bất kỳ công cụ nào khác sử dụng Anthropic Messages API hoặc điểm cuối tương thích với OpenAI. Một khóa dùng cho nhiều công cụ.

Khóa phiên Claude có giống khóa API không?

Không. Khóa phiên là cookie trình duyệt claude.ai được các ứng dụng khách không chính thức sử dụng; khóa API là thông tin xác thực mà API và Claude Code yêu cầu. Chỉ khóa API được hỗ trợ, tính phí và có tính ổn định.

Làm thế nào để lấy ANTHROPIC_API_KEY?

Từ bảng điều khiển của Anthropic (tính phí theo giá niêm yết vào tài khoản Anthropic của bạn) hoặc từ bảng điều khiển của cổng API này (tính phí vào tín dụng mua với giá thấp hơn mệnh giá, hoặc vào gói không giới hạn). Cả hai đều được đặt trong biến môi trường ANTHROPIC_API_KEY.

Chức năng của claude setup-token có tác dụng gì?

Lệnh này tạo token OAuth dài hạn cho gói đăng ký Claude để Claude Code có thể chạy trong CI hoặc ở chế độ không có giao diện mà không cần đăng nhập tương tác. Lệnh sử dụng hạn mức của gói đăng ký, không dùng tín dụng API; với cổng API, bạn dùng khóa API thay thế.

ANTHROPIC_BASE_URL có nên bao gồm /v1 không?

Không. Chỉ đặt địa chỉ máy chủ gốc: https://aiprimetech.io — Anthropic SDK tự động nối thêm /v1/messages. Việc thêm /v1 sẽ khiến đường dẫn bị lặp và trả về lỗi 404.

Tôi có thể dùng cùng một khóa trên nhiều máy không?

Có. Một khóa hoạt động đồng thời trên tất cả thiết bị của bạn. Mọi mức sử dụng đều được tính vào số dư và giới hạn tốc độ của cùng một tài khoản. Với nhóm, hãy tạo khóa riêng cho từng nhà phát triển để theo dõi độc lập.

Bắt đầu sử dụng Claude chỉ trong vài phút

Lấy khóa API — không cần tài khoản Anthropic hay đăng ký danh sách chờ.

Lấy khóa API của bạn

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.