Tutorial de Claude Code: instalación y primera tarea

Este tutorial de Claude Code te lleva desde cero hasta tu primera sesión funcionando: un comando de instalación, inicio de sesión con tu cuenta de Claude, una primera tarea en tu propio proyecto y el archivo CLAUDE.md, que hace que el agente recuerde las reglas del proyecto. Necesitas una terminal, cualquier proyecto con código y un plan de pago de Claude (Pro, Max, Team o Enterprise) o una cuenta de Claude Console con créditos de API. Todo lleva un cuarto de hora.

Lo escribo como usuario: gestiono esta web con Claude Code, desde el código hasta la publicación de los artículos. Todos los comandos de abajo salen de la documentación oficial.

Qué es Claude Code

Claude Code es el agente de programación de Anthropic, y funciona en la terminal. A diferencia de un chat, no se limita a responder: lee los archivos del repositorio, los edita, ejecuta comandos, escribe tests y hace commits. Tú describes lo que quieres conseguir y Claude busca por su cuenta los archivos adecuados y propone cambios.

El mismo motor funciona también fuera de la terminal: en VS Code y JetBrains, en la app de escritorio, en el navegador en claude.ai/code y en la app móvil. En este tutorial me quedo con la terminal, porque es donde más se ve.

Tutorial de Claude Code: instalación con un solo comando

El método recomendado es el instalador nativo, que se actualiza solo en segundo plano.

macOS, Linux y WSL:

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

Windows PowerShell:

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

Windows CMD:

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

El instalador no muestra el progreso. Cuando termine, abre una ventana nueva de la terminal y comprueba:

claude --version

Si ves un número de versión seguido de (Claude Code), todo funciona. Un mensaje de que claude no se reconoce suele significar que falta el directorio de instalación en el PATH; la documentación tiene una sección específica para eso.

Alternativas: brew install --cask claude-code en macOS y winget install Anthropic.ClaudeCode en Windows. Estos dos métodos no se actualizan solos. En Windows sin WSL conviene instalar Git for Windows para que Claude tenga acceso a Bash.

Inicio de sesión y primera sesión

Entra en el directorio del proyecto y arranca el agente:

cd /ruta/al/proyecto
claude

La primera vez, Claude Code te pedirá que inicies sesión en el navegador. Entras con una cuenta de Claude (plan Pro, Max, Team o Enterprise) o con una cuenta de Claude Console, es decir, acceso a la API con créditos de prepago. Las credenciales se guardan, así que solo lo haces una vez. Si tienes definida la variable ANTHROPIC_API_KEY, Claude te preguntará si quieres usarla y se saltará el inicio de sesión.

Una vez dentro, verás un prompt con el número de versión, el nombre del modelo y el directorio de trabajo. Escribe /help para ver los comandos disponibles.

La primera tarea

Empieza con preguntas antes de dejar que el agente cambie nada. Claude lee los archivos por sí mismo, no hace falta pegarlos:

¿qué hace este proyecto?
¿dónde está el punto de entrada principal?
explica la estructura de carpetas

Después, un cambio pequeño:

añade una función hello world al archivo principal

Claude encontrará el archivo adecuado y te mostrará un diff. Si te pide permiso, apruébalo. Lo que el agente tiene que preguntar lo decide el modo de permisos, que cambias con Shift+Tab. En las versiones más recientes el modo por defecto es el automático, en el que un modelo clasificador aparte revisa las acciones y bloquea solo las arriesgadas.

Git también lo manejas con frases:

¿qué archivos he cambiado?
haz un commit con un mensaje descriptivo
crea una rama feature/quickstart

CLAUDE.md, la memoria del proyecto

Cada sesión empieza con el contexto vacío. Para no explicar cada vez cómo se compila el proyecto y qué convenciones seguís, escríbelo en un archivo CLAUDE.md en la raíz del repositorio. Claude lo lee al empezar cada conversación.

Lo más rápido es empezar con el comando /init: Claude analiza el repositorio y genera un archivo con los comandos de build, los tests y las convenciones que descubra por su cuenta. Luego añades lo que no se puede deducir del código.

Qué conviene guardar ahí según la documentación:

