Integración de Claude Code y herramientas de agentes

Conecta Claude Code, OpenClaw, Cline, Roo Code y cualquier cliente con protocolo Anthropic a TokenHub.

Nativo de AnthropicFallback multi-proveedorUna sola key, ambos protocolos

1. Cómo TokenHub habla Anthropic

TokenHub expone dos protocolos simultáneamente. La misma th- key funciona en ambos — la facturación, el uso, los límites de gasto y el fallback de proveedor están unificados.

Protocolo	Endpoint	Base URL (pégala en el cliente)	Clientes típicos
OpenAI-compatible	POST /v1/chat/completions	https://tokenhub.store/api/v1	openai SDK, LiteLLM, LangChain
Anthropic-nativo	POST /v1/messages	https://tokenhub.store/api	Claude Code, OpenClaw, Cline, Roo Code, anthropic SDK

2. Claude Models disponibles

Usa cualquiera de los IDs de abajo como ANTHROPIC_MODEL o como el campo model. El prefijo anthropic/ es opcional — TokenHub acepta ambas formas.

ID del model	Nivel	Entrada ($/1M)	Salida ($/1M)
claude-opus-4-7	Más capaz	$5.00	$25.00
claude-opus-4-6	Flagship principal	$5.00	$25.00
claude-sonnet-4-6	Predeterminado de producción	$3.00	$15.00
claude-haiku-4-5	Ligero, alta QPS	$1.00	$5.00
claude-opus-4-5	Flagship principal	$5.00	$25.00
claude-sonnet-4-5	Predeterminado de producción	$3.00	$15.00

3. Inicio rápido en tres pasos

Cada cliente compatible se reduce a estos tres valores. El resto de esta página solo indica dónde ponerlos.

1
Base URL → https://tokenhub.store/api
2
Header de autenticación → tu th- key de TokenHub (NO una key de Anthropic)
3
ANTHROPIC_API_KEY=""Establece ANTHROPIC_API_KEY="" explícitamente para que el SDK no haga fallback a api.anthropic.com

4. Configuración por cliente

Instalar

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

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

Opción A — Variables de entorno del 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

Opción B — Configuración a nivel de proyecto

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

Verifica con /status

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

Si la URL base sigue mostrando api.anthropic.com — ANTHROPIC_API_KEY no está vacío, la terminal no se reinició o la terminal integrada de VSCode heredó variables de entorno obsoletas.

5. Autoevaluación con curl

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

Orden de eventos: message_start → content_block_start → content_block_delta* → content_block_stop → message_delta → message_stop.

Script de smoke test del repositorio

Ejecuta 6 comprobaciones de una sola vez (sin streaming / Bearer / orden SSE / errores de autenticación / model no compatible / llamada a funciones).

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

6. Hoja rápida de solución de problemas

Síntoma	Causa más probable	Solución
401 / authentication_error	No se envió x-api-key, o se pasó una clave oficial de Anthropic	Usa una TokenHub th- key
402 / permission_error	El saldo de la cuenta es 0, o se agotó el límite de gasto de la key	Recarga saldo desde Dashboard → Billing, o elimina el límite de gasto de la key
400 'model not supported'	Error tipográfico en el Model ID / mayúsculas o minúsculas incorrectas	Consulta la §2 — se aceptan tanto la forma desnuda como el prefijo anthropic/
503 'No upstream API key'	La key upstream para este model aún no se ha aprovisionado	Contacta con soporte
La transmisión se corta a mitad de camino	El tiempo de espera inactivo HTTP del cliente es demasiado corto	Aumenta el tiempo de espera inactivo a ≥ 120s
/status sigue mostrando api.anthropic.com	ANTHROPIC_API_KEY no se ha desasignado, o la terminal no se ha reiniciado	Ejecuta export ANTHROPIC_API_KEY="" y luego vuelve a abrir la terminal
La llamada a la herramienta devuelve texto plano	Se enruta a un upstream con soporte débil de tool_use	Cambia a claude-opus-4-6 / claude-sonnet-4-6, o contacta con soporte

7. Preguntas frecuentes

¿Buscas algo más?

Si estás llamando a Claude con el SDK de OpenAI, usa en su lugar la guía OpenAI-compatible.

Claude API (OpenAI-compatible) →