Verificar los requisitos del sistema

  • Sistemas Operativos: macOS 10.15+, Ubuntu 20.04+/Debian 10+, o Windows vía WSL
  • Hardware: 4GB RAM mínimo
  • Software:
    • Node.js 18+
    • git 2.23+ (opcional)
    • CLI de GitHub o GitLab para flujos de trabajo de PR (opcional)
  • Red: Conexión a Internet requerida para autenticación y procesamiento de IA
  • Ubicación: Disponible solo en países compatibles

Solución de problemas de instalación de WSL

Actualmente, Claude Code no se ejecuta directamente en Windows, y en su lugar requiere WSL. Si encuentras problemas en WSL:

  1. Problemas de detección de SO/plataforma: Si recibes un error durante la instalación, WSL puede estar usando npm de Windows. Intenta:

    • Ejecutar npm config set os linux antes de la instalación
    • Instalar con npm install -g @anthropic-ai/claude-code --force --no-os-check (NO uses sudo)
  2. Errores de Node no encontrado: Si ves exec: node: not found al ejecutar claude, tu entorno WSL puede estar usando una instalación de Windows de Node.js. Puedes confirmar esto con which npm y which node, que deberían apuntar a rutas de Linux que comiencen con /usr/ en lugar de /mnt/c/. Para solucionarlo, intenta instalar Node a través del administrador de paquetes de tu distribución de Linux o a través de nvm.

Instalar y autenticar

1

Instalar Claude Code

Install NodeJS 18+, then run:

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

Do NOT use sudo npm install -g as this can lead to permission issues and security risks. If you encounter permission errors, see configure Claude Code for recommended solutions.

2

Navegar a tu proyecto

bash cd tu-directorio-de-proyecto

3

Iniciar Claude Code

bash claude
4

Completar la autenticación

Claude Code ofrece múltiples opciones de autenticación: 1. 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. 2. 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. 3. Plataformas empresariales: Configura Claude Code para usar Amazon Bedrock o Google Vertex AI para implementaciones empresariales con tu infraestructura de nube existente.

Inicializar tu proyecto

Para usuarios primerizos, recomendamos:

1

Iniciar Claude Code

bash claude
2

Ejecutar un comando simple

bash resumir este proyecto
3

Generar una guía de proyecto CLAUDE.md

bash /init
4

Confirmar el archivo CLAUDE.md generado

Pide a Claude que confirme el archivo CLAUDE.md generado en tu repositorio.