• comandos que Claude no va a adivinar (build, tests, lint),
• reglas de estilo que se salen de lo habitual,
• normas del repositorio (nombres de ramas, convenciones de PR),
• decisiones de arquitectura y trampas propias del proyecto.

Qué no poner: lo que Claude ya deduce del código y generalidades del tipo «escribe código limpio». La documentación recomienda mantener el archivo por debajo de 200 líneas. Los archivos más largos consumen contexto y se respetan peor.

Algunos datos que te ahorrarán búsquedas:

• ~/.claude/CLAUDE.md son tus reglas personales para todos los proyectos, ./CLAUDE.md son las reglas del proyecto compartidas con el equipo y ./CLAUDE.local.md son notas privadas para un repositorio concreto (añádelo a .gitignore).
• El archivo puede incluir otros archivos con la sintaxis @ruta/al/archivo.
• Si el repositorio ya tiene un AGENTS.md para otros agentes, Claude Code lo leerá en lugar de CLAUDE.md.
• /context muestra qué archivos de memoria se han cargado.

Comandos que conviene conocer

Comando	Qué hace
claude	inicia una sesión interactiva
claude "tarea"	arranca directamente con una primera instrucción
claude -p "pregunta"	una consulta sin sesión, resultado en la terminal
claude -c	continúa la última conversación en este directorio
claude -r	elige una conversación anterior para retomarla
/init	genera un CLAUDE.md inicial
/clear	limpia el contexto entre tareas no relacionadas
/compact	resume la conversación para liberar contexto
/rewind (o Esc dos veces)	devuelve la conversación y los cambios en archivos a un punto elegido
/permissions	lista de herramientas de confianza, menos peticiones de permiso
Shift+Tab	cambia el modo de permisos, incluido el modo de planificación
/exit	salir

El modo -p es especialmente útil en scripts: cat error.log | claude -p "explica este error" envía el archivo directamente al modelo.

Cinco hábitos que marcan la diferencia

Casi todos los consejos de las buenas prácticas oficiales se reducen a una limitación: la ventana de contexto se llena rápido y, con ella, baja la calidad.

1. Primero explorar y planificar, luego programar. Para cambios grandes, activa el modo de planificación (Shift+Tab hasta que aparezca plan mode on). Claude lee archivos y propone un plan, pero no cambia nada hasta que lo apruebes. Para arreglos de una línea, el plan es una carga innecesaria.
2. Sé concreto. En lugar de «arregla el error de login», di cuál es el síntoma, dónde está probablemente la causa y qué significa «arreglado». Señala archivos con @nombre-de-archivo.
3. Dale al agente una forma de comprobar su trabajo. Tests, build, lint o una captura de pantalla para comparar. Sin eso, «parece terminado» es la única señal, y el tester acabas siendo tú.
4. Limpia el contexto. /clear entre tareas no relacionadas. Si ya has corregido a Claude dos veces en lo mismo, empieza de nuevo con un prompt mejor.
5. Deshaz sin miedo. Cada prompt crea un punto de control. Cuando un experimento no sale bien, /rewind restaura la conversación y los archivos. No sustituye a git, pero anima a probar cosas más atrevidas.

Preguntas frecuentes

¿Claude Code es gratis?

No. La documentación exige un plan de pago de Claude (Pro, Max, Team o Enterprise) o una cuenta de Claude Console, en la que pagas por tokens de API. Los precios actuales de los planes están en claude.com/pricing.

¿Claude Code funciona en Windows?

Sí, de forma nativa (PowerShell o CMD) y en WSL. En Windows nativo conviene tener Git for Windows, porque así el agente usa Bash; sin él, usa PowerShell.

¿Tengo que usar la terminal?

No. El mismo agente está disponible como extensión para VS Code y JetBrains, como app de escritorio y como versión web. Los archivos CLAUDE.md, los ajustes y los servidores MCP funcionan igual en todas estas superficies.

¿En qué se diferencia Claude Code del chat de Claude?

El chat responde preguntas. Claude Code trabaja en tu repositorio: lee y edita archivos, ejecuta comandos y tests, hace commits y abre pull requests. Así que recibe una tarea, no una pregunta.