Guía de configuración de Claude Code

Contenido actualizado: 2026-06-16

Claude Code es una de las herramientas de codificación terminal más recomendables para integrarse prioritariamente con Crazyrouter. Utiliza directamente Anthropic Messages API, siendo ideal para lectura de código, modificación, refactorización, ejecución de comandos, invocación de herramientas y análisis de repositorios con contexto extenso.

Resumen

Mediante variables de entorno, Claude Code puede enviar solicitudes Anthropic directamente a Crazyrouter:

Protocolo recomendado: Anthropic Messages API
Base URL: https://api.crazyrouter.com
Base URL internacional API por defecto: https://api.crazyrouter.com
Variable de autenticación: ANTHROPIC_API_KEY
Modelo por defecto recomendado: claude-opus-4-8

Claude Code completa automáticamente la ruta de solicitud Anthropic, por eso la Base URL debe ser el dominio raíz https://api.crazyrouter.com o https://api.crazyrouter.com; no agregues manualmente /v1 o /v1/messages.

Ver el repositorio de configuración de Claude Code con un clic

Si deseas instalar Claude Code mediante scripts y añadir variables de entorno de Crazyrouter, consulta el repositorio crazyrouter-claude-code.

¿Quién debería usarlo?

Desarrolladores que quieren usar Crazyrouter como backend de Claude Code
Personas que buscan flujos de trabajo estables con invocación de herramientas, largo contexto y codificación en terminal
Quienes desean separar la facturación entre Claude Code y Cursor / Codex / Aider
Equipos que requieren una configuración unificada del CLI en Linux, macOS y Windows

Protocolo de uso

Protocolo recomendado: Anthropic Messages API Cuando Claude Code se conecta a Crazyrouter, utilice:

ANTHROPIC_BASE_URL=https://api.crazyrouter.com

La entrada internacional por defecto del API también debe ser solo la dirección raíz:

ANTHROPIC_BASE_URL=https://api.crazyrouter.com

No escribas como:

https://api.crazyrouter.com/v1
https://api.crazyrouter.com/v1/messages
https://api.crazyrouter.com/v1/complete
https://api.crazyrouter.com/v1
https://api.crazyrouter.com/v1/messages

Requisitos del sistema y condiciones previas

Proyecto	Descripción
Cuenta Crazyrouter	Registra primero en crazyrouter.com
Token Crazyrouter	Se recomienda crear un token específico para Claude Code: `sk-...`
Git	Se recomienda `git 2.23+`, para facilitar retroceso y revisión de cambios AI
Node.js	Se recomienda `Node.js 18+`
Claude Code	Recomendado usar la versión estable actual
Permisos de modelos de la serie Claude	Habilita al menos `claude-opus-4-8`

Lista blanca inicial sugerida:

claude-opus-4-8
claude-opus-4-8

Rutas completas de instalación según sistema operativo

Ruta recomendada para Windows

La ruta más estable para Claude Code en Windows es: Git + Node.js + Instalar Claude Code globalmente con npm + PowerShell, añadiendo las variables de entorno. Orden recomendado:

Instala Git
Instala Node.js LTS
Instala Claude Code usando npm
Usa PowerShell para crear variables temporales
Usa PowerShell para establecer variables persistentes a nivel de usuario

Comando recomendado de verificación:

git --version
node -v
npm -v
claude --version
where.exe git
where.exe node
where.exe claude

Si claude --version no reconoce el comando, cierra y vuelve a abrir PowerShell y prueba de nuevo.

Ruta recomendada para macOS

Claude Code se instala más cómodamente en macOS mediante: Xcode Command Line Tools + Homebrew + Git + Node.js + Instalar Claude Code globalmente con npm + ~/.zshrc para persistencia de variables de entorno. Orden recomendado:

Instala Xcode Command Line Tools
Instala Homebrew (si aún no lo tienes)
Instala Git y Node.js
Instala Claude Code usando npm
Añade ~/.zshrc
Abre un terminal nuevo para verificar el comando

Comando recomendado de verificación:

git --version
node -v
npm -v
claude --version
which git
which node
which claude

¿Por qué no se recomienda escribir manualmente la ruta del API aquí?

Claude Code utiliza el protocolo nativo de Anthropic. Solo debes indicarle la dirección raíz del sitio:

ANTHROPIC_BASE_URL=https://api.crazyrouter.com

La entrada internacional del API también debe ser solo la dirección raíz:

