Dùng khóa của bạn trong Claude Code

Cài CLI, trỏ ANTHROPIC_BASE_URL về OLETOKEN và chọn mô hình — kèm tiện ích VS Code và xử lý sự cố.

Claude Code là tác nhân lập trình của Anthropic (CLI cùng tiện ích mở rộng VS Code) và nó nói giao thức Anthropic Messages. Trỏ nó về OLETOKEN thì nó dùng khóa và hạn mức mô hình OLETOKEN của bạn — không cần tài khoản Anthropic.

Trước khi bắt đầu

Bạn đã tạo khóa API và lưu lại khóa đầy đủ.
Bạn đã chọn một model ID Claude từ chợ mô hình (ví dụ claude-sonnet-5).
Đã cài Node.js và npm.

Cấu hình

Cấu hình nằm trong khối env của ~/.claude/settings.json. CLI và tiện ích mở rộng VS Code dùng chung tệp này, nên cấu hình một lần là dùng được cho cả hai — và cách này đáng tin hơn việc export trong shell, vì VS Code không phải lúc nào cũng kế thừa môi trường shell của bạn:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://<your-base-url>",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}

Biến	Ý nghĩa
`ANTHROPIC_BASE_URL`	Chỉ host, không kèm `/v1` — CLI tự nối `/v1/messages`, nếu kèm vào sẽ trả về 404
`ANTHROPIC_AUTH_TOKEN`	Khóa OLETOKEN của bạn, được gửi dưới dạng `Authorization: Bearer`
`ANTHROPIC_MODEL`	Model ID mặc định
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Mô hình dùng cho các tác vụ nhẹ (sinh tiêu đề, ...); trỏ nó về cùng mô hình sẽ tránh lỗi 404 khi cổng kết nối không có mô hình haiku

Cài đặt và khởi chạy:

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

Hộp thoại Bắt đầu nhanh trên trang khóa API cho phép tải về đúng script cấu hình đó với khóa, mô hình và Base URL của bạn đã được điền sẵn.

Dùng biến môi trường cũng được

Nếu bạn không muốn đụng vào settings.json, hãy export các biến tương tự trong hồ sơ shell của mình (thường là ~/.zshrc trên macOS, ~/.bashrc trên Linux) rồi mở lại terminal:

export ANTHROPIC_BASE_URL="https://<your-base-url>"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"

Khi cả hai đều được đặt, khối env trong ~/.claude/settings.json sẽ thắng.

Xử lý sự cố

Triệu chứng	Nguyên nhân và cách xử lý
401	Khóa sai hoặc đã bị vô hiệu; hãy chắc đó là khóa OLETOKEN và nó nằm trong `ANTHROPIC_AUTH_TOKEN`
404	`ANTHROPIC_BASE_URL` có kèm `/v1` (hoặc đường dẫn dài hơn) — chỉ giữ lại host
Không tìm thấy mô hình	`ANTHROPIC_MODEL` không phải mô hình có trên trang này; hãy sao chép ID từ chợ mô hình
Số dư không đủ	Nạp tiền trước
Đổi mô hình nhanh trong phiên	Chạy `/model` ngay trong phiên làm việc

Hãy cấp cho mỗi mục đích sử dụng một khóa riêng (một cho CLI, một cho trình soạn thảo) kèm hạn mức chi tiêu, để nếu rò rỉ thì thiệt hại chỉ đến mức đó.