Cài đặt Claude Code với API key RocketKey trên Windows, macOS và Linux (ANTHROPIC_BASE_URL, settings.json, VS Code)

Trang này là tài liệu tham khảo cấu hình: các biến môi trường, file settings.json và extension VS Code. Nếu bạn chưa có key, đọc Bắt đầu trước.

Mọi đoạn cấu hình dưới đây dùng key giả sk-rk-YOUR_KEY_HERE: thay bằng key thật của bạn.

Trước khi bắt đầu

• Đã cài Claude Code (lệnh claude chạy được trong terminal).
• Nếu từng đăng nhập Claude Code bằng tài khoản Anthropic, gõ /logout trong Claude Code trước, và xoá biến ANTHROPIC_API_KEY nếu có. Các đoạn lệnh dưới đây đã tự xoá biến này trong cửa sổ hiện tại.
• Base URL của Claude Code không có /v1 ở cuối.

Cách 1: biến môi trường (nhanh nhất)

Dán vào terminal, rồi chạy claude trong cùng cửa sổ:

unset ANTHROPIC_API_KEY
export ANTHROPIC_BASE_URL='https://rocketkeyapi.indexes.social'
export ANTHROPIC_AUTH_TOKEN='sk-rk-YOUR_KEY_HERE'

Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
$env:ANTHROPIC_BASE_URL = 'https://rocketkeyapi.indexes.social'
$env:ANTHROPIC_AUTH_TOKEN = 'sk-rk-YOUR_KEY_HERE'

set ANTHROPIC_API_KEY=
set ANTHROPIC_BASE_URL=https://rocketkeyapi.indexes.social
set ANTHROPIC_AUTH_TOKEN=sk-rk-YOUR_KEY_HERE

Biến chỉ có hiệu lực trong cửa sổ đó. Muốn dùng lâu dài, thêm các dòng export vào ~/.bashrc / ~/.zshrc, hoặc dùng Cách 2.

Cách 2: file settings.json (dùng lâu dài)

Thêm khối env vào ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). Nếu file đã có nội dung, chỉ gộp phần env:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://rocketkeyapi.indexes.social",
    "ANTHROPIC_AUTH_TOKEN": "sk-rk-YOUR_KEY_HERE"
  }
}

Extension Claude Code trong VS Code

Thêm vào settings.json của VS Code (Command Palette → "Preferences: Open User Settings (JSON)"):

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://rocketkeyapi.indexes.social"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-rk-YOUR_KEY_HERE"
    }
  ]
}

Mở lại cửa sổ VS Code sau khi lưu.

Chọn model

Claude Code tự chọn model theo các khe opus, sonnet, haiku. Muốn chỉ định model cụ thể, thêm biến ANTHROPIC_DEFAULT_SONNET_MODEL (hoặc _OPUS_, _HAIKU_) với model ID lấy từ trang Model. Model ID sai sẽ gây lỗi 404.

Kiểm tra

Trong Claude Code, gõ /status: dòng base URL phải là địa chỉ của RocketKey. Gửi một câu hỏi ngắn để chắc chắn key hoạt động.

Lỗi hay gặp

• 401 / Invalid API key: key sai, đã bị xoá, hoặc vẫn còn ANTHROPIC_API_KEY cũ. Xem lỗi 401.
• 402 ExceededBudget: hết hạn mức trong ngày. Xem lỗi 402.
• 429 / 529 overloaded: xem lỗi 429.