ANTHROPIC_BASE_URL=https://api.crazyrouter.com

No lo hagas como los clientes compatibles con OpenAI, concatenando /v1, /v1/messages o rutas de API específicas. Si deseas instalar Claude Code automáticamente mediante scripts y añadir variables de entorno de Crazyrouter, revisa crazyrouter-claude-code. Este repositorio ofrece scripts de configuración para Windows, macOS y Linux; este documento mantiene los pasos de configuración manual completos para que puedas revisar cada ajuste.

Instalación completa desde cero

Paso 1: Instalar Git

Si tu equipo aún no tiene Git, instala Git primero, luego continúa con la configuración de Claude Code.

Windows PowerShell
macOS
Ubuntu / Debian

winget install --id Git.Git -e --source winget
git --version

xcode-select --install
git --version

Si ya usas Homebrew, también puedes:

brew install git
git --version

sudo apt update
sudo apt install -y git
git --version

Tras instalar, añade información global de identidad:

git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main

Paso 2: Instalar Node.js 18+

Claude Code depende de Node.js. Verifica la versión antes de continuar la instalación.

Windows PowerShell
macOS
Ubuntu / Debian

winget install OpenJS.NodeJS.LTS
node -v
npm -v

brew install node
node -v
npm -v

sudo apt update
sudo apt install -y nodejs npm
node -v
npm -v

Si después de instalar node -v sigue siendo inferior a 18, actualiza usando nvm o el paquete oficial de Node, luego continúa.

Paso 3: Instalar Claude Code

Windows PowerShell
macOS

npm install -g @anthropic-ai/claude-code
claude --version
where.exe claude

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

No uses sudo npm install -g @anthropic-ai/claude-code. Si la instalación global presenta problemas de permisos, arregla el entorno npm/Node antes de seguir.

Paso 4: Crear un token dedicado de Claude Code en Crazyrouter

Ingresa en el panel de Crazyrouter y crea un token dedicado, recomiendo nombrarlo claude-code.Inicialmente solo habilita:

claude-opus-4-8
claude-opus-4-8

Además configura un límite independiente para evitar compartir presupuesto con Cursor, Codex u OpenClaw.

Paso 5: Configura primero las variables de entorno temporales en el terminal actual

Haz primero una configuración temporal y, una vez que funcione, escribe la configuración persistente.

macOS / Linux
Windows PowerShell

export ANTHROPIC_BASE_URL=https://api.crazyrouter.com
export ANTHROPIC_API_KEY=sk-xxx
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

$env:ANTHROPIC_BASE_URL = "https://api.crazyrouter.com"
$env:ANTHROPIC_API_KEY = "sk-xxx"
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY

Escribe ANTHROPIC_BASE_URL como dominio raíz https://api.crazyrouter.com, no como https://api.crazyrouter.com/v1.

Paso 6: Escribe las variables de entorno en la configuración permanente

Las variables temporales solo funcionan en el terminal actual. Para uso diario añade a los archivos de configuración del shell.

Linux Bash
macOS / Zsh
Windows PowerShell

echo 'export ANTHROPIC_BASE_URL=https://api.crazyrouter.com' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY=sk-xxx' >> ~/.bashrc
source ~/.bashrc

echo 'export ANTHROPIC_BASE_URL=https://api.crazyrouter.com' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=sk-xxx' >> ~/.zshrc
source ~/.zshrc

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.crazyrouter.com", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-xxx", "User")

$env:ANTHROPIC_BASE_URL = "https://api.crazyrouter.com"
$env:ANTHROPIC_API_KEY = "sk-xxx"

En las variables persistentes ANTHROPIC_BASE_URL también debe escribirse como https://api.crazyrouter.com.Al concluir, abre un terminal nuevo y ejecuta:

macOS / Linux
Windows PowerShell

claude --version
echo $ANTHROPIC_BASE_URL

claude --version
echo $env:ANTHROPIC_BASE_URL

Paso 7: Prepara tu repositorio de Git

Claude Code lee/escribe archivos y ejecuta comandos. Para la primera integración, verifica en un repositorio pequeño que conozcas.Si el directorio actual no es repo Git:

git init
git add .
git commit -m "chore: initial snapshot before Claude Code"

Si ya es un repositorio, confirma que el área de trabajo esté en un estado que consideres aceptable:

git status

Paso 8: Inicia Claude Code y completa la verificación por primera vez

