Guía de Claude Code CLI para principiantes: de la instalación a tu primera tarea de programación con IA
Lo que enseña este tutorial
Claude Code es el agente de codificación con IA de Anthropic que se ejecuta en tu terminal. Puede leer tu proyecto, editar archivos, ejecutar comandos y automatizar tareas de desarrollo, todo desde la línea de comandos. Al final de este tutorial, podrás instalar Claude Code, iniciar sesión y completar tu primera tarea de programación asistida por IA.
¿Qué versión cubre esta guía? Esta guía cubre únicamente Claude Code CLI, la versión que se ejecuta en la terminal. No cubre la aplicación de escritorio ni la versión web. Si prefiere la aplicación de escritorio con interfaz gráfica, consulte la guía de escritorio dedicada.
Tiempo necesario: 15–20 minutos
Dificultad: Principiante
Antes de empezar
| Requisito | Detalles |
|---|---|
| Sistema operativo | macOS 13 o posterior, Windows 10 1809 o posterior, o Linux (Ubuntu 20.04+, Debian 10+, Alpine 3.19+) |
| Cuenta | Una suscripción de Claude Pro, Max, Team o Enterprise, o una cuenta de Claude Console (pago por uso) |
| Terminal | PowerShell (Windows), Terminal (macOS) o tu terminal de Linux |
| Hardware | Al menos 4 GB de RAM |
| Coste | Suscripción de Claude (Pro desde $20/mes) o pago por uso de API |
¿Qué es una terminal? Una terminal (también llamada línea de comandos) es una ventana donde escribes comandos en lugar de hacer clic en botones. En Windows se llama PowerShell; en macOS se llama Terminal. Este tutorial usa comandos claude, que escribes en esta ventana y pulsas Enter.
¿Qué es Claude Code? Claude Code es un agente de codificación de Anthropic. Lee tus archivos, comprende cómo se conectan las partes de tu proyecto y puede editar varios archivos, ejecutar pruebas y corregir errores por sí mismo, después de pedirte permiso.
¿Qué es una clave API? Una clave API es un código secreto que identifica tu cuenta cuando pagas por uso. La generas una vez en la consola de Claude (console.anthropic.com). Trátala como una contraseña: nunca la compartas.
Cómo abrir tu terminal (paso a paso)
Si no sabes cómo abrir una terminal, sigue los pasos de tu sistema a continuación. La usarás para todos los comandos de este tutorial.
Windows — abrir PowerShell
- 1Haz clic en el botón Inicio (el logotipo de Windows) en la esquina inferior izquierda de la pantalla.
- 2Escribe
PowerShell: no necesitas hacer clic en nada primero, solo empieza a escribir. - 3Haz clic en la aplicación Windows PowerShell o Terminal que aparece en la lista.
- Windows 11 muestra Terminal; Windows 10 muestra Windows PowerShell. Cualquiera de las dos funciona.
- 1Si aparece una ventana azul de Control de cuentas de usuario, haz clic en Sí.
Cómo pegar un comando: haz clic con el botón derecho en cualquier lugar de la ventana de PowerShell para pegar (o pulsa Ctrl + V).
Descargar e instalar
Elige tu versión
| Versión | Ideal para | Notas |
|---|---|---|
| Instalador nativo (recomendado) | La mayoría de los usuarios | Totalmente probado, recomendado; se actualiza automáticamente en segundo plano |
| Homebrew | Usuarios de macOS que ya usan Homebrew | Gestión junto a otras apps; actualización manual |
| WinGet | Usuarios de Windows que ya usan WinGet | Gestor de paquetes de Windows; actualización manual |
¿Qué es Homebrew? Homebrew es un gestor de paquetes gratuito para macOS. Escribes brew install para instalar programas, como una tienda de aplicaciones para la línea de comandos. Solo elige esta opción si ya usas Homebrew.
¿Qué es WinGet? WinGet es el gestor de paquetes oficial integrado en Windows 10 y 11. Solo elige esta opción si ya lo usas.
Instalar en tu sistema
Selecciona tu sistema a continuación. Cada pestaña contiene los pasos completos para ese sistema operativo.
Instalación en Windows
- 1Abre PowerShell: haz clic en el botón Inicio (logotipo de Windows), escribe
PowerShelly haz clic en Windows PowerShell o Terminal. - 2Copia el comando siguiente, pégalo en la ventana de PowerShell y pulsa Enter:
irm https://claude.ai/install.ps1 | iex- 1Espera a que termine la instalación. Cuando puedas volver a escribir, verifica la instalación copiando y ejecutando este comando:
claude --versionSi ves un número de versión seguido de (Claude Code) (por ejemplo, 2.1.211 (Claude Code)), la instalación se ha completado.
Usar CMD en lugar de PowerShell: si tu terminal muestra C:\ sin PS al principio de la línea, estás en CMD. Ejecuta este comando en su lugar:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdSi ves The token '&&' is not a valid statement separator, estás en PowerShell: usa el comando irm de arriba. Si ves 'irm' is not recognized as an internal or external command, estás en CMD: usa el comando curl de arriba.
Actualizar Claude Code: las instalaciones nativas se actualizan automáticamente. Para comprobar actualizaciones de inmediato, ejecuta:
claude updateOpcional — WinGet: si prefieres el gestor de paquetes WinGet:
winget install Anthropic.ClaudeCodeActualízalo con:
winget upgrade Anthropic.ClaudeCodeIniciar sesión
- 1Abre una terminal y ve a la carpeta de tu proyecto (sustituye
path/to/your/projectpor la ruta de tu propia carpeta):
cd path/to/your/project- 1Inicia Claude Code:
claude- 1La primera vez se te pedirá que inicies sesión. Se abrirá automáticamente una ventana del navegador:
- Inicia sesión con tu cuenta de Claude — usa tu suscripción Pro, Max, Team o Enterprise. Tras iniciar sesión, el navegador devuelve tus credenciales a Claude Code automáticamente.
- Usa la consola de Claude (API) — si prefieres el pago por uso, inicia sesión con tu cuenta de Console.
- 1Tras iniciar sesión, verás el prompt de Claude Code, listo para tu primera tarea. Tu sesión se guarda, así que no necesitarás volver a iniciar sesión.
Nota: el plan gratuito de Claude.ai no incluye Claude Code. Necesitas una suscripción de pago o una cuenta de Console.
Solución de problemas de instalación
| Error | Causa | Solución | |
|---|---|---|---|
claude: command not found | La carpeta de instalación no está en tu PATH | Consulta la solución paso a paso de tu sistema más abajo | |
'irm' is not recognized as an internal or external command | Ejecutaste el comando de PowerShell en CMD | Usa el comando de instalación de CMD (curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd) | |
The token '&&' is not a valid statement separator | Ejecutaste el comando de CMD en PowerShell | Usa el comando de instalación de PowerShell (`irm https://claude.ai/install.ps1 \ | iex`) |
syntax error near unexpected token '<' o HTTP 403 durante la instalación | Restricción de red, o el comando se pegó en la terminal equivocada | Comprueba tu conexión a internet, asegúrate de que claude.ai sea accesible y reinténtalo en el tipo de terminal correcto | |
| La página de inicio de sesión del navegador no se abre | Restricciones de red o proxy | Comprueba tu conexión y vuelve a intentarlo. Si usas una VPN o proxy, prueba a apagarlo o cambiar de servidor | |
Login expired · Please run /login | Tu sesión guardada ha caducado | Ejecuta claude y escribe /login dentro de la sesión para volver a iniciar sesión |
Solución para "claude: command not found" — Windows:
- 1Pulsa la tecla de Windows, escribe
environment variablesy haz clic en Editar las variables de entorno del sistema. - 2Haz clic en el botón Variables de entorno....
- 3En la lista inferior (variables del sistema), busca Path, selecciónala y haz clic en Editar....
- 4Haz clic en Nuevo, añade la carpeta donde se instaló Claude Code (por defecto:
C:\Users\<tu nombre de usuario>\.local\bin) y haz clic en Aceptar en todas las ventanas. - 5Cierra PowerShell por completo y vuelve a abrirlo, y luego ejecuta
claude --version.
Solución para "claude: command not found" — macOS/Linux:
- 1Abre Terminal y copia y ejecuta este comando:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc- 1Recarga la configuración:
source ~/.zshrc- 1Si usas Bash en lugar de Zsh, usa
~/.bashrcen los dos comandos anteriores. - 2Ejecuta
claude --versionpara confirmar.
Tu primera tarea
Paso 1: Abre un proyecto
Ve a la carpeta del proyecto en la que quieres que trabaje Claude Code (sustituye la ruta por la tuya):
cd path/to/your/projectAhora deberías ver la ruta de la carpeta en el prompt de tu terminal.
Paso 2: Inicia Claude Code
claudeClaude Code se inicia y muestra su prompt con la versión, el modelo actual y la carpeta en la que estás trabajando.
Paso 3: Haz tu primera pregunta
Escribe esta solicitud y pulsa Enter:
¿Qué hace este proyecto?Claude Code lee los archivos del proyecto y explica lo que encuentra. Prueba algunas más:
¿Qué tecnologías usa este proyecto?— identifica las tecnologías del proyecto¿Dónde está el punto de entrada principal?— encuentra el archivo principalExplica la estructura de carpetas— explica cómo están organizadas las carpetas
Paso 4: Haz tu primer cambio de código
Escribe esta solicitud y pulsa Enter:
Añade una función hello world al archivo principalClaude Code encuentra el archivo correcto, te muestra los cambios propuestos y pide tu aprobación. Esto es normal y seguro: tú decides lo que ocurre en tu máquina.
Paso 5: Aprueba o rechaza los cambios
Cuando Claude Code quiera editar archivos o ejecutar comandos, primero pedirá tu permiso. Escribe y y pulsa Enter para aprobar, o n para rechazar. Revisa cada cambio: tú mantienes el control.
También puedes pulsar Shift + Tab para cambiar entre modos de permisos:
- Modo predeterminado — Claude pregunta antes de cada cambio
- Modo acceptEdits — las ediciones de archivos se aprueban automáticamente (los comandos siguen preguntando)
- Modo plan — Claude solo propone un plan y no cambia nada
Paso 6: Sal de Claude Code
Cuando termines, escribe /exit y pulsa Enter, o pulsa Ctrl + D dos veces.
Comandos útiles
| Comando | Qué hace |
|---|---|
claude | Inicia una sesión interactiva |
claude "descripción de la tarea" | Inicia una sesión con una tarea única |
claude -p "consulta" | Ejecuta una consulta única y sale (ideal para scripts) |
claude -c | Continúa tu conversación más reciente en esta carpeta |
claude -r | Reanuda una conversación anterior |
claude update | Actualiza a la última versión |
claude doctor | Comprueba que tu instalación es correcta |
/help | Muestra todos los comandos disponibles (dentro de una sesión) |
/clear | Borra el historial de conversación (dentro de una sesión) |
/login | Cambia de cuenta o vuelve a iniciar sesión (dentro de una sesión) |
/usage | Muestra el uso y el coste de la sesión (dentro de una sesión) |
/exit o Ctrl + D dos veces | Salir de Claude Code |
Preguntas frecuentes
¿Necesito un plan de pago?
Sí. Claude Code requiere una suscripción de pago de Claude (Pro desde $20/mes facturado mensualmente, Max desde $100/mes, Team o Enterprise) o una cuenta de Claude Console con pago por uso de API. El plan gratuito de Claude.ai no incluye Claude Code. Consulta la página de precios oficial para conocer las opciones actuales.
¿Claude Code funciona fuera de un repositorio git?
Claude Code funciona mejor dentro de un proyecto Git. Si empiezas desde cero, crea primero un repositorio:
git init¿Claude Code puede ejecutar mi código?
Sí, con tu permiso. Claude Code puede ejecutar comandos de shell y pruebas en tu máquina, y siempre te muestra lo que va a ejecutar antes de pedir permiso. Usa los modos de permisos (Shift + Tab) para controlar lo que puede hacer sin preguntar.
¿Mi código se envía a Anthropic?
Cuando usas Claude Code, tus prompts y el contenido de tus archivos se procesan según los controles de datos de tu tipo de cuenta. Consulta la documentación de uso de datos de Anthropic para más detalles.
¿Qué es MCP?
MCP (Model Context Protocol) es una forma estándar de conectar Claude Code a herramientas y fuentes de datos externas, como bases de datos o servicios internos. Puedes añadir servidores MCP más tarde con /mcp dentro de una sesión: es una función avanzada, no necesaria para empezar.
Siguientes pasos
- Añade guía al proyecto: crea un archivo
CLAUDE.mden tu repositorio para dar a Claude Code instrucciones duraderas sobre tu proyecto. - Haz mejores preguntas: sé específico sobre lo que quieres: describe el objetivo y las restricciones en lugar de solo "arregla el error".
- Aprende los modos de permisos: usa
Shift + Tabpara alternar entre modos de pedir permiso y modos más autónomos a medida que ganes confianza. - Prueba Claude Code en otros lugares: Claude Code también está disponible como aplicación de escritorio, en VS Code y los IDE de JetBrains, y en la web.
- Conecta herramientas con MCP: usa
/mcppara dar a Claude Code acceso a datos y servicios externos.
