Claude Code

Descripción general

Claude Code es la herramienta CLI oficial de Anthropic para programación asistida por AI. Puedes configurarla para usar TokenLab como proveedor de API.

Instalación

Anthropic ahora recomienda el instalador nativo. La instalación con npm todavía existe por compatibilidad, pero está obsoleta en origen.

curl -fsSL https://claude.ai/install.sh | bash

Si específicamente necesitas el paquete de npm, usa:

npm install -g @anthropic-ai/claude-code

No uses sudo npm install -g para Claude Code.

Configuración

Variables de entorno

Establece las siguientes variables de entorno:

export ANTHROPIC_API_KEY="sk-your-tokenlab-key"
export ANTHROPIC_BASE_URL="https://api.tokenlab.sh"

Agrégalas a tu perfil de shell (~/.bashrc, ~/.zshrc, etc.) para que sean persistentes.

Para TokenLab, mantén ANTHROPIC_BASE_URL en https://api.tokenlab.sh sin el sufijo /v1. Esto coincide con la forma del endpoint de estilo Anthropic y el patrón de gateway unificado documentado por Claude Code.

Archivo de configuración

Como alternativa, crea o edita ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-tokenlab-key",
    "ANTHROPIC_BASE_URL": "https://api.tokenlab.sh"
  }
}

Uso

Después de la configuración, usa Claude Code normalmente:

# Start an interactive session
claude

# Run a single command
claude "Explain this code" < main.py

# Chat mode
claude chat

Verifica la instalación si es necesario:

claude --version
claude doctor

Modelos disponibles

TokenLab admite todos los modelos Claude:

Modelo	Descripción
`claude-opus-4-6`	El más capaz, razonamiento complejo
`claude-sonnet-4-6`	Rendimiento equilibrado, excelente para programación
`claude-haiku-4-5`	El más rápido, rentable

Selección de modelo

Especifica un modelo con la bandera --model:

claude --model claude-sonnet-4-6 "Review this PR"

O establece uno predeterminado en tu configuración:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-tokenlab-key",
    "ANTHROPIC_BASE_URL": "https://api.tokenlab.sh"
  },
  "model": "claude-sonnet-4-6"
}

Pensamiento extendido

Para tareas de razonamiento complejas, usa modelos con pensamiento extendido:

claude --model claude-opus-4-6 "Design a microservices architecture for..."

Solución de problemas

Errores de conexión

Verifica que la URL base sea exactamente https://api.tokenlab.sh (sin el sufijo /v1 para solicitudes de estilo Anthropic).

API key no válida

Asegúrate de que tu API key de TokenLab comience con sk- y tenga saldo suficiente.

El gateway requiere Authorization bearer token

El modo gateway de Claude Code también admite ANTHROPIC_AUTH_TOKEN. Sigue usando ANTHROPIC_API_KEY para la configuración estándar de TokenLab, a menos que hayas cambiado intencionalmente el comportamiento de autenticación de tu gateway.

Modelo no encontrado

Comprueba que el nombre del modelo sea correcto. Usa el formato claude-sonnet-4-6.

Matriz de compatibilidad

Herramientas de código

SDKs nativos

Frameworks y plataformas

Apps de chat

Descripción general

Instalación

Configuración

Variables de entorno

Archivo de configuración

Uso

Modelos disponibles

Selección de modelo

Pensamiento extendido

Solución de problemas

​Descripción general

​Instalación

​Configuración

​Variables de entorno

​Archivo de configuración

​Uso

​Modelos disponibles

​Selección de modelo

​Pensamiento extendido

​Solución de problemas

Descripción general

Instalación

Configuración

Variables de entorno

Archivo de configuración

Uso

Modelos disponibles

Selección de modelo

Pensamiento extendido

Solución de problemas