Una vez dentro del directorio del proyecto, ejecuta:

cd /path/to/your/project
claude

Para la primera verificación se sugiere el siguiente orden:

Envía: Responde únicamente OK
Luego: Lee únicamente la estructura del repositorio actual, sin modificar ningún archivo
Finalmente, haz tareas de bajo riesgo como: Identifica errores tipográficos evidentes en el README, sin modificar el archivo todavía

Si las tres responden normalmente y Crazyrouter muestra registros, la conexión está lista.

Configuración de modelos recomendados

Situación de uso	Modelo recomendado	Razón
Uso principal por defecto	`claude-opus-4-8`	Mejor equilibrio entre calidad, velocidad y coste; adecuado para tareas de codificación comunes
Refactorización compleja	`claude-opus-4-8`	Mejora el razonamiento, planificación y comprensión de código complejos
Análisis de repositorios de largo contexto	`claude-opus-4-8`	Estable; adecuado para sesiones largas
Verificación sensible a coste	`claude-opus-4-8`	Prioriza comprobar el flujo principal

Recomiendo estabilizar el flujo de trabajo con claude-opus-4-8, solo cambia a claude-opus-4-8 cuando se presenten tareas complejas.

Usar modelos no-Claude en Claude Code

Además de los modelos Claude nativos, Crazyrouter ofrece integración nativa de algunos modelos nacionales mediante el API de Anthropic Messages. La siguiente lista solo incluye modelos verificados en clientes reales de producción el 15-05-2026, omitiendo modelos históricos aún no verificados.

Lista de modelos realmente disponibles

ID de modelo	Proveedor	`Reply only OK`	Lee `agent.md`	Resultado actual	Notas
`deepseek-v4-pro`	DeepSeek	Completa	Completa	Usable en Claude Code P0	Adecuado para codificación general; en Codex todavía no se recomienda usar Responses
`MiniMax-M2.7`	MiniMax	Completa, pero incluye `<think>`	Completa, pero incluye `<think>`	Protocolo usable	Experiencia de tareas estrictas de salida es pobre
`kimi-k2.5`	Moonshot Kimi	Completa	Completa	Usable en Claude Code P0	Uno de los modelos nacionales más estables actualmente
`kimi-k2.6`	Moonshot Kimi	Completa	Completa	Usable en Claude Code P0	Igual que `kimi-k2.5`
`glm-5.1`	GLM	Completa	Completa	Usable en Claude Code P0	Solo en Claude Code; en Codex, Responses nativo aún no usable

Las pruebas fueron realizadas en cliente real de Claude Code, validando vía https://api.crazyrouter.com sobre la cadena POST /v1/messages nativa.

La tabla refleja modelos “actualmente verificados y disponibles”, no todos los modelos nacionales que pueden teóricamente convertirse al protocolo Anthropic. Si un modelo no aparece, significa que no está listado en esta documentación como recomendado y verificado para Claude Code.

¿Cómo cambiar el modelo?

Claude Code permite seleccionar modelo mediante variable de entorno ANTHROPIC_MODEL o comando en sesión /model. Solo reemplaza el nombre por cualquiera de la tabla anterior.

macOS / Linux
Windows PowerShell

export ANTHROPIC_BASE_URL=https://api.crazyrouter.com
export ANTHROPIC_API_KEY=sk-xxx

# 临时切到 Kimi K2.5
export ANTHROPIC_MODEL=kimi-k2.5
claude

# 或临时切到 MiniMax
ANTHROPIC_MODEL=MiniMax-M2.7 claude

$env:ANTHROPIC_BASE_URL = "https://api.crazyrouter.com"
$env:ANTHROPIC_API_KEY  = "sk-xxx"

$env:ANTHROPIC_MODEL = "kimi-k2.5"
claude

# 或临时切换
$env:ANTHROPIC_MODEL = "MiniMax-M2.7"; claude

También puedes cambiar modelo por comando en la sesión tras iniciar Claude Code:

/model kimi-k2.5
/model MiniMax-M2.7

Recomendaciones de uso y diferencias conocidas

