Claude Code lấy cấu hình từ các tệp cài đặt JSON và biến môi trường. Để chạy qua cổng trung gian thay vì API của Anthropic, bạn cần hai biến: ANTHROPIC_BASE_URL và token, thường là cả model. Các biến này rất đơn giản. Điều khiến mọi người bối rối là vị trí đặt chúng, vì cùng một biến có thể nằm trong cấu hình shell, nhiều tệp settings.json và cài đặt của VS Code.
Hướng dẫn này bắt đầu bằng một thiết lập hoạt động được, sau đó giải thích vị trí các tệp, giá trị nào được ưu tiên và những lỗi bạn có thể gặp. Nội dung đã được đối chiếu với tài liệu của Anthropic và thử nghiệm với AIHubMix trên Claude Code 2.1.304 vào ngày 20 tháng 10 năm 2026. Các ví dụ dùng AIHubMix làm cổng trung gian; mọi endpoint tương thích với Anthropic đều được thiết lập theo cách tương tự.
Tóm tắt nhanh
- Tệp cài đặt cá nhân của bạn là
~/.claude/settings.json, hoặc%USERPROFILE%\.claude\settings.jsontrên Windows. - Để dùng cổng trung gian, hãy thêm
ANTHROPIC_BASE_URL(không có/v1) vàANTHROPIC_AUTH_TOKENvào khốienvcủa tệp đó. - Giá trị trong khối
envcủa tệp cài đặt sẽ ghi đè biến cùng tên được khai báo trong shell. - Khi đã đặt token, các yêu cầu sẽ không còn dùng gói thuê bao Claude của bạn mà được tính phí bởi cổng trung gian.
- Tiện ích mở rộng VS Code cần các biến tương tự trong cài đặt riêng
claudeCode.environmentVariables.
Thiết lập AIHubMix hoạt động được
- Tạo khóa trong trang quản lý AIHubMix.
- Thêm nội dung này vào
~/.claude/settings.json. Hãy tạo tệp nếu chưa có.
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"env": {
"ANTHROPIC_BASE_URL": "https://aihubmix.com",
"ANTHROPIC_AUTH_TOKEN": "sk-your-aihubmix-key"
},
"model": "claude-sonnet-5-5"
}
- Chạy thử nhanh:
claude -p "1+1, output only the answer"
- Khởi chạy
claudetrong một dự án. Phần đầu trang bên dưới logo sẽ hiển thị nội dung tương tựSonnet 5.5 · API Usage Billing, còn/statussẽ hiển thị cổng trung gian của bạn trên dòngAnthropic base URL.
Có hai chi tiết quan trọng. Base URL là địa chỉ gốc: Claude Code tự thêm /v1/messages, nên URL kết thúc bằng /v1 sẽ khiến mọi yêu cầu bị lỗi. AIHubMix dùng ID model của chính Anthropic, chẳng hạn claude-sonnet-5-5, nên các lối tắt sonnet, opus và haiku hoạt động mà không cần thiết lập thêm.
Dòng $schema là tùy chọn. Dòng này giúp VS Code, Cursor và các trình soạn thảo khác phát hiện lỗi trong tệp khi bạn nhập.
Bạn cũng có thể khai báo hai biến tương tự trong shell, nhưng tệp cài đặt là nơi phù hợp hơn: mọi cửa sổ dòng lệnh, tiện ích IDE và tác tử chạy nền đều đọc được tệp này.
Vị trí các tệp cài đặt
| Phạm vi | Tệp | Áp dụng cho |
|---|---|---|
| Người dùng | ~/.claude/settings.json | Bạn, trong mọi dự án |
| Dự án | .claude/settings.json | Mọi người trong kho mã, thông qua git |
| Cục bộ | .claude/settings.local.json | Chỉ bạn, trong kho mã này |
| Được quản lý | Do tổ chức của bạn thiết lập | Mọi người được áp dụng cấu hình |
Không bao giờ đặt token trong .claude/settings.json của dự án vì tệp này được đưa vào git. Hãy dùng tệp người dùng hoặc .claude/settings.local.json.
Các tệp cài đặt phải là JSON hợp lệ. Chỉ một chú thích // hoặc dấu phẩy thừa ở cuối cũng khiến Claude Code bỏ qua toàn bộ tệp, bao gồm cả token, và bạn sẽ thấy màn hình đăng nhập thay vì cổng trung gian.
Đừng nhầm các tệp này với ~/.claude.json, một tệp đơn trong thư mục chính của bạn. Tệp đó lưu trạng thái riêng của Claude Code, chẳng hạn thông tin đăng nhập và máy chủ MCP, và hiếm khi cần chỉnh sửa.
Giá trị nào được ưu tiên
Khi nhiều tệp đặt cùng một giá trị, thứ tự ưu tiên cài đặt của Anthropic được áp dụng, theo thứ tự ưu tiên giảm dần:
- Cài đặt được tổ chức quản lý
--settingstrên dòng lệnh, chỉ áp dụng cho phiên đó.claude/settings.local.json.claude/settings.json~/.claude/settings.json
Với biến môi trường, còn có một quy tắc nữa: biến trong khối env của tệp cài đặt sẽ ghi đè biến cùng tên từ shell. Vì vậy, lệnh export ANTHROPIC_BASE_URL=... trong ~/.zshrc sẽ không có tác dụng khi một tệp cài đặt cũng đặt biến đó. Các công cụ chuyển đổi nhà cung cấp thường ghi vào ~/.claude/settings.json, vì vậy giá trị trong đó được ưu tiên hơn shell.
Trong Claude Code, /status liệt kê các tệp đã tải ở dòng Setting sources.
ANTHROPIC_AUTH_TOKEN hay ANTHROPIC_API_KEY
| Biến | Được gửi dưới dạng | Ghi chú |
|---|---|---|
| ANTHROPIC_AUTH_TOKEN | Authorization: Bearer | Được dùng ngay |
| ANTHROPIC_API_KEY | x-api-key | Yêu cầu phê duyệt một lần |
Hãy dùng biến mà cổng trung gian của bạn đọc. AIHubMix chấp nhận cả hai, và hướng dẫn Claude Code của họ dùng ANTHROPIC_AUTH_TOKEN, đây cũng là lựa chọn đơn giản hơn. Đừng để cả hai cùng được thiết lập. Khi đó Claude Code sẽ gửi cả hai header, và AIHubMix kiểm tra x-api-key trước: trong thử nghiệm của chúng tôi, token đúng trong settings.json vẫn nhận lỗi 401 vì một ANTHROPIC_API_KEY cũ được khai báo trong shell. Khối env chỉ ghi đè những biến được đặt trong đó, vì vậy hãy xóa khóa cũ khỏi cấu hình shell khi chuyển đổi.
Còn gói thuê bao Claude của bạn thì sao? Theo hướng dẫn về cổng trung gian của Anthropic, khi đặt biến token hoặc API key, các yêu cầu sẽ dùng biến đó thay cho thông tin đăng nhập claude.ai, và cổng trung gian tính phí theo token. Thông tin đăng nhập của bạn vẫn được lưu và sẽ hoạt động trở lại khi bạn xóa biến. Nếu chỉ đặt ANTHROPIC_BASE_URL mà không có token, bạn vẫn dùng gói thuê bao của mình.
Chọn model
Trang cấu hình model của Anthropic đưa ra thứ tự sau, theo mức ưu tiên giảm dần:
/model <name>trong một phiênclaude --model <name>khi khởi chạy- Biến
ANTHROPIC_MODEL - Khóa
modeltrong tệp cài đặt
/model sẽ lưu lựa chọn của bạn làm mặc định mới. Tuy nhiên, nếu đặt ANTHROPIC_MODEL, mỗi phiên mới sẽ khởi chạy lại với model đó. Nếu thường xuyên đổi model, hãy đặt khóa model và không khai báo ANTHROPIC_MODEL. Nếu không đặt model ở đâu cả, Claude Code sẽ dùng Opus 5.5.
ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL và ANTHROPIC_DEFAULT_HAIKU_MODEL thay đổi model mà mỗi lối tắt sử dụng. Bạn chỉ cần các biến này nếu muốn một lối tắt trỏ sang model khác, chẳng hạn để giữ sonnet ở phiên bản cũ hơn.
AIHubMix cũng cung cấp model của các nhà cung cấp khác qua cùng một địa chỉ, nhưng Anthropic không hỗ trợ Claude Code với model không thuộc Claude, nên một số tính năng có thể không hoạt động với các model đó.
Khi nào thay đổi có hiệu lực
Claude Code theo dõi các tệp cài đặt và hầu hết thay đổi đã lưu, bao gồm cả khối env, đều được áp dụng cho phiên đang chạy. Khóa model, các biến đã xóa và biến xuất từ shell cần khởi động lại. Nếu chưa chắc, hãy khởi động lại Claude Code.
Tiện ích mở rộng VS Code
Tiện ích mở rộng đọc cùng các tệp cài đặt, nhưng kiểm tra thông tin đăng nhập trước khi khởi chạy bằng cài đặt riêng claudeCode.environmentVariables. Vì vậy VS Code có thể yêu cầu bạn đăng nhập trong khi CLI vẫn hoạt động. Mở Preferences: Open User Settings (JSON) từ Command Palette rồi thêm:
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://aihubmix.com" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-your-aihubmix-key" }
]
}
Sau đó chạy Developer: Reload Window. Xem thêm các tùy chọn trong tài liệu VS Code của Anthropic. Ứng dụng Claude Desktop là một ứng dụng riêng: ứng dụng này không đọc settings.json hay các biến này.
Các biến hữu ích khác
| Biến | Hãy đặt biến khi |
|---|---|
| API_TIMEOUT_MS | Các yêu cầu dài bị hết thời gian chờ (mặc định 10 phút) |
| CLAUDE_CODE_MAX_RETRIES | Bạn muốn lỗi hiển thị sớm hơn |
| HTTPS_PROXY | Bạn đang dùng proxy HTTP |
| NODE_EXTRA_CA_CERTS | Proxy của bạn sử dụng chứng chỉ gốc riêng |
Có thể đặt tất cả các biến này trong khối env. Danh sách đầy đủ có trong tài liệu tham khảo về biến môi trường của Anthropic.
Các lỗi thường gặp và ý nghĩa
Not logged in · Please run /login, hoặc màn hình đăng nhập khi khởi chạy lần đầu
Claude Code không tìm thấy token. Hãy kiểm tra ba điều: lỗi JSON khiến chương trình bỏ qua tệp, thiếu ANTHROPIC_AUTH_TOKEN, hoặc token chỉ được đặt trong tệp dự án. Bước đăng nhập diễn ra trước khi tải cài đặt dự án, vì vậy hãy chuyển token vào ~/.claude/settings.json.
Invalid or malformed JSON
Tệp được nêu trong thông báo có chú thích, dấu phẩy thừa ở cuối hoặc lỗi cú pháp khác, khiến không cài đặt nào trong tệp được áp dụng.
There's an issue with the selected model (...)
ID model không đúng, hoặc base URL kết thúc bằng /v1 khiến yêu cầu được gửi đến /v1/v1/messages. Nếu ID model có vẻ đúng, hãy kiểm tra URL trước.
API Error: 400 cùng với This model ID is incorrect
AIHubMix không có model mang ID đó, và thông báo lặp lại ID mà hệ thống nhận được. Thường là do lỗi đánh máy. Hãy sao chép lại ID từ danh sách model AIHubMix.
Failed to authenticate. API Error: 401 invalid key: ...
AIHubMix không chấp nhận khóa. Thông báo kết thúc bằng sáu ký tự cuối của khóa nhận được, vì vậy hãy so sánh chúng với phần cuối token của bạn. PI_KEY có nghĩa là bạn đã dán placeholder AIHUBMIX_API_KEY thay vì khóa thật. Trường hợp khác thường có nghĩa là một ANTHROPIC_API_KEY cũ trong shell đã được gửi đi. Nếu thay vào đó thông báo ghi this key is not enabled, hãy kiểm tra trong trang quản lý AIHubMix xem khóa đã được bật và có số dư hay chưa.
auth may not work as expected
Biến token và thông tin đăng nhập claude.ai đã lưu đều đang hoạt động. Chạy /logout để tiếp tục dùng cổng trung gian, hoặc xóa biến để quay lại dùng gói thuê bao.
Claude Code doesn't recognize the model ...
Đây là cảnh báo, không phải lỗi: yêu cầu vẫn được gửi đi, nhưng Claude Code giả định cửa sổ ngữ cảnh có kích thước 200K token. Nếu ID là của một model Claude mới hơn, hãy chạy claude update để xóa cảnh báo.
Có vẻ chương trình bị treo khi dùng khóa không hợp lệ
Claude Code thử lại các yêu cầu thất bại tối đa 10 lần. Trong thử nghiệm với một khóa luôn bị từ chối, claude -p tiếp tục thử lại trong khoảng ba phút. Giảm CLAUDE_CODE_MAX_RETRIES để thấy lỗi sớm hơn.
Nếu bạn muốn dùng một khóa cho Claude trong Claude Code, đồng thời dùng OpenAI, Google và các nhà cung cấp khác trong những công cụ khác, AIHubMix cung cấp API Anthropic tại https://aihubmix.com. Claude Code chỉ cần tệp cài đặt ở trên.
Câu hỏi thường gặp
Tệp settings.json của Claude Code nằm ở đâu?
Tệp cá nhân của bạn là ~/.claude/settings.json, hoặc %USERPROFILE%.claude\settings.json trên Windows. Dự án cũng có thể có .claude/settings.json được chia sẻ qua git và .claude/settings.local.json chỉ dành cho bạn. Claude Code không tự tạo các tệp này khi cài đặt.
settings.json có ghi đè các biến môi trường không?
Có. Giá trị trong khối env của tệp cài đặt sẽ ghi đè biến cùng tên được khai báo trong shell. Các biến không được thiết lập trong tệp, chẳng hạn ANTHROPIC_API_KEY cũ, vẫn được lấy từ shell.
Nên dùng ANTHROPIC_AUTH_TOKEN hay ANTHROPIC_API_KEY?
Hãy dùng biến mà gateway của bạn đọc. ANTHROPIC_AUTH_TOKEN gửi token Bearer và không cần phê duyệt. Với AIHubMix, ANTHROPIC_AUTH_TOKEN là lựa chọn được ghi trong tài liệu. Đừng thiết lập cả hai: AIHubMix ưu tiên đọc x-api-key, nên ANTHROPIC_API_KEY cũ sẽ gây lỗi 401.
ANTHROPIC_BASE_URL có nên kết thúc bằng /v1 không?
Không. Claude Code tự thêm /v1/messages. Với AIHubMix, hãy dùng https://aihubmix.com.
Có cần khởi động lại Claude Code sau khi chỉnh sửa settings.json không?
Hầu hết thay đổi, bao gồm cả thay đổi env, có hiệu lực ngay khi bạn lưu. Khóa model và các biến được khai báo trong shell cần khởi động lại. Khởi động lại là lựa chọn an toàn.
Tại sao VS Code yêu cầu tôi đăng nhập dù CLI vẫn hoạt động?
Trước khi khởi chạy, extension kiểm tra trạng thái đăng nhập thông qua cài đặt claudeCode.environmentVariables, còn các giá trị trong ~/.claude/settings.json không được đưa vào bước kiểm tra đó. Hãy thêm URL cơ sở và token vào đó, rồi tải lại cửa sổ.
Thiết lập ANTHROPIC_BASE_URL có sử dụng gói đăng ký Claude của tôi không?
Chỉ khi không có token nào được thiết lập. Khi đã thiết lập ANTHROPIC_AUTH_TOKEN hoặc ANTHROPIC_API_KEY, các yêu cầu sẽ sử dụng khóa đó và gateway tính phí theo token.
Nguồn
- Tệp cài đặt và thứ tự ưu tiên, Anthropic
- Biến môi trường, Anthropic
- Kết nối Claude Code với gateway LLM, Anthropic
- Cấu hình model, Anthropic
- Hướng dẫn tích hợp Claude Code, AIHubMix
