Cấu hình Claude

1. Claude Code là gì

Claude Code là agent lập trình terminal chính thức của Anthropic. Công cụ này có thể hiểu mã trong dự án cục bộ, sửa tệp, thực thi lệnh, đồng thời có thể dùng cùng VS Code, JetBrains và các IDE khác.

Khi sử dụng Claude Code qua RouteAPI, về bản chất bạn vẫn dùng giao thức Anthropic, chỉ thay đổi điểm gửi yêu cầu của Claude Code sang điểm truy cập RouteAPI của bạn. Cách này phù hợp hơn để quản lý thống nhất khóa, quota và mô hình khả dụng.

Trước khi bắt đầu, hãy chuẩn bị:

• Một môi trường terminal có thể truy cập bình thường
• Claude Code CLI đã cài đặt
• Địa chỉ site RouteAPI của bạn
• Khóa RouteAPI của bạn
• ID mô hình giao thức Claude khả dụng trong console RouteAPI

Giải thích giao thức

Claude Code sử dụng giao thức Anthropic. Khi tích hợp RouteAPI, hãy trỏ ANTHROPIC_BASE_URL đến https://www.routeapi.ai/, không cần thêm hậu tố V1.

2. Bước 1: Cài đặt Claude Code

Cài đặt CLI

macOS / Linux / WSL có thể chạy trực tiếp:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell có thể chạy:

irm https://claude.ai/install.ps1 | iex

Nếu cài trong môi trường Windows native, thường cần chuẩn bị trước Git for Windows.

Kiểm tra cài đặt

claude --version

Nếu hiển thị số phiên bản, CLI đã được cài đặt thành công.

3. Bước 2: Cấu hình RouteAPI

Claude Code có thể đọc điểm truy cập và khóa từ biến môi trường. Để terminal và IDE dùng chung một cấu hình, nên ghi các biến này vào settings.json.

3.1 Tìm tệp cấu hình

• macOS / Linux: ~/.claude/settings.json
• Windows: %USERPROFILE%\.claude\settings.json

3.2 Ghi thông tin truy cập RouteAPI

{
  "env": {
"ANTHROPIC_BASE_URL": "https://www.routeapi.ai/",
"ANTHROPIC_AUTH_TOKEN": "khóa RouteAPI của bạn"
  }
}

Trong cấu hình trên:

• ANTHROPIC_BASE_URL: điền địa chỉ gốc site RouteAPI của bạn, thường không kèm /v1.
• ANTHROPIC_AUTH_TOKEN: điền khóa RouteAPI của bạn, phù hợp với truy cập gateway dùng Bearer Token.

Nếu chỉ muốn kiểm thử tạm thời, bạn cũng có thể đặt biến môi trường trực tiếp trong phiên terminal hiện tại. Chọn lệnh tương ứng với Shell đang dùng.

Nếu bạn dùng bash, zsh hoặc sh trên macOS / Linux / WSL:

export ANTHROPIC_BASE_URL="https://ten-mien-routeapi-cua-ban"
export ANTHROPIC_AUTH_TOKEN="khóa RouteAPI của bạn"

Nếu bạn dùng Windows PowerShell:

$env:ANTHROPIC_BASE_URL="https://ten-mien-routeapi-cua-ban"
$env:ANTHROPIC_AUTH_TOKEN="khóa RouteAPI của bạn"

Sau khi cấu hình xong, mở lại một cửa sổ terminal mới rồi khởi động claude thường sẽ ổn định hơn.

4. Bước 3: Chọn mô hình của bạn

Claude Code có hai cách chọn mô hình thường gặp.

Cách A: Cố định một mô hình mặc định

Nếu muốn tất cả phiên mặc định dùng cùng một mô hình, bạn có thể đặt trực tiếp ANTHROPIC_MODEL:

{
  "env": {
"ANTHROPIC_BASE_URL": "https://ten-mien-routeapi-cua-ban",
"ANTHROPIC_AUTH_TOKEN": "khóa RouteAPI của bạn",
"ANTHROPIC_MODEL": "ID mô hình khả dụng trong console"
  }
}

Cách này đơn giản nhất, phù hợp khi nhóm muốn thống nhất một mô hình mặc định.

Cách B: Giữ ba cấp lựa chọn Opus / Sonnet / Haiku

Nếu muốn tiếp tục dùng khả năng chọn cấp trong Claude Code, bạn có thể chỉ định mô hình mặc định cho từng cấp:

{
  "env": {
"ANTHROPIC_BASE_URL": "https://ten-mien-routeapi-cua-ban",
"ANTHROPIC_AUTH_TOKEN": "khóa RouteAPI của bạn",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "ID mô hình hiệu năng cao của bạn",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "ID mô hình chính của bạn",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "ID mô hình nhẹ của bạn"
  }
}

Sau khi cấu hình xong, khởi động Claude Code:

claude

Sau đó nhập trong phiên:

/model

Bạn có thể chọn cấp mô hình dùng cho phiên hiện tại trong Claude Code.

Điền tên mô hình như thế nào

Giá trị điền ở đây không phải tên hiển thị của mô hình, mà là ID mô hình thực sự khả dụng trong console RouteAPI. Cách chắc chắn nhất là sao chép trực tiếp tên mô hình giao thức Claude trong console để tránh lỗi nhập tay.