Configurar Claude Code
Instala, autentica y comienza a usar Claude Code en tu máquina de desarrollo.
Requisitos del sistema
- Sistemas Operativos: macOS 10.15+, Ubuntu 20.04+/Debian 10+, o Windows 10+ (con WSL 1, WSL 2, o Git para Windows)
- Hardware: 4GB+ RAM
- Software: Node.js 18+
- Red: Conexión a Internet requerida para autenticación y procesamiento de IA
- Shell: Funciona mejor en Bash, Zsh o Fish
- Ubicación: Países compatibles con Anthropic
Instalación estándar
To install Claude Code, run the following command:
NO uses sudo npm install -g
ya que esto puede llevar a problemas de permisos y riesgos de seguridad.
Si encuentras errores de permisos, consulta configurar Claude Code para soluciones recomendadas.
Algunos usuarios pueden ser migrados automáticamente a un método de instalación mejorado.
Ejecuta claude doctor
después de la instalación para verificar tu tipo de instalación.
Después de que el proceso de instalación se complete, navega a tu proyecto e inicia Claude Code:
Claude Code ofrece las siguientes opciones de autenticación:
- Consola de Anthropic: La opción predeterminada. Conéctate a través de la Consola de Anthropic y completa el proceso OAuth. Requiere facturación activa en console.anthropic.com.
- Aplicación Claude (con plan Pro o Max): Suscríbete al plan Pro o Max de Claude para una suscripción unificada que incluye tanto Claude Code como la interfaz web. Obtén más valor al mismo precio mientras administras tu cuenta en un solo lugar. Inicia sesión con tu cuenta de Claude.ai. Durante el lanzamiento, elige la opción que coincida con tu tipo de suscripción.
- Plataformas empresariales: Configura Claude Code para usar Amazon Bedrock o Google Vertex AI para implementaciones empresariales con tu infraestructura de nube existente.
Claude Code almacena de forma segura tus credenciales. Consulta Gestión de Credenciales para más detalles.
Configuración de Windows
Opción 1: Claude Code dentro de WSL
- Tanto WSL 1 como WSL 2 son compatibles
Opción 2: Claude Code en Windows nativo con Git Bash
- Requiere Git para Windows
- Para instalaciones portátiles de Git, especifica la ruta a tu
bash.exe
:
Métodos de instalación alternativos
Claude Code ofrece múltiples métodos de instalación para adaptarse a diferentes entornos.
Si encuentras algún problema durante la instalación, consulta la guía de solución de problemas.
Ejecuta claude doctor
después de la instalación para verificar tu tipo de instalación y versión.
Instalación global de npm
Método tradicional mostrado en los pasos de instalación anteriores
Instalación de binario nativo (Beta)
Si tienes una instalación existente de Claude Code, usa claude install
para iniciar la instalación de binario nativo.
Para una instalación nueva, ejecuta el siguiente comando:
macOS, Linux, WSL:
Windows PowerShell:
El instalador nativo de Claude Code es compatible con macOS, Linux y Windows.
Asegúrate de eliminar cualquier alias o enlace simbólico desactualizado.
Una vez que tu instalación esté completa, ejecuta claude doctor
para verificar la instalación.
Instalación local
- Después de la instalación global vía npm, usa
claude migrate-installer
para mover a local - Evita problemas de permisos del actualizador automático de npm
- Algunos usuarios pueden ser migrados automáticamente a este método
Ejecutar en AWS o GCP
Por defecto, Claude Code usa la API de Anthropic.
Para detalles sobre ejecutar Claude Code en AWS o GCP, consulta integraciones de terceros.
Actualizar Claude Code
Actualizaciones automáticas
Claude Code se mantiene automáticamente actualizado para asegurar que tengas las últimas características y correcciones de seguridad.
- Verificaciones de actualización: Realizadas al inicio y periódicamente mientras se ejecuta
- Proceso de actualización: Descarga e instala automáticamente en segundo plano
- Notificaciones: Verás una notificación cuando las actualizaciones se instalen
- Aplicar actualizaciones: Las actualizaciones toman efecto la próxima vez que inicies Claude Code
Deshabilitar actualizaciones automáticas: