Instalar y configurar Claude Code en 2026: guía completa para Windows, Mac y Linux

Requisitos previos

Antes de instalar Claude Code necesitas:

• Node.js 18+: Descárgalo desde nodejs.org. Recomendamos la versión LTS.
• Cuenta en Claude.ai con plan Pro o Team (Claude Code no está disponible en el plan gratuito)
• Un terminal: PowerShell en Windows, Terminal en Mac/Linux

Instalación

La instalación es global con npm:

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

Verifica que se instaló correctamente:

claude --version

Autenticación

Ejecuta el comando de login en tu terminal:

claude

La primera vez te pedirá autenticarte. Sigue las instrucciones en pantalla para vincular tu cuenta de Claude.ai. El token se guarda localmente y no necesitarás repetir este paso.

Tu primera sesión

Navega al directorio de tu proyecto:

cd mi-proyecto
claude

Claude Code leerá automáticamente el CLAUDE.md si existe, y estará listo para trabajar.

Comandos esenciales dentro de Claude Code

Una vez dentro de una sesión, estos son los comandos más útiles:

• /help — Muestra todos los comandos disponibles
• /clear — Limpia el contexto de la conversación (útil cuando cambias de tarea)
• /compact — Comprime el historial para liberar espacio de contexto
• /cost — Muestra cuántos tokens has usado en la sesión actual
• Ctrl+C — Interrumpe una tarea en curso
• Ctrl+L — Limpia la pantalla

Modos de trabajo

Modo interactivo (por defecto)

Lanzas claude y tienes una conversación continua con el agente. Puedes dar instrucciones en lenguaje natural y el agente las ejecuta.

Modo headless (para scripts)

Puedes pasar una instrucción directamente sin abrir el modo interactivo:

claude -p "Ejecuta los tests y dime si hay alguno que falla"

Esto es útil para integrarlo en scripts de CI/CD.

Configuración avanzada

El archivo settings.json

Claude Code se configura en ~/.claude/settings.json. Las configuraciones más útiles:

{
  "permissions": {
    "allow": [
      "Bash(npm run test)",
      "Bash(npm run build)",
      "Bash(git *)"
    ]
  }
}

Esto permite que Claude Code ejecute esos comandos sin pedirte confirmación cada vez.

Configuración por proyecto

Puedes tener un settings.json específico para cada proyecto en .claude/settings.json. Esto permite permisos diferentes según el proyecto.

Trucos que los usuarios avanzados usan

• Escribe el CLAUDE.md primero, antes de empezar a trabajar en cualquier proyecto. Te ahorrará tiempo en cada sesión.
• Usa /compact regularmente en sesiones largas para no quedarte sin contexto.
• Incluye mensajes de error completos cuando reportes bugs, no solo la descripción.
• Pide a Claude Code que haga commit después de cada feature funcional: "haz commit de lo que implementamos con un mensaje descriptivo".
• Cuando algo no sale bien, en lugar de corregirlo palabra por palabra, explica el objetivo final de nuevo.