Tích hợp Claude Code & Công cụ Agent

Kết nối Claude Code, OpenClaw, Cline, Roo Code và bất kỳ client nào theo giao thức Anthropic với TokenHub.

Anthropic-NativeDự phòng đa nhà cung cấpMột khóa, cả hai giao thức

1. TokenHub giao tiếp với Anthropic như thế nào

TokenHub cung cấp đồng thời hai giao thức. Cùng một th- key hoạt động trên cả hai — billing, usage, spend caps và provider fallback được thống nhất.

Giao thức	Endpoint	Base URL (dán vào client)	Client điển hình
OpenAI-compatible	POST /v1/chat/completions	https://tokenhub.store/api/v1	openai SDK, LiteLLM, LangChain
Anthropic-native	POST /v1/messages	https://tokenhub.store/api	Claude Code, OpenClaw, Cline, Roo Code, anthropic SDK

2. Các model Claude khả dụng

Dùng bất kỳ ID nào bên dưới làm ANTHROPIC_MODEL hoặc trường model. Tiền tố anthropic/ là tùy chọn — TokenHub chấp nhận cả hai dạng.

Model ID	Hạng	Input ($/1M)	Output ($/1M)
claude-opus-4-7	Mạnh nhất	$5.00	$25.00
claude-opus-4-6	Flagship chính	$5.00	$25.00
claude-sonnet-4-6	Mặc định cho production	$3.00	$15.00
claude-haiku-4-5	Nhẹ, QPS cao	$1.00	$5.00
claude-opus-4-5	Flagship chính	$5.00	$25.00
claude-sonnet-4-5	Mặc định cho production	$3.00	$15.00

3. Thiết lập nhanh trong 3 bước

Mọi client được hỗ trợ đều quy về ba giá trị này. Phần còn lại của trang này chỉ là chỗ để đặt chúng.

1
Base URL → https://tokenhub.store/api
2
Auth header → th- key TokenHub của bạn (KHÔNG phải Anthropic key)
3
ANTHROPIC_API_KEY=""Đặt ANTHROPIC_API_KEY="" một cách rõ ràng để SDK không fallback về api.anthropic.com

4. Cấu hình theo từng client

Cài đặt

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# or via npm
npm install -g @anthropic-ai/claude-code

Tùy chọn A — Biến môi trường shell (toàn cục)

# ~/.zshrc or ~/.bashrc
export ANTHROPIC_BASE_URL="https://tokenhub.store/api"
export ANTHROPIC_AUTH_TOKEN="th-your-tokenhub-key"
export ANTHROPIC_MODEL="claude-opus-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_API_KEY=""    # must be empty, otherwise SDK falls back to api.anthropic.com

# then reopen the terminal and run:
cd /path/to/your/project
claude

Tùy chọn B — Cấu hình cấp dự án

.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://tokenhub.store/api",
    "ANTHROPIC_AUTH_TOKEN": "th-your-tokenhub-key",
    "ANTHROPIC_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_API_KEY": ""
  }
}

Xác minh bằng /status

> /status
Auth token:        ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://tokenhub.store/api

Nếu Base URL vẫn hiển thị api.anthropic.com — ANTHROPIC_API_KEY chưa trống, terminal chưa được khởi động lại, hoặc terminal tích hợp của VSCode đã kế thừa biến môi trường cũ.

5. Kiểm thử curl

Không streaming

curl -sS https://tokenhub.store/api/v1/messages \
  -H "x-api-key: th-your-tokenhub-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 128,
    "messages": [{"role":"user","content":"say hi"}]
  }'

Streaming SSE

curl -N -sS https://tokenhub.store/api/v1/messages \
  -H "x-api-key: th-your-tokenhub-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-4-6","stream":true,"max_tokens":128,"messages":[{"role":"user","content":"count 1 to 3"}]}'

Thứ tự sự kiện: message_start → content_block_start → content_block_delta* → content_block_stop → message_delta → message_stop.

Script smoke-test của repo

Chạy 6 kiểm tra cùng lúc (không stream / Bearer / thứ tự SSE / lỗi xác thực / model không hỗ trợ / function calling).

BASE_URL=https://tokenhub.store TOKENHUB_API_KEY=th-xxxx \
  bash scripts/test-messages-api.sh

6. Bảng tóm tắt xử lý sự cố

Triệu chứng	Nguyên nhân có khả năng cao nhất	Cách khắc phục
401 / authentication_error	x-api-key không được gửi, hoặc đã truyền một official key của Anthropic	Dùng TokenHub th- key
402 / permission_error	Số dư tài khoản là 0, hoặc hạn mức chi tiêu của key đã hết	Nạp tiền qua Dashboard → Billing, hoặc bỏ hạn mức chi tiêu của key
400 'model not supported'	Sai ID model / sai chữ hoa chữ thường	Xem §2 — chấp nhận cả dạng trần hoặc có tiền tố anthropic/
503 'No upstream API key'	Chưa cấp phát upstream key cho model này	Liên hệ hỗ trợ
stream bị ngắt giữa chừng	Client HTTP idle timeout quá nhỏ	Tăng idle timeout lên ≥ 120s
/status vẫn hiển thị api.anthropic.com	ANTHROPIC_API_KEY chưa được unset, hoặc terminal chưa được khởi động lại	Chạy export ANTHROPIC_API_KEY="" rồi mở lại terminal
Lệnh gọi tool trả về plain text	Được định tuyến tới upstream có hỗ trợ tool_use yếu	Chuyển sang claude-opus-4-6 / claude-sonnet-4-6, hoặc liên hệ hỗ trợ

7. Câu hỏi thường gặp

Bạn đang tìm thứ khác?

Nếu bạn đang gọi Claude bằng openai SDK, hãy dùng hướng dẫn OpenAI-compatible thay thế.

Claude API (OpenAI-compatible) →