Claude Code

CC Switch

CC Switch ghi cấu hình vào ~/.claude/settings.json giúp bạn, và cho phép đổi qua lại giữa nhiều nhà cung cấp bằng một cú nhấp. Cài CC Switch theo hướng dẫn trước.

1. Trong thanh bên trái của CC Switch, chọn Claude (Claude Code, không phải Claude Desktop).
2. Nhấn nút + (Add Provider) ở góc trên bên phải.
3. Chọn Custom Configuration. Nếu danh sách preset trống, dùng nút Add with a custom config.
4. Điền endpoint là https://YOUR-DOMAIN (không có /v1) và API key là key sk-... của bạn. Nếu trình soạn thảo hiện JSON, dùng đúng dạng này:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://YOUR-DOMAIN",
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR-KEY",
    "ANTHROPIC_MODEL": "MODEL-ID"
  }
}

Form thêm provider tùy chỉnh cho Claude Code trong CC Switch, đã điền endpoint, API key và model

5. Giữ Upstream Format ở mặc định Anthropic Messages (Native).
6. Nhấn Add, rồi nhấn Switch trên thẻ provider vừa tạo. Thẻ chuyển sang trạng thái In use.

Danh sách provider của Claude Code trong CC Switch, thẻ provider mới đang ở trạng thái In use

7. Mở terminal và chạy claude. CC Switch áp dụng cấu hình ngay, không cần khởi động lại máy.

Claude Code đang chạy, trả lời một câu hỏi bằng model từ router

Nếu Claude Code vẫn hiện màn hình đăng nhập, bật tùy chọn Skip Claude Code first-run confirmation trong Settings của CC Switch rồi mở lại Claude Code.

Nếu CC Switch hiện cảnh báo "Environment Variable Conflicts Detected", bạn đang có biến ANTHROPIC_* trong shell đè lên cấu hình. Xóa các biến đó theo hướng dẫn trong banner, rồi mở lại terminal.

Thủ công

Có hai cách: biến môi trường trong shell, hoặc khối env trong ~/.claude/settings.json. Chọn một. Nếu đặt cả hai, giá trị trong settings.json thường được dùng.

Cách 1: biến môi trường

macOS và Linux (thêm vào ~/.zshrc hoặc ~/.bashrc để dùng lâu dài):

export ANTHROPIC_BASE_URL=https://YOUR-DOMAIN
export ANTHROPIC_AUTH_TOKEN=sk-YOUR-KEY
export ANTHROPIC_MODEL=MODEL-ID

Windows PowerShell (chỉ cho phiên hiện tại; dùng setx nếu muốn lưu lại):

$env:ANTHROPIC_BASE_URL = "https://YOUR-DOMAIN"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR-KEY"
$env:ANTHROPIC_MODEL = "MODEL-ID"

Cách 2: settings.json

Sửa ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://YOUR-DOMAIN",
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR-KEY",
    "ANTHROPIC_MODEL": "MODEL-ID"
  }
}

Tệp ~/.claude/settings.json mở trong trình soạn thảo với khối env đã điền

Đặt key vào file ở thư mục home của bạn. Đừng đặt vào .claude/settings.json trong dự án, vì file đó thường được commit và chia sẻ.

Chạy thử

Mở terminal mới và chạy claude. Trong Claude Code, gõ /status để xem địa chỉ và nguồn key đang dùng: dòng Anthropic base URL phải là địa chỉ của bạn.

Claude Code đang chạy, lệnh /status hiện Anthropic base URL trỏ tới địa chỉ của router