Integração do Claude Code & Agent Tools

Conecte Claude Code, OpenClaw, Cline, Roo Code e qualquer cliente com protocolo Anthropic ao TokenHub.

Nativo do AnthropicFallback MultiplataformaUma chave, dois protocolos

1. Como o TokenHub fala Anthropic

TokenHub expõe dois protocolos simultaneamente. A mesma th- key funciona em ambos — cobrança, uso, limites de gasto e fallback de provedor são unificados.

Protocolo	Endpoint	Base URL (cole isto no cliente)	Clientes típicos
OpenAI-compatible	POST /v1/chat/completions	https://tokenhub.store/api/v1	openai SDK, LiteLLM, LangChain
Nativo do Anthropic	POST /v1/messages	https://tokenhub.store/api	Claude Code, OpenClaw, Cline, Roo Code, anthropic SDK

2. Modelos Claude disponíveis

Use qualquer um dos IDs abaixo como ANTHROPIC_MODEL ou no campo model. O prefixo anthropic/ é opcional — TokenHub aceita ambos os formatos.

ID do modelo	Categoria	Entrada ($/1M)	Saída ($/1M)
claude-opus-4-7	Mais capaz	$5.00	$25.00
claude-opus-4-6	Principal flagship	$5.00	$25.00
claude-sonnet-4-6	Padrão de produção	$3.00	$15.00
claude-haiku-4-5	Leve, alta QPS	$1.00	$5.00
claude-opus-4-5	Principal flagship	$5.00	$25.00
claude-sonnet-4-5	Padrão de produção	$3.00	$15.00

3. Início rápido em três passos

Cada cliente compatível se resume a estes três valores. O restante desta página é apenas onde colocá-los.

1
Base URL → https://tokenhub.store/api
2
Header de autenticação → sua th- key do TokenHub (NÃO uma chave Anthropic)
3
ANTHROPIC_API_KEY=""Defina ANTHROPIC_API_KEY="" explicitamente para que o SDK não faça fallback para api.anthropic.com

4. Configuração por cliente

Instalar

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

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

Opção A — Variáveis de ambiente do 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

Opção B — Configuração no nível do projeto

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

Verifique com /status

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

Se a Base URL ainda mostrar api.anthropic.com — ANTHROPIC_API_KEY não está vazio, o terminal não foi reiniciado ou o terminal integrado do VSCode herdou um env desatualizado.

5. Auto-teste com curl

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

Ordem dos eventos: message_start → content_block_start → content_block_delta* → content_block_stop → message_delta → message_stop.

Script de smoke test do repositório

Executa 6 assertions de uma vez (non-stream / Bearer / ordem SSE / erros de autenticação / model não suportado / function calling).

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

6. Resumo de troubleshooting

Sintoma	Causa mais provável	Correção
401 / authentication_error	x-api-key não foi enviado, ou foi passada uma chave oficial Anthropic	Use uma chave th- do TokenHub
402 / permission_error	O saldo da conta é 0, ou o limite de gasto da chave foi esgotado	Recarregue via Dashboard → Billing, ou remova o limite de gasto da chave
400 'model not supported'	Erro de digitação no Model ID / maiúsculas e minúsculas incorretas	Verifique §2 — bare ou anthropic/ ambos aceitos
503 'No upstream API key'	A chave upstream para este model ainda não foi provisionada	Entre em contato com o suporte
O stream é interrompido no meio	O timeout de inatividade HTTP do cliente está muito baixo	Aumente o timeout de inatividade para ≥ 120s
/status ainda mostra api.anthropic.com	ANTHROPIC_API_KEY não foi removida, ou o terminal não foi reiniciado	Execute export ANTHROPIC_API_KEY="" e depois reabra o terminal
A chamada de ferramenta retorna texto simples	Roteado para um upstream com suporte fraco a tool_use	Troque para claude-opus-4-6 / claude-sonnet-4-6, ou entre em contato com o suporte

7. FAQ

Procurando algo mais?

Se você estiver chamando Claude com o openai SDK, use a guia OpenAI-compatible em vez disso.

Claude API (OpenAI-compatible) →