Dùng RexAPF với Claude Code
Cấu hình Claude Code gọi model qua API Gateway của RexAPF bằng tệp ~/.claude/settings.json và biến ANTHROPIC_AUTH_TOKEN.
Trên trang này
$ curl -sL https://rexapf.com/scripts/setup-claude.sh | bash -s -- "YOUR_API_KEY" "https://rexapf.com/v1" "claude-sonnet-4-6"https://rexapf.com/v1ANTHROPIC_AUTH_TOKENclaude-sonnet-4-6Claude Code nói chuyện với API Gateway qua định dạng Anthropic Messages. Bạn chỉ cần trỏ Base URL về RexAPF và dùng khoá API của mình thay cho tài khoản Anthropic.
Script cấu hình nhanh ở đầu bài làm đúng các việc dưới đây: sao lưu ~/.claude/settings.json cũ thành settings.json.bak.<thời-gian>, rồi ghi tệp mới với Base URL, khoá và ba model mặc định. Nếu bạn muốn tự kiểm soát tệp cấu hình, làm theo các bước thủ công.
Các bước thủ công
Tạo khoá API
Mở API Gateway › Khóa API, nhấn Tạo khóa API, đặt nhãn (ví dụ “Claude Code”) rồi nhấn Tạo khóa. Sao chép khoá ngay, vì khoá đầy đủ chỉ hiện một lần. Xem Khoá API.
Cài Claude Code
bash$ npm install -g @anthropic-ai/claude-codeGhi tệp cấu hình
Tạo hoặc mở
~/.claude/settings.json(trên Windows:%USERPROFILE%\.claude\settings.json) và đặt khốienv:~/.claude/settings.json{ "env": { "ANTHROPIC_BASE_URL": "https://rexapf.com/v1", "ANTHROPIC_AUTH_TOKEN": "sk_9r_...", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001" } }Thay
sk_9r_...bằng khoá vừa tạo. Nếu tệp đã có các khoá khác, chỉ thêm hoặc sửa khốienv, giữ nguyên phần còn lại.Khởi chạy trong thư mục dự án
bash$ cd my-project $ claudeNếu Claude Code vẫn đòi đăng nhập tài khoản Anthropic, gõ
/logouttrong phiên rồi mở lạiclaude.Chuyển model khi cần
Trong phiên, gõ
/modelđể chuyển model. Ba biếnANTHROPIC_DEFAULT_*_MODELquyết định model thật được gọi cho mỗi mức Opus, Sonnet và Haiku.
$ cat ~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://rexapf.com/v1",
"ANTHROPIC_AUTH_TOKEN": "sk_9r_••••",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
}
}Đặt khoá vào ANTHROPIC_AUTH_TOKEN. Claude Code gửi giá trị này dưới dạng Authorization: Bearer, là cách API Gateway nhận khoá phổ biến nhất.
Chỉ dùng tạm cho một phiên
Muốn thử mà không sửa tệp, đặt biến môi trường trong terminal hiện tại:
$ export ANTHROPIC_BASE_URL="https://rexapf.com/v1"
$ export ANTHROPIC_AUTH_TOKEN="sk_9r_..."
$ claude$env:ANTHROPIC_BASE_URL="https://rexapf.com/v1"
$env:ANTHROPIC_AUTH_TOKEN="sk_9r_..."
claudeBiến chỉ còn hiệu lực tới khi bạn đóng terminal.
Model khuyến nghị
| Model | Phù hợp với |
|---|---|
claude-sonnet-4-6 | Lập trình hằng ngày, cân bằng tốc độ và chất lượng |
claude-opus-4-6 | Tác vụ phức tạp, cần suy luận sâu |
claude-haiku-4-5-20251001 | Tác vụ nhẹ, cần phản hồi nhanh |
Danh sách model và giá có thể thay đổi. Mở API Gateway › Model để xem model đang hoạt động, giá hiện tại và chạy Health Check trước khi đổi model mặc định. Model có nút bị khoá với chú thích “Model không có trong gói của bạn” thì gói hiện tại chưa dùng được. Xem Model & bảng giá.
Khắc phục sự cố
| Hiện tượng | Cách xử lý |
|---|---|
Lỗi 401 với invalid_api_key | Khoá sai hoặc dán thiếu ký tự. Kiểm tra ANTHROPIC_AUTH_TOKEN, không để dấu cách hay xuống dòng |
Lỗi 401 với api_key_revoked | Khoá đã bị thu hồi. Tạo khoá mới ở API Gateway › Khóa API |
Lỗi 402 | Chưa có gói còn hạn và số dư credit bằng 0. Nạp credit hoặc chọn gói ở API Gateway › Thanh toán |
Lỗi 429 với plan_usage_window_limit | Hết ngân sách cửa sổ của gói. Chờ tới thời điểm đặt lại hoặc bật Chuyển sang dùng credit khi hết hạn mức |
| Claude Code vẫn dùng tài khoản Anthropic | Gõ /logout, rồi kiểm tra shell không đặt sẵn ANTHROPIC_BASE_URL hoặc ANTHROPIC_API_KEY khác |
Lỗi 404 hoặc 503 khi gọi một model | Model không có tuyến phục vụ hoặc đang bận. Chạy Health Check ở API Gateway › Model và đổi sang model khác |
Script tạo bản sao ~/.claude/settings.json.bak.<thời-gian> trước khi ghi đè. Muốn quay lại cấu hình trước đó, chép bản sao này đè lên settings.json.
Chi tiết các mã lỗi ở Mã lỗi & giới hạn. Vẫn chưa được, xem Khắc phục sự cố hoặc liên hệ hỗ trợ.