Prioridad recomendada: Si quieres usar modelos nacionales en Claude Code, comienza por kimi-k2.5 y kimi-k2.6, luego considera deepseek-v4-pro. Para la serie Qwen, verifica primero el ID disponible con /v1/models y valida por separado.
Diferencias conocidas de MiniMax: MiniMax-M2.7 usa el protocolo, pero muestra el proceso de pensamiento como texto, entre etiquetas <think>...</think>. No se recomienda para tareas estrictas donde solo se espera “una frase”.
Límites de DeepSeek / GLM: deepseek-v4-pro y glm-5.1 funcionan en Claude Code, pero eso no implica que sean aptos para Responses nativos de Codex. Son protocolos distintos, no mezclar.
Lista blanca de tokens: Si tu token exclusivo de Claude Code tiene lista blanca de modelos, añade los nacionales deseados, de lo contrario se devolverá 403 model not allowed.
Verificación recomendada en cliente real: Realiza una ronda de Reply only OK, luego prueba una tarea de “leer un archivo y devolver solo el título”, es más cercana al uso real que probar solo el API.

Comando único para verificar disponibilidad de un modelo

curl -sS https://api.crazyrouter.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k2.5",
    "max_tokens": 32,
    "messages": [{"role":"user","content":"reply OK"}]
  }'

Si la respuesta es 200 y content[].text no está vacío, Claude Code puede usar el modelo normalmente.

Mejores prácticas de configuración de token

Ajuste	Recomendación	Descripción
Token exclusivo	Obligatorio	No compartas token de Claude Code con Cursor, Codex ni OpenClaw
Lista blanca de modelos	Altamente recomendado	Activa solo los modelos Claude o nacionales realmente usados, simplificando el control de errores y manejo de costes
Restricción IP	Activa en entornos de salida fija	Si el portátil cambia mucho de IP úsalo con precaución
Límite de cuota	Altamente recomendado	Conversaciones largas y herramientas consumen cuota constantemente
Separación de desarrollo/equipo	Recomendado	Cada desarrollador o máquina compartida debe usar tokens independientes
Rotación por filtración	Obligatorio	Si el token se expone por historia del shell, grabación u terminal compartido, cámbialo de inmediato

Lista de verificación

Errores comunes y solución

Síntoma	Causa habitual	Solución
`claude: command not found`	Claude Code no está instalado o la ruta global npm no está en PATH	Reinstala, asegúrate de que `npm bin -g` esté en PATH
`node` versión muy baja	La versión de Node en el equipo es inferior al mínimo requerido	Actualiza a Node.js 18+ y reinstala Claude Code
401 unauthorized	`ANTHROPIC_API_KEY` inválido, expirado o mal copiado	Regenera el token y reconfigura las variables de entorno
403 / model not allowed	Token no permite el modelo Claude actual	Permite el modelo requerido en la configuración de token de Crazyrouter
404	Base URL configurado como `/v1`, `/v1/messages` u otra ruta incorrecta	Corrige a `https://api.crazyrouter.com` o `https://api.crazyrouter.com`
Path en logs incluye `/v1/v1/messages`, `/v1/v1/models` o `/v1/messages/v1/messages`	Base URL de Claude Code contiene `/v1` o endpoint completo y el cliente añade ruta doble	Configura `ANTHROPIC_BASE_URL` como dominio raíz, sin rutas adicionales
Tras iniciar Claude Code sigue usando configuración vieja	Variables de entorno nuevas no cargadas	Abre un terminal nuevo o ejecuta `source ~/.bashrc` / `source ~/.zshrc` de nuevo
Cambios en Git desordenados	No se hizo snapshot del repositorio antes de dejar que AI modifique el código	Haz commit de un snapshot inicial y modifica por etapas
Coste mayor al esperado	Contexto largo, muchas herramientas, sesiones prolongadas	Reduce duración, divide tareas, asigna presupuesto exclusivo a Claude Code

Recomendaciones de rendimiento y costes

Usa claude-opus-4-8 por defecto
Cambia a claude-opus-4-8 solo en análisis complejo o refactorización extensa
Valida siempre con repositorios pequeños en la primera integración, nunca sobre repositorios de producción completos
Antes de cada tarea revisa git status
Cuando se use muchas herramientas, revisa los logs de Crazyrouter y el consumo de token

FAQ

¿Qué Base URL debo escribir en Claude Code?

Escribe el dominio raíz: https://api.crazyrouter.com Para API internacional predeterminado, usa el dominio raíz: https://api.crazyrouter.com

¿Por qué aquí no se debe escribir `/v1`?

Porque Claude Code añade automáticamente la ruta Anthropic Messages API. Solo debes proporcionar el dominio raíz.

¿Qué método usar en Windows?

