Trang chủ → Hướng dẫn → Base URL Anthropic cho Claude Code: đặt ANTHROPIC_BASE_URL cho đúng

Base URL Anthropic cho Claude Code: đặt ANTHROPIC_BASE_URL cho đúng

Claude Code kết nối tới địa chỉ mà ANTHROPIC_BASE_URL trỏ tới. Quy tắc duy nhất hay làm người ta vấp: nó cần host trơn, không có /v1 — ngược hẳn với gần như mọi công cụ kiểu OpenAI.

Câu trả lời ngắn

Đặt hai biến môi trường trước khi khởi động Claude Code:

ANTHROPIC_BASE_URL=https://apiclan.us
ANTHROPIC_AUTH_TOKEN=sk-your-key

Địa chỉ chính thức của Anthropic là https://api.anthropic.com; dùng relay chỉ cần thay địa chỉ này. Claude Code tự nối thêm /v1/messages, nên base URL chỉ dừng ở host. Trên cổng này, 88% toàn bộ lưu lượng Claude trong 30 ngày qua đến từ Claude Code được cấu hình đúng như vậy.

Đặt ở đâu

macOS / Linux — trong shell bạn dùng để khởi động:

export ANTHROPIC_BASE_URL=https://apiclan.us
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

Windows PowerShell — cho cửa sổ hiện tại:

$env:ANTHROPIC_BASE_URL = "https://apiclan.us"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
claude

~/.claude/settings.json — để mọi phiên đều dùng mà không cần chỉnh shell:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apiclan.us",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

Giá trị này được đọc khi Claude Code khởi động. Nếu thay đổi, hãy thoát và mở phiên mới; phiên đang mở vẫn dùng địa chỉ cũ. ANTHROPIC_AUTH_TOKEN được gửi dưới dạng Authorization: Bearer; ANTHROPIC_API_KEY dưới dạng x-api-key. Cổng này chấp nhận cả hai — chỉ dùng một.

Kiểm tra bằng một lệnh

Trước khi nghi ngờ Claude Code, hãy kiểm tra trực tiếp địa chỉ và khóa:

curl https://apiclan.us/v1/messages \
  -H "Authorization: Bearer sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

Nhận về JSON nghĩa là cả hai đều đúng. text/html hoặc 404 nghĩa là URL sai; 401 dạng JSON nghĩa là URL đúng nhưng khóa sai.

Khi nào thêm /v1, khi nào không

Hai họ SDK cắt URL ở hai điểm khác nhau. Client kiểu Anthropic tự thêm /v1/messages; client kiểu OpenAI mong base URL đã có /v1 và chỉ thêm /chat/completions:

Client	Base URL
Claude Code, Anthropic SDK	https://apiclan.us
Codex, OpenAI SDK	https://apiclan.us/v1
Cursor, Cline, Roo Code	https://apiclan.us/v1
Cherry Studio, Chatbox, LobeChat, LM Studio	https://apiclan.us/v1

Thêm /v1 vào Claude Code thì yêu cầu đi tới /v1/v1/messages và trả về 404. Bỏ /v1 trong Cursor thì yêu cầu đi tới /chat/completions — cũng 404. Không cái nào tới được API.

Lỗi URL hay lỗi khóa?

• Báo lỗi mà nhật ký sử dụng không có gì → đường dẫn sai. 404 được trả lời ở rìa mạng và không bao giờ tới phần tính phí. Kiểm tra /v1 trước.
• 401 và có bản ghi trong nhật ký → khóa sai, đã bị thu hồi, hoặc hết số dư.
• Một model báo 404 trong khi model khác chạy với cùng khóa → model đó thuộc nhóm khác. Mỗi khóa gắn với một nhóm; hãy tạo khóa thứ hai cho nhóm kia.
• Thay đổi dường như không có tác dụng → biến được đặt ở shell khác, hoặc phiên đã chạy trước khi bạn đặt.

Chọn model

Tên model là chuỗi chính xác, dùng dấu gạch ngang chứ không phải dấu chấm — claude-fable-5-1, không phải claude-fable-5.1. Chọn khi khởi động, hoặc dùng /model trong phiên:

claude --model claude-opus-5-5

Tên và giá hiện tại có trong bảng giá. Cách thiết lập các client khác có trong bắt đầu nhanh, còn ứng dụng Claude Desktop trong hướng dẫn ứng dụng desktop.

Bắt đầu sử dụng

Không thuê bao, không mức tối thiểu hàng tháng, không cần gọi cho nhân viên bán hàng. Nạp bằng USDT và tiêu đúng phần bạn dùng — 1 USDT cho bạn 2 tín dụng số dư API.

Đọc hướng dẫn nhanh 30 giây

Ngôn ngữ: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Giá trên trang này được điền tự động từ dữ liệu thanh toán thực tế. Điều khoản bên thứ ba được trích từ tài liệu của chính họ.