Dùng với Claude Code

Cấu hình Claude Code chạy qua NEXAI bằng endpoint tương thích Anthropic — settings.json hoặc biến môi trường.

Claude Code (CLI lập trình của Anthropic) chạy được với NEXAI qua endpoint tương thích Anthropic Messages (/v1/messages). Bạn chỉ đổi hai thứ: địa chỉ endpoint và API key (dùng key NEXAI, không phải key Anthropic).

Chuẩn bị

Bước 1 — Cài Claude Code

macOS / Linux / WSL:

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

Windows PowerShell:

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

npm (cần Node.js 18+):

npm install -g @anthropic-ai/claude-code

Bước 2 — Lấy API key NEXAI

Đăng nhập dashboard → API Keys → Tạo key. Key dạng sk-..., chỉ hiện một lần — lưu an toàn.

Xong hai bước trên, chọn một trong hai cách cấu hình dưới đây.

Cách 1 — `settings.json` (khuyến nghị)

Cấu hình ngay trong file settings của Claude Code, không đụng biến môi trường hệ thống.

Mở (hoặc tạo mới) file ~/.claude/settings.json.
Thêm nội dung:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://getnexai.net/api/v1",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "API_TIMEOUT_MS": "3000000"
  }
}

Lưu file và mở lại terminal.
Kiểm tra:

claude --version
claude

Nếu Claude Code khởi động và trả lời bằng model NEXAI là xong. Đổi ANTHROPIC_MODEL sang bất kỳ id nào trong bảng Model hỗ trợ.

Cách 2 — Biến môi trường

Dùng khi bạn muốn cấu hình áp dụng toàn hệ thống. ANTHROPIC_AUTH_TOKEN gửi key theo Authorization: Bearer — đúng cách NEXAI xác thực.

Bash (Linux / macOS) — sửa ~/.bashrc (hoặc ~/.bash_profile trên macOS):

export ANTHROPIC_BASE_URL="https://getnexai.net/api/v1"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

source ~/.bashrc

Zsh (Linux / macOS) — sửa ~/.zshrc:

export ANTHROPIC_BASE_URL="https://getnexai.net/api/v1"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

source ~/.zshrc

PowerShell (Windows) — sửa file $PROFILE:

$env:ANTHROPIC_BASE_URL = "https://getnexai.net/api/v1"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "claude-sonnet-4-6"

. $PROFILE

Đường dẫn file cấu hình

Hệ	Shell	File
Linux	Bash	`~/.bashrc`
Linux	Zsh	`~/.zshrc`
macOS	Bash	`~/.bashrc` hoặc `~/.bash_profile`
macOS	Zsh	`~/.zshrc`
Windows	PowerShell	`$PROFILE`

Đổi model

Tạm thời (chỉ phiên hiện tại):

# Linux / macOS
ANTHROPIC_MODEL=claude-opus-4-7 claude

# Windows PowerShell
$env:ANTHROPIC_MODEL="claude-opus-4-7"; claude

Vĩnh viễn: đổi giá trị ANTHROPIC_MODEL trong settings.json hoặc file shell, rồi mở lại terminal.

Model hỗ trợ

Đặt vào ANTHROPIC_MODEL một trong các id sau. Đây là các alias tương thích Claude, NEXAI tự ánh xạ sang model tương ứng bên dưới:

Model ID (đặt cho Claude Code)	Ánh xạ tới
`claude-opus-4-7`	model mạnh nhất (GPT-5.5)
`claude-sonnet-4-6`	cân bằng (GPT-5.4)
`claude-haiku-4-5`	nhanh/tiết kiệm (GPT-4o Mini)

Danh sách có thể thay đổi. Kiểm tra model đang mở bằng GET /v1/models hoặc trang dashboard. Chi phí trừ vào ví VND theo bảng giá.

FAQ

claude: command not found? — Mở lại terminal sau khi cài; kiểm tra Claude Code đã vào PATH (npm global bin, hoặc ~/.local/bin).

Báo lỗi xác thực (401)? — ANTHROPIC_AUTH_TOKEN phải là key NEXAI (sk-...) còn hiệu lực, không phải key Anthropic. Kiểm tra lại và tạo key mới nếu cần.

Model bị chặn (403)? — Model chưa mở cho tài khoản, hoặc số dư không đủ. Kiểm tra số dư + danh sách GET /v1/models.

Đang dùng model nào? — Gõ /status trong Claude Code, hoặc kiểm tra biến ANTHROPIC_MODEL.

Gỡ cấu hình NEXAI? — Xoá khối env trong ~/.claude/settings.json, hoặc bỏ các dòng export ANTHROPIC_* trong file shell rồi mở lại terminal.

On this page