Integraciones

Claude Code

Conecta Claude Code CLI mediante variables de entorno. Sin necesidad de cuenta Anthropic—usa una clave API unificada para facturación y llamadas.

¿Por qué usar Claude Code a través de la plataforma?

Acceso estable

Conectividad directa sin configuración de red adicional. Las solicitudes nunca se interrumpen.

Facturación unificada

Comparte una clave API para todas las llamadas. Gestiona uso y saldo centralizadamente en la consola.

Soporte multi-modelo

Además de toda la línea Claude, llama a GPT, Gemini y otros modelos desde Claude Code.

Inicio rápido

Instalar Claude Code

Claude Code es compatible con macOS / Linux / WSL y Windows PowerShell.

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

Configurar variables de entorno

Escribe las siguientes tres líneas en tu archivo de configuración de shell (~/.zshrc, ~/.bashrc o ~/.config/fish/config.fish).

~/.zshrc

export HYPERSHUB_API_KEY="hy-..."        # replace with your platform API Key
export ANTHROPIC_BASE_URL="https://apiclaw.cc"
export ANTHROPIC_AUTH_TOKEN="$HYPERSHUB_API_KEY"
export ANTHROPIC_API_KEY=""                  # must be explicitly empty to avoid conflicts

Nota：No escribas estas variables en un archivo .env del proyecto—Claude Code CLI no lo lee por defecto. Después de editar, ejecuta source ~/.zshrc (o reinicia la terminal) para aplicar.

¿Ya habías iniciado sesión en Anthropic?？Ejecuta /logout en una sesión de Claude Code para limpiar credenciales en caché, luego reinicia la terminal.

Iniciar una sesión

Terminal

cd /path/to/your/project
claude

Verificar conexión

En una sesión de Claude Code, ejecuta /status y confirma que Anthropic base URL muestra la dirección de la plataforma:

Sesión de Claude Code

> /status
Auth token:        ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://apiclaw.cc

También puedes consultar los registros de uso en la consola para ver esta solicitud y confirmar la facturación.

Configurar modelos

Claude Code ofrece variables de entorno de modelo separadas para distintos tipos de tareas (modelo principal, subagentes, autocompletado rápido). Sobrescríbelas según necesites:

~/.zshrc (opcional)

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-8"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-opus-4-8"

Variable de entorno	Propósito
ANTHROPIC_DEFAULT_OPUS_MODEL	Tareas de razonamiento de alta complejidad (por defecto usa modelo nivel Opus)
ANTHROPIC_DEFAULT_SONNET_MODEL	Tareas de codificación generales (por defecto usa modelo nivel Sonnet)
ANTHROPIC_DEFAULT_HAIKU_MODEL	Tareas de autocompletado rápido (por defecto usa modelo nivel Haiku)
CLAUDE_CODE_SUBAGENT_MODEL	Modelo usado para llamadas de subagentes

Claude Code está optimizado para modelos Anthropic. Usar otros proveedores puede causar problemas de compatibilidad.

GitHub Action

Para usar la plataforma a través de la claude-code-action oficial, solo dos pasos: guarda tu clave API como GitHub Secret y sobrescribe ANTHROPIC_BASE_URL.

.github/workflows/claude.yml

- name: Run Claude Code
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.HYPERSHUB_API_KEY }}
  env:
    ANTHROPIC_BASE_URL: https://apiclaw.cc

Solución de problemas

Error de autenticación / Auth Error

Asegúrate de que ANTHROPIC_API_KEY esté explícitamente vacío (""). Si no se establece (null), Claude Code intenta autenticarse contra Anthropic en lugar de la plataforma.

La configuración no surte efecto

Verifica que las variables estén en un archivo de configuración de shell y hayan sido sourced, o reinicia la terminal. No uses un archivo .env del proyecto.

Context Length excedido

Divide la tarea en fragmentos más pequeños o inicia una nueva sesión en Claude Code.