​
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 soportados

​
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

cd your-project-directory
3

Iniciar Claude Code

claude
4

Completar 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

claude
2

Ejecutar un comando simple

> summarize this project
3

Generar una guía de proyecto CLAUDE.md

/init
4

Confirmar el archivo CLAUDE.md generado

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

​
Solución de problemas

​
Solución de problemas de instalación WSL

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

Podrías encontrar los siguientes problemas en WSL:

Problemas de detección de SO/plataforma: Si recibes un error durante la instalación, WSL podría 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)

Errores de node no encontrado: Si ves exec: node: not found al ejecutar claude, tu entorno WSL podría 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 Linux o a través de nvm.

​
Optimizar la configuración de tu terminal

Claude Code funciona mejor cuando tu terminal está configurado correctamente. Sigue estas pautas para optimizar tu experiencia.

Shells soportados:

  • Bash
  • Zsh
  • Fish

​
Temas y apariencia

Claude no puede controlar el tema de tu terminal. Eso es manejado por tu aplicación de terminal. Puedes hacer coincidir el tema de Claude Code con tu terminal durante la incorporación o en cualquier momento a través del comando /config

​
Saltos de línea

Tienes varias opciones para ingresar saltos de línea en Claude Code:

  • Escape rápido: Escribe \ seguido de Enter para crear una nueva línea
  • Atajo de teclado: Presiona Option+Enter (Meta+Enter) con la configuración adecuada

Para configurar Option+Enter en tu terminal:

Para Mac Terminal.app:

  1. Abre Configuración → Perfiles → Teclado
  2. Marca “Usar Option como Tecla Meta”

Para iTerm2 y terminal de VSCode:

  1. Abre Configuración → Perfiles → Teclas
  2. Bajo General, establece la tecla Option Izquierda/Derecha a “Esc+”

Consejo para usuarios de iTerm2 y VSCode: Ejecuta /terminal-setup dentro de Claude Code para configurar automáticamente Shift+Enter como una alternativa más intuitiva.

​
Configuración de notificaciones

Nunca te pierdas cuando Claude completa una tarea con la configuración adecuada de notificaciones:

​
Notificaciones de campana del terminal

Habilita alertas de sonido cuando las tareas se completen:

claude config set --global preferredNotifChannel terminal_bell

Para usuarios de macOS: No olvides habilitar los permisos de notificación en Configuración del Sistema → Notificaciones → [Tu Aplicación de Terminal].

​
Notificaciones del sistema iTerm 2

Para alertas de iTerm 2 cuando las tareas se completen:

  1. Abre las Preferencias de iTerm 2
  2. Navega a Perfiles → Terminal
  3. Habilita “Silenciar campana” y Filtrar Alertas → “Enviar alertas generadas por secuencia de escape”
  4. Establece tu retraso de notificación preferido

Ten en cuenta que estas notificaciones son específicas de iTerm 2 y no están disponibles en el Terminal predeterminado de macOS.

​
Manejo de entradas grandes

Cuando trabajas con código extenso o instrucciones largas:

  • Evita el pegado directo: Claude Code puede tener dificultades con contenido pegado muy largo
  • Usa flujos de trabajo basados en archivos: Escribe el contenido en un archivo y pide a Claude que lo lea
  • Ten en cuenta las limitaciones de VS Code: El terminal de VS Code es particularmente propenso a truncar pegados largos

​
Modo Vim

Claude Code soporta un subconjunto de combinaciones de teclas de Vim que pueden habilitarse con /vim o configurarse a través de /config.

El subconjunto soportado incluye:

  • Cambio de modo: Esc (a NORMAL), i/I, a/A, o/O (a INSERT)
  • Navegación: h/j/k/l, w/e/b, 0/$/^, gg/G
  • Edición: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (repetir)