Aprende desde cero · Guía 1

Claude Code en tu terminal

Cómo instalarlo, cómo arrancarlo y qué pedirle la primera vez. Paso a paso, en Windows, Mac o Linux, aunque no hayas abierto nunca una terminal.

Comandos comprobados en la documentación oficial28-oct-2026Claude Code 2.1.312

Antes de empezar

Una cuenta de Claude de pago: Pro, Max, Team o Enterprise (o una cuenta de la Console con API).El plan gratis no incluye Claude Code.
Windows 10 o superior, macOS 13 o superior, o Linux (Ubuntu 20.04+, Debian 10+).Con 4 GB de RAM basta. Hace falta internet.
Estar en un país donde Claude funcione.Consulta la lista oficial de países.
Unos minutos y ganas de copiar y pegar.No necesitas saber programar.

Abre la terminal

Pulsa la tecla Windows, escribe PowerShell y pulsa Enter. Se abre una ventana con algo como PS C:\Users\tunombre>. No hace falta abrirla como administrador.

Pulsa Cmd + Espacio, escribe Terminal y pulsa Enter.

La terminal es una ventana donde escribes órdenes en vez de hacer clic. Para pegar en ella: clic derecho o Ctrl + V.

Instala Claude Code

Copia este comando, pégalo en la terminal y pulsa Enter.

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.sh | bash

No sale barra de progreso mientras descarga. Espera a que vuelva a aparecer la línea para escribir.

Si te sale «'irm' no se reconoce»

Estás en CMD (la línea empieza por C:\ sin PS). Abre PowerShell como en el paso 1, o usa este comando, que es el de CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Opcional: si instalas Git para Windows, Claude podrá usar Git Bash. Sin él funciona igual, con PowerShell.

Comprueba que está instalado

Cierra la terminal, abre una nueva y escribe:

claude --version

Si sale un número, como 2.1.312 (Claude Code), ya lo tienes. Si dice que no reconoce claude, mira «Si algo falla» al final.

Crea una carpeta de pruebas

Claude trabaja dentro de la carpeta desde la que lo abres. Para la primera vez, mejor una carpeta vacía. Escribe estas dos órdenes, una detrás de otra:

mkdir pruebas-claude

cd pruebas-claude

La primera crea la carpeta y la segunda te mete dentro.

Arráncalo e inicia sesión

claude

La primera vez te hace unas preguntas de configuración, como qué colores prefieres. Elige lo que quieras.

Después se abre el navegador para que entres con tu cuenta de Claude. Si no se abre solo, copia el enlace que aparece en la terminal y pégalo en el navegador.

Al final te pregunta si confías en los archivos de esa carpeta. Como la acabas de crear tú, sí.

Pídele algo

Se escribe como en un chat, en español normal, y se envía con Enter. Prueba con una de estas:

Crea un archivo lista-compra.txt con lo que necesito para una tortilla de patatas para 4 personas.
Hazme una página web sencilla con un temporizador de 25 minutos y dime cómo abrirla.
Explícame qué archivos hay en esta carpeta y para qué sirve cada uno.

En las versiones recientes arranca en modo automático: hace la tarea sin pedirte permiso en cada paso, y otro modelo revisa en segundo plano lo que va a hacer y frena lo arriesgado. Si prefieres que te pregunte antes de cada cambio, cambia de modo. Te lo enseño justo aquí debajo.

Para ir un paso más allá

Elige cuánto te pregunta

Claude tiene cinco modos. Cambian una sola cosa: cuánto hace por su cuenta antes de pedirte permiso. Se cambian con Mayús + Tab mientras lo usas, o al arrancar con la orden de cada tarjeta.

Plan

Investiga y te propone un plan. No toca nada hasta que lo apruebas.

claude --permission-mode plan

Lo mejor para tareas grandes y para tus primeras veces

Manual

Lee sin preguntar, pero te pide permiso antes de casi cualquier cambio u orden.

claude --permission-mode manual

Para aprender viendo cada paso que da

Aceptar cambios

Edita archivos y crea, mueve o copia dentro de tu carpeta sin preguntar. Para lo demás, pregunta.

claude --permission-mode acceptEdits

Cuando ya te fías de lo que hace en esa carpeta

Automático

