Claude Code

Esta guía usa solo modelos Claude. Claude Code puede ejecutar los modelos Claude (Claude Opus 5.5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Fable 5.1, Claude Haiku 5.5) y los modelos sin restricción de cliente (GLM, Qwen, Kimi, MiniMax, DeepSeek). Los modelos GPT no están disponibles en Claude Code; consulta Codex.

1. Instalar Claude Code

Instalación local

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

irm https://claude.ai/install.ps1 | iex

Instalar con npm

Requiere Node.js 18 o posterior

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

2. Configurar la API de Harogo

Para conectarte al servicio de modelos de Harogo a través de la API compatible con Anthropic, configura las siguientes variables de entorno.

Configura ANTHROPIC_BASE_URL como https://api.harogo.ai/
Configura ANTHROPIC_AUTH_TOKEN con la clave de API que obtuviste en la plataforma de Harogo
Configura ANTHROPIC_MODEL con un modelo Claude compatible con Harogo, por ejemplo claude-sonnet-5.

macOS
Windows

Ejecuta el siguiente comando en tu terminal para ver cuál es tu shell predeterminada.

echo $SHELL

Configura las variables de entorno según tu tipo de shell:

# Sustituye <HAROGO_API_KEY> por la clave real de tu plataforma de Harogo
echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.zshrc

# Sustituye <HAROGO_API_KEY> por la clave real de tu plataforma de Harogo
echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.bash_profile

Ejecuta el siguiente comando en tu terminal para aplicar las variables de entorno.

source ~/.zshrc

source ~/.bash_profile

Abre una terminal nueva y ejecuta los siguientes comandos para confirmar que las variables de entorno se aplicaron.

echo $ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
echo $ANTHROPIC_MODEL

En Windows, puedes configurar la URL base y la clave de API de Harogo como variables de entorno con CMD o con PowerShell.

CMD
PowerShell

Ejecuta el siguiente comando en CMD para configurar las variables de entorno.

REM Sustituye <HAROGO_API_KEY> por la clave real de tu plataforma de Harogo
setx ANTHROPIC_AUTH_TOKEN "<HAROGO_API_KEY>"
setx ANTHROPIC_BASE_URL "https://api.harogo.ai"
setx ANTHROPIC_MODEL "claude-sonnet-5"

Abre una ventana nueva de CMD y ejecuta los siguientes comandos para confirmar que las variables de entorno se aplicaron.

if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

Ejecuta el siguiente comando en PowerShell para configurar las variables de entorno.

# Sustituye <HAROGO_API_KEY> por la clave real de tu plataforma de Harogo
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<HAROGO_API_KEY>", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.harogo.ai", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5", [EnvironmentVariableTarget]::User)

Abre una ventana nueva de PowerShell y ejecuta los siguientes comandos para confirmar que las variables de entorno se aplicaron.

if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" }
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL

Si vas a gestionar Claude Code con CC Switch, te recomendamos no configurar también valores globales de ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL o ANTHROPIC_MODEL. Las variables de entorno a nivel de sistema o de usuario pueden sobrescribir la configuración del proveedor que escribe CC Switch, de modo que la interfaz muestra seleccionado el proveedor correcto mientras Claude Code sigue usando en realidad una clave o un modelo antiguos.

3. Verificar la configuración

Después de configurar las variables de entorno o CC Switch, envía primero una solicitud mínima para confirmar que la clave, el modelo y el endpoint compatible con Anthropic funcionan, antes de empezar una sesión más larga.

curl https://api.harogo.ai/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "1+1, output only the answer"}]
  }'

