Instalar Claude Code y hacer tu primera tarea

En unos 15 minutos vas a tener Claude Code instalado, con tu cuenta enlazada, y le habrás encargado una primera tarea real en modo plan: Claude lee tu proyecto, te propone qué va a cambiar y no toca nada hasta que tú lo apruebas. Es la forma más tranquila de empezar con un agente que edita archivos y ejecuta comandos en tu máquina.

Antes de empezar

• Un sistema compatible: macOS 13 o posterior, Windows 10 (1809) o posterior, o Linux reciente (Ubuntu 20.04+, Debian 10+), con al menos 4 GB de RAM.
• Una cuenta con acceso a Claude Code: un plan de pago de Claude (Pro, Max, Team o Enterprise) o una cuenta de Claude Console con créditos de API. Los precios, en claude.com/pricing.
• Una terminal abierta y una carpeta de proyecto con la que practicar. Mejor si está en git: así cualquier cambio se deshace con un comando.
• En Windows, conviene tener Git for Windows para que Claude Code pueda usar Bash; si no lo tienes, usa PowerShell.

1. Instala Claude Code

El instalador nativo es la opción recomendada porque se actualiza solo en segundo plano. Elige la línea de tu sistema:

# macOS, Linux o WSL (instalador nativo, recomendado)
$ curl -fsSL https://claude.ai/install.sh | bash
# Windows, en PowerShell
$ irm https://claude.ai/install.ps1 | iex
# Alternativas: Homebrew en macOS o WinGet en Windows (no se actualizan solas)
$ brew install --cask claude-code
$ winget install Anthropic.ClaudeCode
# Abre una terminal nueva y comprueba
$ claude --version
2.x.x (Claude Code)

Si claude --version responde con un número de versión, está instalado. Si la terminal dice que no encuentra claude, salta a «Si algo falla».

2. Inicia sesión

Entra en la carpeta de tu proyecto y arranca Claude Code:

cd ruta/a/tu/proyecto
claude

La primera vez te pide iniciar sesión y abre el navegador. Elige tu cuenta de Claude (la de tu suscripción) o tu cuenta de Console si pagas por API. Las credenciales quedan guardadas y no tendrás que repetirlo. Si algún día necesitas cambiar de cuenta, escribe /login dentro de la sesión.

Al arrancar verás la versión, el modelo activo y la carpeta de trabajo. Claude Code solo trabaja dentro de esa carpeta, por eso importa desde dónde lo lanzas. Si es la primera vez en ese proyecto, te preguntará si confías en la carpeta: acepta solo en proyectos que conozcas.

3. Tu primer encargo, en modo plan

Pulsa Shift+Tab hasta que la barra de estado muestre ⏸ plan mode on. También puedes arrancar directamente así: claude --permission-mode plan, o anteponer /plan a un solo mensaje. En modo plan, Claude lee archivos y explora, pero no edita tu código hasta que apruebes el plan.

4. Entiende los permisos

Claude Code funciona con modos de permiso que deciden qué puede hacer sin preguntarte. Los que vas a ver con Shift+Tab:

• Manual (default): solo lee sin preguntar; te pide permiso para editar o ejecutar comandos.
• Accept edits: edita archivos y hace operaciones de archivos comunes sin preguntar.
• Plan: investiga y propone; no edita hasta que apruebas.
• Auto: un segundo modelo clasificador revisa cada acción en tu lugar y bloquea lo que parece arriesgado.

Para tus primeras semanas, la combinación sensata es: modo plan para pensar, manual para ejecutar, y git siempre debajo como red de seguridad. Cuando confíes en cómo trabaja, prueba el modo auto en tareas largas. Evita bypassPermissions salvo en contenedores o máquinas aisladas.

Unos comandos que conviene tener a mano dentro de la sesión: /help (lista de comandos), /clear (empezar conversación nueva), /exit (salir). Desde la terminal, claude -c retoma la última conversación de esa carpeta y claude -r te deja elegir cuál.

Si quieres ir más allá de la instalación, la lección Claude Code: tu compañero programador en la terminal explica cómo trabajar con él día a día.

Si algo falla

• «command not found: claude» o «no se reconoce»: la carpeta de instalación no está en tu PATH. Cierra y abre la terminal; si sigue, sigue la sección «Fix your PATH» de la guía de problemas de instalación.
• Errores de sintaxis en Windows ('irm' is not recognized o The token '&&' is not a valid statement separator): estás en CMD en vez de PowerShell, o al revés. En PowerShell el prompt empieza por PS.
• No te deja iniciar sesión o entra con otra cuenta: si tienes la variable ANTHROPIC_API_KEY definida, Claude Code usará esa clave en lugar de tu suscripción. Quítala o usa /login para cambiar de cuenta.
• Algo raro en la configuración: ejecuta claude doctor desde la terminal. Muestra el estado de la instalación, errores en los archivos de ajustes y avisos con su solución, sin abrir sesión.