Lo hace todo sin preguntar y otro modelo revisa cada acción en segundo plano. Es el modo con el que arranca.

claude --permission-mode auto

El de serie. Cómodo para el día a día

Saltar permisos

No pregunta nada y nadie revisa. Si se equivoca, o si un texto trampa le engaña, lo ejecuta igual.

claude --dangerously-skip-permissions

Evítalo en tu ordenador. Solo para entornos aislados, como una máquina virtual

Órdenes para arrancar

Se escriben en la terminal en lugar de claude a secas. Puedes juntarlas: claude -c --permission-mode plan.

claude

Abre Claude en la carpeta donde estás.

Lo de siempre.

claude "explícame qué hay aquí"

Arranca y le pide eso nada más abrir.

Para ir al grano.

claude -c

Sigue con la última conversación de esta carpeta.

Cerraste y quieres seguir donde lo dejaste.

claude -r

Te enseña tus conversaciones anteriores para elegir una.

Para retomar algo de otro día.

claude -n "viaje-roma"

Le pone nombre a la conversación. Vuelves a ella con claude -r "viaje-roma".

Proyectos que duran varios días.

claude --model sonnet

Elige el modelo: sonnet, opus, haiku o fable. No todos gastan igual de tu límite. Dentro, /model te los enseña.

Cuando quieres probar otro.

claude -p "resume esto en 3 frases: ..."

Contesta en la terminal y se cierra, sin conversación.

Una pregunta rápida.

claude --add-dir ../Descargas

Le deja trabajar también con otra carpeta.

Cuando necesita archivos de otro sitio.

Lo que te recomiendo

Para empezarclaude tal cual, en tu carpeta de pruebas, y mira lo que hace.
Para algo grandeModo plan. Lees el plan, le corriges lo que no te guste y luego lo aceptas.
Para seguir otro díaclaude -c, o ponle nombre con -n desde el principio.
Nunca--dangerously-skip-permissions en tu ordenador de diario.

Lo básico para manejarte

`Esc`	Para a Claude mientras trabaja. Útil si ves que se va por otro lado.
`Mayús` + `Tab`	Cambia de modo mientras lo usas: manual, aceptar cambios, plan y automático. Los tienes explicados arriba.
`/clear`	Empieza una conversación nueva, desde cero.
`claude -c`	Escrito al abrir, sigue con la última conversación de esa carpeta. Dentro, `/resume` te deja elegir una anterior.
`@archivo`	Señala un archivo concreto en lo que le pides. Al escribir `@` te sugiere los que hay.
`/init`	Crea un archivo CLAUDE.md con notas sobre tu proyecto, que Claude lee cada vez que lo abres ahí.
`/usage`	Cuánto llevas gastado del límite de tu plan.
`/help`	La lista de todos los comandos.
`/exit`	Salir. También vale pulsar `Ctrl` + `C` dos veces.

Se actualiza solo, así que no tienes que reinstalarlo nunca.

Para que no te la líen

Copia el comando de instalación solo de claude.ai o de la documentación oficial (code.claude.com). Si un anuncio, un vídeo o un mensaje te da otro comando u otra descarga, desconfía.
Ábrelo en carpetas concretas, como la de pruebas, y no en todo tu usuario o en el disco entero.
Lee lo que te pide antes de decir que sí, sobre todo si quiere borrar algo o ejecutar una orden que no entiendes. Puedes preguntarle «¿qué hace exactamente esto?» antes de aceptar.
No le pegues contraseñas ni datos bancarios.

Si algo falla

Dice que no reconoce «claude» o «command not found»

Cierra la terminal y abre una nueva: la que tenías abierta no se entera de la instalación. Si sigue igual, sigue la parte «Fix your PATH» de la guía oficial de problemas.

Sale «The token '&&' is not a valid statement separator»

Has pegado el comando de CMD en PowerShell. Usa el de PowerShell del paso 2.

No me deja entrar o me pide pagar

El plan gratis de Claude no incluye Claude Code. Necesitas Pro, Max, Team, Enterprise o una cuenta de la Console.

Otro error

Escribe claude doctor en la terminal: revisa la instalación y te dice qué falla y cómo arreglarlo. Si no lo entiendes, pregúntame.

¿Te ha servido?

¿Tienes una duda? Pregúntame y te contesto por correo.