curl.exe https://api.harogo.ai/v1/messages `
  -H "content-type: application/json" `
  -H "anthropic-version: 2023-06-01" `
  -H "x-api-key: $env:ANTHROPIC_AUTH_TOKEN" `
  -d "{\"model\":\"claude-sonnet-5\",\"max_tokens\":16,\"messages\":[{\"role\":\"user\",\"content\":\"1+1, output only the answer\"}]}"

4. Empezar a usar Claude Code

Una vez configurado, ve a tu directorio de trabajo y ejecuta el comando claude en tu terminal para empezar.

$ cd /path/your-project
> claude

Si al iniciar ves Not logged in · Please run /login, o se abre el flujo de inicio de sesión de Anthropic, normalmente significa que Claude Code no detectó una configuración de Harogo válida o que no se completó la configuración inicial. Primero confirma que la solicitud mínima del paso anterior devuelve 2 y comprueba si ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL o ANTHROPIC_MODEL están siendo sobrescritas por variables de entorno globales antiguas. Si ya confirmaste que la clave funciona y aun así se abre el flujo de inicio de sesión, puedes omitir la configuración inicial con estos pasos:

Terminal con el aviso para iniciar sesión o continuar en el primer arranque de Claude Code

Busca el archivo .claude.json en tu directorio personal:
- macOS / Linux: ~/.claude.json
- Windows: C:\Users\%USERNAME%\.claude.json
Cambia el campo hasCompletedOnboarding a true

{
  "hasCompletedOnboarding": true
}

Guarda el archivo y vuelve a ejecutar claude en tu terminal.

(Opcional) Otras formas de configurar el modelo

Claude Code permite configurar el modelo de las siguientes formas, ordenadas de mayor a menor prioridad: una configuración de mayor prioridad sobrescribe a una de menor prioridad.

Durante una conversación: ejecuta el comando /model <model-name> para cambiar de modelo. Útil para un cambio puntual.

/model claude-sonnet-5

Al iniciar Claude Code: ejecuta claude --model <model-name> para indicar un modelo. Útil para una sola sesión.

claude --model claude-sonnet-5

Configurar variables de entorno: define modelos de distintos niveles según la complejidad de la tarea, y Claude Code elegirá automáticamente el adecuado. Se aplica de forma global.

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"

Donde:

ANTHROPIC_DEFAULT_OPUS_MODEL: para razonamiento complejo, diseño de arquitectura y otras tareas de alta dificultad.
ANTHROPIC_DEFAULT_SONNET_MODEL: para escribir código, implementar funcionalidades y otras tareas del día a día.
ANTHROPIC_DEFAULT_HAIKU_MODEL: para revisar sintaxis, buscar archivos y otras tareas sencillas.

Configurar de forma permanente en settings.json: escribe la configuración del modelo en el archivo de configuración de usuario de Claude Code (por ejemplo, ~/.claude/settings.json, o C:\Users\%USERNAME%\.claude\settings.json en Windows) o en una configuración a nivel de proyecto, para dejarla fija a nivel de usuario o de proyecto.

Configurar con CC Switch

Abre CC Switch, selecciona Claude Code a la izquierda y haz clic en “Añadir proveedor” (Add Provider).

Acceso a Añadir proveedor en la pantalla de inicio de CC Switch

En la lista de ajustes predefinidos, elige “Configuración personalizada” (Custom Configuration) como proveedor.

Selección de Custom Configuration en la lista de preajustes de proveedores de CC Switch

Completa el nombre del proveedor, la clave de API, el endpoint (https://api.harogo.ai), etc. Cuando hayas completado todo, haz clic en “Añadir” (Add).

Introducción de la clave de API en el formulario de configuración del proveedor en CC Switch

De vuelta en la pantalla de inicio, selecciona “harogo” en la lista de proveedores y haz clic en “Usar” (Use).

Selección de harogo y clic en Use en la pantalla principal de CC Switch

Consejo: con Claude Code abierto en tu terminal, escribe /status para ver el ID del modelo o /models para elegir otro modelo configurado.

Si CC Switch muestra “Se detectó un conflicto con variables de entorno del sistema” (System environment variable conflict detected), resuelve primero ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL y ANTHROPIC_MODEL. Estas variables globales sobrescriben la configuración actual del proveedor, y un valor de marcador como ANTHROPIC_AUTH_TOKEN=<HAROGO_API_KEY> hará que la autenticación falle directamente. Cuando estés seguro de que ya no necesitas las variables globales, elimina las entradas en conflicto en CC Switch, o borra manualmente las variables de entorno del sistema o de usuario y reinicia tu terminal.

Primeros pasos

Inicio rápido

Precios

1. Instalar Claude Code

Instalación local

Instalar con npm

2. Configurar la API de Harogo

3. Verificar la configuración

4. Empezar a usar Claude Code

(Opcional) Otras formas de configurar el modelo

Configurar con CC Switch

​1. Instalar Claude Code

​Instalación local

​Instalar con npm

​2. Configurar la API de Harogo

​3. Verificar la configuración

​4. Empezar a usar Claude Code

​(Opcional) Otras formas de configurar el modelo

​Configurar con CC Switch

1. Instalar Claude Code

Instalación local

Instalar con npm

2. Configurar la API de Harogo

3. Verificar la configuración

4. Empezar a usar Claude Code

(Opcional) Otras formas de configurar el modelo

Configurar con CC Switch