Si desarrollas principalmente por línea de comandos, elige PowerShell o WSL2 prioritariamente. En cualquier caso, asegúrate de tener Git, Node.js y Claude Code instalados correctamente.

¿PowerShell o Git Bash en Windows?

Para primeros pasos, elige PowerShell. Escritura de variables de entorno, verificación where.exe y persistencia de variables de usuario son más directas.

¿Por qué primero debo hacer snapshot con Git?

Porque Claude Code modifica archivos y ejecuta comandos. Si hay problemas, podrás revisar y revertir fácilmente.

¿Qué modelo es el primer recomendado?

Comienza con claude-opus-4-8. Suele ser el más estable para empezar.

Si buscas principalmente modelos de la serie Claude y experiencia de codificación en terminal, Claude Code debería ser el primero en la lista de integración de Crazyrouter.

Ver el repositorio crazyrouter-claude-code

Consulta scripts de configuración automática, README y últimas instrucciones de uso.

Claves API y gestión de la consola

SDK y ejemplos de código

Integraciones

Guía de configuración de Claude Code

Resumen

Ver el repositorio de configuración de Claude Code con un clic

¿Quién debería usarlo?

Protocolo de uso

Requisitos del sistema y condiciones previas

Rutas completas de instalación según sistema operativo

Ruta recomendada para Windows

Ruta recomendada para macOS

¿Por qué no se recomienda escribir manualmente la ruta del API aquí?

Instalación completa desde cero

Configuración de modelos recomendados

Usar modelos no-Claude en Claude Code

Lista de modelos realmente disponibles

¿Cómo cambiar el modelo?

Recomendaciones de uso y diferencias conocidas

Comando único para verificar disponibilidad de un modelo

Mejores prácticas de configuración de token

Lista de verificación

Errores comunes y solución

Recomendaciones de rendimiento y costes

FAQ

¿Qué Base URL debo escribir en Claude Code?

¿Por qué aquí no se debe escribir `/v1`?

¿Qué método usar en Windows?

¿PowerShell o Git Bash en Windows?

¿Por qué primero debo hacer snapshot con Git?

¿Qué modelo es el primer recomendado?

Ver el repositorio crazyrouter-claude-code

Páginas relacionadas

​Resumen

Ver el repositorio de configuración de Claude Code con un clic

​¿Quién debería usarlo?

​Protocolo de uso

​Requisitos del sistema y condiciones previas

​Rutas completas de instalación según sistema operativo

​Ruta recomendada para Windows

​Ruta recomendada para macOS

​¿Por qué no se recomienda escribir manualmente la ruta del API aquí?

​Instalación completa desde cero

​Configuración de modelos recomendados

​Usar modelos no-Claude en Claude Code

​Lista de modelos realmente disponibles

​¿Cómo cambiar el modelo?

​Recomendaciones de uso y diferencias conocidas

​Comando único para verificar disponibilidad de un modelo

​Mejores prácticas de configuración de token

​Lista de verificación

​Errores comunes y solución

​Recomendaciones de rendimiento y costes

​FAQ

​¿Qué Base URL debo escribir en Claude Code?

​¿Por qué aquí no se debe escribir /v1?

​¿Qué método usar en Windows?

​¿PowerShell o Git Bash en Windows?

​¿Por qué primero debo hacer snapshot con Git?

​¿Qué modelo es el primer recomendado?

Ver el repositorio crazyrouter-claude-code

​Páginas relacionadas

Resumen

¿Quién debería usarlo?

Protocolo de uso

Requisitos del sistema y condiciones previas

Rutas completas de instalación según sistema operativo

Ruta recomendada para Windows

Ruta recomendada para macOS

¿Por qué no se recomienda escribir manualmente la ruta del API aquí?

Instalación completa desde cero

Configuración de modelos recomendados

Usar modelos no-Claude en Claude Code

Lista de modelos realmente disponibles

¿Cómo cambiar el modelo?

Recomendaciones de uso y diferencias conocidas

Comando único para verificar disponibilidad de un modelo

Mejores prácticas de configuración de token

Lista de verificación

Errores comunes y solución

Recomendaciones de rendimiento y costes

FAQ

¿Qué Base URL debo escribir en Claude Code?

¿Por qué aquí no se debe escribir `/v1`?

¿Qué método usar en Windows?

¿PowerShell o Git Bash en Windows?

¿Por qué primero debo hacer snapshot con Git?

¿Qué modelo es el primer recomendado?

Páginas relacionadas