CLI de Claude Code

Conecta la CLI de Claude Code a GetVibe API: configura ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN y la selección del modelo mediante variables de entorno.

Configuración lista para usar

Download settings.json

Se genera a partir de nuestro catálogo cuando lo solicitas: la dirección de la API, todos los modelos publicados con su contexto y límite de salida, y la configuración recomendada. No contiene ninguna clave. Claude Code lee la clave de GETVIBE_API_KEY mediante apiKeyHelper: configúrala en tu entorno. En Windows sin WSL, configura ANTHROPIC_AUTH_TOKEN en su lugar.

# macOS / Linux
mkdir -p ~/.claude
curl -fsSL https://getvibeapi.com/api/integrations/claude-code.json -o ~/.claude/settings.json

# Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
Invoke-WebRequest https://getvibeapi.com/api/integrations/claude-code.json -OutFile "$HOME\.claude\settings.json"

Modelo principal — claude-opus-5.5: el Claude más potente que ofrecemos mediante /v1/messages.
Tareas pequeñas — claude-haiku-4.5: el Claude más económico, utilizado por Claude Code para tareas en segundo plano.
Transmisión activada, un tiempo de espera de 600 segundos por solicitud y esfuerzo de razonamiento medium: una respuesta de razonamiento larga tarda minutos y, sin transmisión, alcanza el límite de espera.
Usa los IDs de modelo sin formato, sin :suffix — esto mantiene activo el failover automático hacia un canal saludable.

El catálogo cambia: cuando aparezcan modelos nuevos, vuelve a descargar el archivo. Para conservar solo algunos modelos, añade ?models= con IDs separados por comas a la URL.

¿No quieres terminal? Para la mayoría de tareas es más simple la app Claude Desktop: unos pasos, sin comandos. Esta página es para quien trabaja con código desde una terminal.

Claude Code es la CLI oficial de Anthropic para programación agéntica. Funciona con el endpoint /v1/messages y la cabecera x-api-key.

1. Abre una terminal

Windows: Inicio → escribe PowerShell → Intro. macOS: Terminal (Aplicaciones → Utilidades). La instalación con npm requiere Node.js 22 o posterior (node --version): el bloque de abajo instala la propia CLI. ¿Prefieres no usar Node.js? El instalador nativo de Anthropic también funciona: curl -fsSL https://claude.ai/install.sh | bash (macOS/Linux) o irm https://claude.ai/install.ps1 | iex (PowerShell); después configura las variables de abajo en una ventana nueva.

2. Pega un bloque y pulsa Enter

El bloque instala la CLI, guarda los ajustes para siempre (setx), los aplica en la ventana actual y arranca el programa. Sustituye sk-pv-… por tu clave.

Windows (PowerShell)

npm.cmd install -g @anthropic-ai/claude-code
setx ANTHROPIC_BASE_URL "https://getvibeapi.com"
setx ANTHROPIC_AUTH_TOKEN "sk-pv-…"
$env:ANTHROPIC_BASE_URL="https://getvibeapi.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-pv-…"
$env:ANTHROPIC_API_KEY=""
claude.cmd

macOS / Linux

npm install -g @anthropic-ai/claude-code
export ANTHROPIC_BASE_URL="https://getvibeapi.com"
export ANTHROPIC_AUTH_TOKEN="sk-pv-…"
export ANTHROPIC_API_KEY=""
claude

Importante: la dirección es https://getvibeapi.com (sin /v1): la CLI añade el sufijo por su cuenta. La clave va en ANTHROPIC_AUTH_TOKEN y ANTHROPIC_API_KEY se deja vacío: si ya hay una clave de Anthropic guardada en el equipo, Claude Code advertiría de un conflicto entre dos claves. Después de setx, las nuevas ventanas de PowerShell aplican la configuración; las que ya estaban abiertas, no.

Dónde escribir

Al arrancar, la línea con el signo > al pie de la ventana es donde escribes y pulsas Enter:

+---------------------------------------+
|                                       |
|  > _                                  |
|                                       |
+---------------------------------------+

El primer arranque pregunta por el tema (pulsa Enter) y si confías en la carpeta (elige Yes, I trust this folder). Para trabajar de verdad, inicia la CLI desde la carpeta del proyecto.

3. Comprueba la conexión

Envía cualquier mensaje y abre Panel → Uso: aparecerá un nuevo registro con el modelo y el gasto. Dentro de Claude Code, /status muestra una línea Anthropic base URL: debe mostrar nuestra dirección.

Elegir modelos (opcional)

Por defecto Claude Code usa el modelo predeterminado del catálogo. Cámbialo con variables de entorno:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-pv-…",
    "ANTHROPIC_BASE_URL": "https://getvibeapi.com",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL":   "claude-opus-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL":  "claude-haiku-5.5"
  }
}

Si prefieres settings.json

Obtienes el mismo resultado con el archivo ~/.claude/settings.json. En Windows: %USERPROFILE%\.claude\settings.json. Pega la propia clave: Claude Code no expande variables como $GETVIBE_API_KEY dentro de settings.json, por lo que esa cadena se enviaría como clave y la solicitud se rechazaría.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-pv-…",
    "ANTHROPIC_BASE_URL": "https://getvibeapi.com",
    "ANTHROPIC_API_KEY": ""
  }
}

Problemas comunes

Parámetro	Tipo	Descripción
`401`	error	Comprueba el valor de ANTHROPIC_AUTH_TOKEN: settings.json debe contener la propia clave sk-pv-…, no una $variable.
`Requests go to Anthropic`	config	ANTHROPIC_BASE_URL no llegó a Claude Code: abre una ventana nueva después de setx o configura la dirección en settings.json. Comprueba la línea de la URL base de Anthropic en /status.
`404`	error	ANTHROPIC_BASE_URL incluyó /v1: debe ser la dirección raíz sin el sufijo.
`npm.ps1 is blocked`	Windows	Es la política de ejecución de PowerShell. Usa npm.cmd y claude.cmd como en el bloque de arriba: no hace falta cambiar la política.
`"node is not recognized"`	Windows	Node.js no está instalado, o la ventana es anterior a la instalación: instala Node.js LTS y abre una ventana de PowerShell NUEVA.
`claude native binary not installed / warn install-scripts`	npm	Las versiones más recientes de npm omiten de forma predeterminada el paso de instalación de Claude Code. Ejecuta npm config set "allow-scripts=@anthropic-ai/claude-code" --location=user y vuelve a instalarlo, o usa el instalador nativo.
`Variables are not picked up`	config	settings.json es más confiable que los perfiles de shell, especialmente en Windows.

← AnteriorPi Agent Siguiente →Claude Desktop