Tích hợp Claude Code | Tài liệu API

Claude Code gọi mô hình qua giao thức Anthropic Messages. Đặt ANTHROPIC_BASE_URL thành URL cơ sở tương thích Anthropic hiển thị trên trang này.

Claude Sonnet 4.6 (claude-sonnet-4-6) được nhà cung cấp thượng nguồn hỗ trợ nhưng hiện chưa công bố trên API Hop. Đây không phải lựa chọn tích hợp mặc định đang hoạt động. Trước khi gọi bất kỳ mô hình nào, xác nhận quyền truy cập bằng phản hồi GET https://api.apihop.ai/v1/models của chính bạn.

text

ANTHROPIC_BASE_URL=https://api.apihop.ai/anthropic

Điều kiện trước

Chuẩn bị khóa API API Hop hợp lệ trước. Khóa sẽ được ghi vào môi trường shell cục bộ. Không đưa vào kho mã, nhật ký hoặc ảnh chụp màn hình.

Cài Claude Code

Trên macOS / Linux, dùng trình cài Claude Code nguyên bản:

bash

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

Nếu trình cài báo ~/.local/bin/claude nhưng không tìm thấy claude, mở terminal mới hoặc thêm ~/.local/bin vào PATH.

Với quy trình cũ, gói npm vẫn khả dụng:

bash

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

Không dùng sudo npm install -g @anthropic-ai/claude-code; lệnh có thể gây lỗi quyền khi nâng cấp sau này.

Kiểm tra CLI sau khi cài:

bash

claude --version
claude doctor

Trên Windows, nên dùng Git Bash hoặc WSL cho Claude Code. PowerShell cũng đặt được biến môi trường, nhưng cách lưu lâu dài khác nhau theo terminal.

Cấu hình biến môi trường

Cài đặt tạm thời chỉ ảnh hưởng phiên terminal hiện tại:

bash

export ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"
export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
export ANTHROPIC_MODEL="claude-sonnet-5-5"

macOS mặc định dùng zsh. Để cấu hình lâu dài, ghi biến vào ~/.zshrc, rồi chạy source ~/.zshrc để terminal hiện tại đọc ngay:

bash

printf '%s\n' \
  'export ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"' \
  'export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"' \
  'export ANTHROPIC_MODEL="claude-sonnet-5-5"' \
  >> ~/.zshrc

source ~/.zshrc

Trên Linux dùng bash, ghi cùng biến vào ~/.bashrc và chạy source ~/.bashrc.

Cài đặt tạm thời trong Windows PowerShell:

powershell

$env:ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"
$env:ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
$env:ANTHROPIC_MODEL="claude-sonnet-5-5"

Lưu lâu dài ở cấp người dùng PowerShell:

powershell

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_APIHOP_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.apihop.ai/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5-5", "User")

Mở phiên PowerShell mới trước khi chạy claude.

Tệp cài đặt

Thay cho cấu hình shell, tạo hoặc sửa ~/.claude/settings.json. Nếu tệp đã tồn tại, ghép env và model vào JSON hiện có thay vì thay thế cài đặt khác:

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_APIHOP_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.apihop.ai/anthropic",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  },
  "model": "claude-sonnet-5-5"
}

Mô hình khả dụng:

claude-fable-5
claude-fable-5-1
claude-opus-4-6
claude-opus-4-7
claude-opus-4-8
claude-opus-5
claude-opus-5-5
claude-sonnet-5
claude-sonnet-5-5

Dùng GET https://api.apihop.ai/v1/models để biết mô hình hiện khả dụng với khóa API của bạn.

Khởi động và kiểm thử

Khởi động lại Claude Code sau khi đặt biến môi trường, rồi gửi prompt thông thường:

bash

claude "Reply exactly OK."

Bạn cũng có thể khởi động chế độ tương tác:

bash

claude

Lần khởi chạy đầu tiên, Claude Code có thể hỏi giao diện, xác nhận an toàn, thiết lập terminal hoặc có tin cậy thư mục hiện tại không. Làm theo lời nhắc trong terminal.

Chọn mô hình

Đặt mô hình mặc định bằng biến môi trường, hoặc chọn cho một lệnh bằng --model:

bash

claude --model claude-sonnet-5-5 "Review this PR"

Hành vi điểm cuối

Claude Code xác thực bằng khóa API API Hop đã cấu hình. Dịch vụ chấp nhận một trong hai dạng xác thực:

http

x-api-key: YOUR_APIHOP_API_KEY
anthropic-version: 2023-06-01

http

Authorization: Bearer YOUR_APIHOP_API_KEY
anthropic-version: 2023-06-01

Phản hồi giữ định dạng JSON hoặc sự kiện SSE Anthropic Messages nguyên bản. Chúng không được chuyển sang định dạng OpenAI.

Khắc phục sự cố

ANTHROPIC_BASE_URL phải là URL cơ sở API công khai trên trang này cộng /anthropic.
Không đưa đường dẫn điểm cuối vào ANTHROPIC_BASE_URL; chỉ cần URL cơ sở tương thích Anthropic.
Sau khi sửa ~/.zshrc trên macOS, chạy source ~/.zshrc hoặc mở terminal mới trước khi khởi động Claude Code.
Nếu claude báo không tìm thấy lệnh, xác nhận vị trí cài đặt có trong PATH; vị trí phổ biến là ~/.local/bin/claude.
Nếu claude doctor báo thiếu biến môi trường, chạy echo $ANTHROPIC_BASE_URL và echo $ANTHROPIC_MODEL trong cùng terminal để xác nhận đã nạp.
Nếu nhận 401, xác nhận khóa API hợp lệ.
Nếu mô hình không khả dụng, xác nhận tên mô hình nằm trong danh sách khả dụng bên trên.
Khởi động lại tiến trình Claude Code sau khi đổi biến môi trường.

POST https://api.apihop.ai/anthropic/v1/messages: điểm cuối tương thích Anthropic Messages.