Guía de instalación y uso de Claude Code - Configuración del asistente de programación con IA

Claude Code es un potente asistente de programación con IA que te permite colaborar con la IA directamente en tu terminal. Esta guía te explicará paso a paso el proceso de instalación y configuración.

Requisitos del sistema#

Antes de instalar Claude Code, asegúrate de que tu sistema cumple estos requisitos:

• Node.js: Versión 18.0 o superior
• Sistema operativo: macOS, Linux o Windows (se recomienda WSL)

Inicio rápido#

Paso 1: Instalar Node.js#

Si ya tienes instalada la versión 18.0 o superior de Node.js, puedes saltarte este paso.

Ubuntu / Debian#

# Install Node.js LTS version
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# Verify installation
node --version

macOS#

# Install Xcode command line tools
sudo xcode-select --install

# Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Node.js via Homebrew
brew install node

# Verify installation
node --version

Paso 2: Instalar Claude Code#

Instala Claude Code globalmente usando npm:

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

# Verify installation
claude --version

Paso 3: Configurar el acceso a la API#

Necesitas dos elementos de configuración para usar Claude Code con Crazyrouter API:

Configuración de token recomendada:

• Nombre: Cualquier nombre descriptivo
• Cuota: Establecer en ilimitada para desarrollo
• Grupo: Selecciona "Claude Code" o "Official Claude 3+"
• Otras opciones: Mantener la configuración predeterminada

Paso 4: Iniciar Claude Code#

Linux / macOS#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

# Launch Claude Code
claude

Windows PowerShell#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
$env:ANTHROPIC_BASE_URL = "https://crazyrouter.com/"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-token-here"
$env:API_TIMEOUT_MS = "300000"

# Launch Claude Code
claude

Windows CMD#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
set ANTHROPIC_BASE_URL=https://crazyrouter.com/
set ANTHROPIC_AUTH_TOKEN=sk-your-token-here
set API_TIMEOUT_MS=300000

# Launch Claude Code
claude

Paso 5: Configuración en la primera ejecución#

Después de iniciar Claude Code por primera vez, verás estos pasos de configuración:

1. Select Theme - Elige tu tema de color preferido y pulsa Enter
2. Safety Notice - Revisa y confirma el aviso de seguridad
3. Terminal Configuration - Usa la configuración predeterminada o personalízala
4. Working Directory Trust - Confía en el directorio actual para permitir el acceso a archivos

¡Enhorabuena! Ya estás listo para empezar a programar con tu compañero de programación con IA.

Configuración permanente (opcional)#

Para evitar definir las variables de entorno cada vez, añádelas a tu perfil de shell:

Bash (~/.bashrc o ~/.bash_profile)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

Zsh (~/.zshrc)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

Después de añadirlas, recarga tu shell:

source ~/.bashrc  # or source ~/.zshrc

Preguntas frecuentes#

Error "Invalid API Key"#

Si ves "Invalid API Key - Please run /login", comprueba:

• Que ANTHROPIC_AUTH_TOKEN esté definido correctamente (empieza por sk-)
• Que ANTHROPIC_BASE_URL esté definido como https://crazyrouter.com/
• Reinicia tu terminal después de definir las variables de entorno

Estado "Offline"#

Claude Code comprueba el estado de la red conectándose a Google. Que aparezca "offline" no afecta al uso normal: solo indica que no se puede conectar a los servidores de Google.

Fallos al hacer web fetch#

Claude Code realiza comprobaciones de seguridad antes de acceder a páginas web. Asegúrate de:

• Tener una conexión a internet estable
• Usar un proxy global si es necesario

Errores persistentes de "Fetch Failed"#

Esto puede deberse a problemas de red. Prueba lo siguiente:

1. Sal de Claude Code (Ctrl+C)
2. Vuelve a ejecutar el comando claude
3. Si el problema continúa, inténtalo de nuevo más tarde

Errores de API#

Si encuentras errores de API:

• Sal de Claude Code (Ctrl+C)
• Espera un momento y reinicia
• Comprueba la cuota de tu token en el panel de control

Notas importantes#

• Crazyrouter proporciona reenvío directo a los servicios oficiales de Claude Code
• Mantén tu token de API seguro y no lo compartas públicamente
• Supervisa tu uso en el panel de control para evitar cargos inesperados

Precios#

Claude Code utiliza modelos Claude con la siguiente estructura de precios en Crazyrouter:

Todos los precios incluyen un 45% de descuento en comparación con las tarifas oficiales.

Recursos relacionados#

• Página de precios de Crazyrouter
• Documentación oficial de Claude Code
• Sitio web oficial de Node.js

¿Necesitas ayuda? Ponte en contacto con soporte o consulta la documentación de Crazyrouter para más información.