Tài liệu Tham chiếu API Tham chiếu SDK Sử dụng Agent Kỹ năng AI

Hướng dẫn thiết lập Claude Code với BazaarLink

Claude Code có thể dùng BazaarLink bằng cách đổi base URL và API key. Cấu hình dưới đây gọi đến Messages endpoint tương thích Anthropic của BazaarLink.

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

Export các biến này trước khi khởi động Claude Code. ANTHROPIC_AUTH_TOKEN được gửi như Authorization token; hãy giữ trong shell environment và không commit.

1
2
3
4
5
export ANTHROPIC_BASE_URL="https://api.bazaarlink.ai/v1"
export ANTHROPIC_AUTH_TOKEN="your-bazaarlink-api-key"
export ANTHROPIC_MODEL="openai/gpt-5.6-luna"
export ANTHROPIC_SMALL_FAST_MODEL="anthropic/claude-haiku-4.5"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

2. Cấu hình bằng settings.json

Nếu muốn cấu hình Claude Code lâu dài, đặt cùng các giá trị vào file settings của người dùng. Chỉ thay placeholder bằng BazaarLink key thật trên máy của bạn.

1
2
3
4
5
6
7
8
9
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.bazaarlink.ai/v1",
    "ANTHROPIC_AUTH_TOKEN": "your-bazaarlink-api-key",
    "ANTHROPIC_MODEL": "openai/gpt-5.6-luna",
    "ANTHROPIC_SMALL_FAST_MODEL": "anthropic/claude-haiku-4.5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

3. Xác minh đường đi của request

Chạy Messages request nhỏ này trước một phiên Claude Code dài hơn. JSON response có model và stop reason xác nhận base URL cùng key đã đến BazaarLink; sau đó kiểm tra request trong trang Logs.

1
2
3
4
5
6
7
8
curl -sS "$ANTHROPIC_BASE_URL/messages"   -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"   -H "anthropic-version: 2023-06-01"   -H "content-type: application/json"   -d '{
    "model": "openai/gpt-5.6-luna",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "Reply with OK"}]
  }' | jq '{id, model, stop_reason}'

# After Claude Code runs, confirm the same request in:
# https://bazaarlink.ai/logs

4. Lỗi thường gặp

401 Unauthorized

Triệu chứng: Claude Code hoặc curl báo lỗi xác thực. Nguyên nhân: ANTHROPIC_AUTH_TOKEN bị thiếu, sai chính tả hoặc shell chưa được khởi động lại. Cách sửa: đặt BazaarLink API key, kiểm tra Authorization: Bearer và chạy Claude Code từ chính shell đó.

404 model_not_found

Triệu chứng: request đến gateway nhưng model bị từ chối. Nguyên nhân: ANTHROPIC_MODEL hoặc ANTHROPIC_SMALL_FAST_MODEL không trùng chính xác với ID trong response /models hiện tại. Sao chép cả provider prefix và dấu câu.

Base URL thiếu /v1

Triệu chứng: request trả route 404 hoặc vẫn đi tới Anthropic. Nguyên nhân: thiếu /v1, lặp /messages hoặc dùng host khác. Đặt ANTHROPIC_BASE_URL chính xác là https://api.bazaarlink.ai/v1; Claude Code sẽ thêm /messages.

5. Chọn model

Dùng live /models endpoint làm nguồn chuẩn. Ba ví dụ dưới đây là các ví dụ hợp lệ trong brief; sao chép đầy đủ provider/model ID vào ANTHROPIC_MODEL hoặc ANTHROPIC_SMALL_FAST_MODEL.

1
2
3
openai/gpt-5.6-luna
anthropic/claude-haiku-4.5
deepseek/deepseek-v4.1-flash