Integrasi Claude Code & Agent Tools

Hubungkan Claude Code, OpenClaw, Cline, Roo Code, dan klien protokol Anthropic apa pun ke TokenHub.

Anthropic-NativeFallback Multi-ProviderSatu Key, Dua Protokol

1. Bagaimana TokenHub Berbicara dengan Anthropic

TokenHub mengekspos dua protokol secara bersamaan. th- key yang sama berfungsi pada keduanya — penagihan, penggunaan, batas pengeluaran, dan fallback provider semuanya disatukan.

Protokol	Endpoint	Base URL (tempelkan ini ke client)	Client umum
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. Claude Model yang Tersedia

Gunakan salah satu ID di bawah sebagai ANTHROPIC_MODEL atau field model. Prefix anthropic/ bersifat opsional — TokenHub menerima kedua format.

Model ID	Tier	Input ($/1M)	Output ($/1M)
claude-opus-4-7	Paling mumpuni	$5.00	$25.00
claude-opus-4-6	Flagship utama	$5.00	$25.00
claude-sonnet-4-6	Default produksi	$3.00	$15.00
claude-haiku-4-5	Ringan, QPS tinggi	$1.00	$5.00
claude-opus-4-5	Flagship utama	$5.00	$25.00
claude-sonnet-4-5	Default produksi	$3.00	$15.00

3. Quick Start dalam Tiga Langkah

Setiap client yang didukung pada dasarnya menggunakan tiga nilai ini. Sisa halaman ini hanya menunjukkan di mana menaruhnya.

1
Base URL → https://tokenhub.store/api
2
Auth header → th- key TokenHub Anda (BUKAN key Anthropic)
3
ANTHROPIC_API_KEY=""Set ANTHROPIC_API_KEY="" secara eksplisit agar SDK tidak fallback ke api.anthropic.com

4. Konfigurasi per Client

Instal

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

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

Opsi A — Variabel lingkungan shell (global)

# ~/.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

Opsi B — Konfigurasi tingkat proyek

.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": ""
  }
}

Verifikasi dengan /status

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

Jika base URL masih menampilkan api.anthropic.com — ANTHROPIC_API_KEY tidak kosong, terminal belum dimulai ulang, atau terminal terintegrasi VSCode mewarisi env lama.

5. Self-Test curl

Tanpa 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"}]}'

Urutan event: message_start → content_block_start → content_block_delta* → content_block_stop → message_delta → message_stop.

Skrip smoke test repo

Menjalankan 6 assertion sekaligus (non-stream / Bearer / urutan SSE / error autentikasi / model tidak didukung / function calling).

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

6. Cheat Sheet Pemecahan Masalah

Gejala	Penyebab paling mungkin	Perbaikan
401 / authentication_error	x-api-key tidak dikirim, atau official key Anthropic dikirim	Gunakan key th- TokenHub
402 / permission_error	Saldo akun 0, atau batas pengeluaran key habis	Isi ulang lewat Dashboard → Billing, atau hapus batas pengeluaran key
400 'model not supported'	Typo ID model / salah huruf besar-kecil	Lihat §2 — bare atau awalan anthropic/ keduanya diterima
503 'No upstream API key'	Upstream key untuk model ini belum diprovisikan	Hubungi dukungan
Stream terputus di tengah jalan	Timeout idle HTTP klien terlalu kecil	Naikkan idle timeout menjadi ≥ 120s
/status masih menampilkan api.anthropic.com	ANTHROPIC_API_KEY belum di-unset, atau terminal belum di-restart	Jalankan export ANTHROPIC_API_KEY="" lalu buka kembali terminal
Panggilan tool menghasilkan teks biasa	Dialihkan ke upstream dengan dukungan tool_use yang lemah	Beralih ke claude-opus-4-6 / claude-sonnet-4-6, atau hubungi dukungan

7. FAQ

Mencari sesuatu yang lain?

Jika Anda memanggil Claude dengan openai SDK, gunakan panduan OpenAI-compatible sebagai gantinya.

Claude API (OpenAI-compatible) →