Bỏ qua tới nội dung
RexAPFTài liệuMở RexAPF Web
Tài liệuAPITích hợp công cụ
API

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.

3 phút đọcYêu cầu: Claude Code, khoá API RexAPF
Trên trang này
  1. Các bước thủ công
  2. Tạo khoá API
  3. Cài Claude Code
  4. Ghi tệp cấu hình
  5. Khởi chạy trong thư mục dự án
  6. Chuyển model khi cần
  7. Chỉ dùng tạm cho một phiên
  8. Model khuyến nghị
  9. Khắc phục sự cố
Cấu hình bằng 1 lệnhScript ghi ~/.claude/settings.json và tự sao lưu tệp cũ
Model mặc định
$ curl -sL https://rexapf.com/scripts/setup-claude.sh | bash -s -- "YOUR_API_KEY" "https://rexapf.com/v1" "claude-sonnet-4-6"
Base URLhttps://rexapf.com/v1
Biến môi trườngANTHROPIC_AUTH_TOKEN
Modelclaude-sonnet-4-6

Claude 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

  1. 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.

  2. Cài Claude Code

    bash
    $ npm install -g @anthropic-ai/claude-code
  3. Ghi tệp cấu hình

    Tạo hoặc mở ~/.claude/settings.json (trên Windows: %USERPROFILE%\.claude\settings.json) và đặt khối env:

    ~/.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ối env, giữ nguyên phần còn lại.

  4. Khởi chạy trong thư mục dự án

    bash
    $ cd my-project
    $ claude

    Nếu Claude Code vẫn đòi đăng nhập tài khoản Anthropic, gõ /logout trong phiên rồi mở lại claude.

  5. Chuyển model khi cần

    Trong phiên, gõ /model để chuyển model. Ba biến ANTHROPIC_DEFAULT_*_MODEL quyết định model thật được gọi cho mỗi mức Opus, Sonnet và Haiku.

Terminal — ~/.claude
$ 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ệp settings.json sau khi cấu hình
Dùng ANTHROPIC_AUTH_TOKEN

Đặ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

Biến chỉ còn hiệu lực tới khi bạn đóng terminal.

Model khuyến nghị

ModelPhù hợp với
claude-sonnet-4-6Lập trình hằng ngày, cân bằng tốc độ và chất lượng
claude-opus-4-6Tác vụ phức tạp, cần suy luận sâu
claude-haiku-4-5-20251001Tá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ượngCách xử lý
Lỗi 401 với invalid_api_keyKhoá 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_revokedKhoá đã bị thu hồi. Tạo khoá mới ở API Gateway › Khóa API
Lỗi 402Chư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_limitHế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 AnthropicGõ /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 modelModel 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
Khôi phục cấu hình 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ợ.

Trang này có hữu ích không?Cập nhật 22/10/2026