En el capítulo anterior dividimos las herramientas de coding con IA en tres tipos y, dentro de ellas, elegimos como protagonista de este curso a Claude Code, al que puedes delegar gran parte de la implementación. En este capítulo por fin ponemos manos a la obra. Recorreremos con cuidado toda la secuencia —instalar → arrancar → iniciar sesión → primera instrucción → aprobar los cambios—, punto por punto en los tropiezos más habituales, hasta que Claude Code empiece a funcionar en tu terminal.
La meta: «poner a Claude Code a hacer su primer trabajo en tu propio entorno»
Qué es Claude Code (repaso del capítulo anterior)
Dicho de nuevo en una frase, Claude Code es un «agente CLI» de Anthropic. En lugar de copiar y pegar código en un chat del navegador, lee, reescribe archivos, ejecuta comandos y corre pruebas directamente dentro de tu terminal, sobre tu proyecto. Con solo decirle «quiero que hagas esto» en tu idioma, la IA planifica por sí misma y avanza el trabajo a través de varios archivos. Es, literalmente, un compañero que se sienta a tu lado a trabajar contigo.
📖 Dos fuentes oficiales para leer primero. Los pasos de este capítulo son una guía de iniciación. Confirma siempre en la fuente primaria los requisitos exactos del sistema, la forma de instalación más reciente y los planes de precios: si marcas como favoritos la documentación oficial code.claude.com/docs y la página del producto anthropic.com/claude-code, te servirán durante mucho tiempo.
Instalarlo
Claude Code se instala y se usa sobre un entorno de Node.js. No requiere preparativos complicados. Empieza por tener a punto estos dos requisitos.
La base sobre la que corre Claude Code. Si aún no lo tienes, instala la versión LTS desde la web oficial nodejs.org. Para comprobar si ya lo tienes, si node -v muestra la versión, está listo.
La pantalla donde escribes comandos. En macOS, «Terminal»; en Windows, «PowerShell» o WSL; en Linux, el terminal estándar sirve. Basta con manejar las operaciones básicas que vimos en el capítulo anterior.
Cuando lo tengas preparado, escribe una línea con el siguiente comando en la terminal. Solo se trata de usar npm (la herramienta de gestión de paquetes que viene con Node.js) para instalar Claude Code de modo que puedas usarlo en todo el terminal.
npm install -g @anthropic-ai/claude-code
-g significa «instalar de forma global (es decir, que se pueda invocar desde cualquier carpeta)». Cuando termine, arráncalo con el siguiente comando.
claude
⚠️ Si aparece claude: command not found. La instalación fue bien, pero el comando no se reconoce: es uno de los tropiezos clásicos con los que choca antes que nada quien empieza. Casi siempre la causa está en la configuración del PATH de Node.js/npm, y las soluciones están claras. En el artículo sobre «command not found / error de instalación» tienes recopiladas las soluciones por sistema operativo.
Los requisitos concretos del sistema, los pasos recomendados por sistema operativo y los métodos de instalación alternativos varían según el entorno. Para la información más reciente y precisa, consulta siempre la documentación oficial code.claude.com/docs.
Primer arranque e inicio de sesión
Cuando arrancas por primera vez con claude, se te pedirá iniciar sesión (autenticarte) con tu cuenta de Anthropic. Basta con seguir las indicaciones en pantalla: en la mayoría de los casos se abre el navegador, inicias sesión ahí y, al completar la autenticación, vuelves a la terminal.
Escribe claude en la terminal. La primera vez aparece una pantalla para elegir el método de inicio de sesión.
Sigue las indicaciones e inicia sesión en tu cuenta de Anthropic desde el navegador. Al autorizar, la autenticación pasa.
Al volver a la terminal, aparece la pantalla a la espera de tu entrada. Esa es la puerta del diálogo. Ahora sí, toca dar instrucciones.
Para iniciar sesión hay dos vías: entrar con una suscripción de Claude con un plan aplicable, o entrar con una clave de API. Como qué opción puedes usar y cómo se generan los cargos dependen del plan, aquí no lo afirmamos de forma tajante. Confirma en la documentación oficial el método que corresponda a tu contrato.
🔑 Si no puedes iniciar sesión o sale un error de autenticación. El navegador no se abre, pegas el código y lo rechaza, se queda a medias: los temas de autenticación también son un tropiezo clásico. En el artículo sobre «error de inicio de sesión / autenticación» tienes recopiladas las soluciones según la causa. Si aun así no se resuelve, échale un vistazo al capítulo 5, «Salir de los atascos», que trata los bloqueos de forma sistemática.
Dar la primera instrucción: el bucle básico
Una vez autenticado, llega lo importante de verdad. Lo primero es arrancar Claude Code dentro de la carpeta del proyecto en el que quieres trabajar. Como Claude Code reconoce «la carpeta en la que estás» como objeto de trabajo, si te equivocas aquí acabarás tocando otro sitio.
cd my-project
claude
A partir de ahí, solo tienes que decirle sin más lo que quieres que haga, en tu idioma. Puedes pedírselo con palabras normales, como «lee el README y explícame qué hace este proyecto» o «añade un formulario de contacto a la página de inicio». Desde aquí, los siguientes 4 pasos son el bucle básico que repetirás sin parar.
Dile en tu idioma lo que quieres que haga. Cuanto más concreto y menos ambiguo, más se ajusta a tu objetivo.
La IA lee los archivos relacionados, traza el plan de qué cambiar y cómo, y se pone en marcha.
Se muestra qué líneas se reescriben y cómo, en forma de diff. En verde lo añadido, en rojo lo eliminado.
Si te convence, apruébalo y se aplica. Si no, recházalo, dile con palabras la corrección y que lo intente de nuevo.
La clave está en el «revisar el diff» del BUCLE 3. Antes de reescribir un archivo, Claude Code te muestra primero el diff que dice «voy a cambiar esto así» y solo lo aplica tras esperar tu aprobación. Leer aquí el contenido y juzgar si concuerda con tu intención es el papel humano. Como vimos en el capítulo anterior, leer el código que produce y discernir si está bien o mal es tarea tuya.
✅ Que tu primer movimiento sea «algo pequeño y comprobable». No pidas de entrada una reforma enorme; acostúmbrate con peticiones pequeñas cuyo resultado puedas verificar con los ojos, como «explica este archivo» o «añade una función pequeña». Cuando salga bien, ve ampliando poco a poco lo que delegas: ese es el truco para no dar rodeos.
La forma de pedir en sí (cuándo usar el «vibe coding», que delega a grandes rasgos, y cuándo el «desarrollo dirigido por especificación», que cierra la spec antes de construir) la profundizamos con calma en el capítulo 4, «Pedir bien». De momento, con que este bucle de 4 pasos gire, es suficiente.
Lo básico de los modos de permiso: delegar con seguridad
«¿No irá la IA a borrar archivos por su cuenta o a ejecutar comandos peligrosos?»: es una preocupación razonable. Claude Code está bien diseñado en ese aspecto y su mecánica intercala siempre una confirmación antes de operaciones con impacto, como editar archivos o ejecutar comandos. Eso son los modos de permiso.
El comportamiento se divide en varios niveles. Aquí quédate solo con el concepto, a grandes rasgos.
Pide confirmación en cada edición o ejecución de comando. Como apruebas una a una, es el más seguro. Empieza acostumbrándote con este.
Sin cambiar nada en realidad, le hace trazar solo el plan de «qué va a hacer». Útil cuando quieres fijar la estrategia antes de un trabajo grande.
Omite las confirmaciones de cada paso y avanza de forma automática un cierto rango de operaciones. Rápido, pero como revisas menos veces, con cuidado.
Un modo potente que se salta todas las confirmaciones. Para quien empieza, lo prudente es evitarlo. Los casos de uso y el peligro, en el aviso de abajo.
💡 «Como confirmar es un rollo, lo pongo todo en bypass»: prohibido. El modo que se salta todas las confirmaciones es potente, pero como contrapartida no puede frenar borrados o comandos indeseados. Si quieres seguridad con velocidad, la vía correcta no es saltar de golpe al bypass, sino preparar primero reglas de permiso que solo autoricen las operaciones de confianza. También existe la opción de aislar el trabajo y ejecutarlo con seguridad, el «sandbox».
Aquí basta con que te quedes con esto: «Claude Code no se desboca por su cuenta, intercala confirmaciones» y «ese comportamiento se ajusta con los modos». Para más detalle, puedes profundizar en artículos y guías específicos.
Las diferencias entre modos y cómo cambiarlos, en Los modos de permiso a fondo.
Cómo escribir reglas de permitir/denegar, en Reglas de permiso y ajustes.
La idea del sandbox, en Introducción al sandbox.
Lo básico de CLAUDE.md y los ajustes
Al usar Claude Code a fondo, empiezas a sentir que «repetir cada vez las mismas indicaciones es un fastidio». «Indenta con 2 espacios», «no toques esta carpeta», «responde en mi idioma»: pedir estas reglas comunes del proyecto una y otra vez es ineficiente.
Ahí entra en escena CLAUDE.md. Si dejas un archivo con este nombre en la raíz del proyecto, Claude Code lo lee automáticamente al arrancar y trabaja teniendo en cuenta las reglas escritas. Es, por así decirlo, el «manual de instrucciones de este proyecto» que le entregas a tu compañero.
# Sobre este proyecto
- Lenguaje: TypeScript / Framework: Next.js
- Escribe las respuestas y comentarios en español
- Indenta con 2 espacios
- No toques nada bajo src/legacy/
- Antes de commitear, pasa npm run lint
La clave es escribir «corto, concreto y solo lo que de verdad quieres que respete». Si es demasiado largo o ambiguo, paradójicamente se respeta peor. La forma adecuada de hacerlo crecer es empezar con unas pocas líneas e ir añadiendo lo que notes que «estás repitiendo cada vez».
💡 ¿Lo escribiste en CLAUDE.md pero no lo respeta? Lo habitual es que haya demasiadas reglas, que sean demasiado abstractas o que se contradigan. Las causas y cómo arreglarlo están recopilados en el artículo «Cuando las reglas de CLAUDE.md no surten efecto». Al conocer «los trucos para que surtan efecto», la precisión de la IA se estabiliza notablemente.
Los ajustes no se limitan a CLAUDE.md. También puedes afinar en detalle desde archivos de configuración las reglas de permiso de antes, la elección de modelo y otros comportamientos, pero eso puede esperar. Con solo «escribir unas líneas de reglas del proyecto en CLAUDE.md», la experiencia ya cambia.
- Claude Code es un agente CLI de Anthropic. Se instala en un entorno de Node.js con
npm install -g @anthropic-ai/claude-codey se arranca conclaude. - La primera vez, inicias sesión (te autenticas) con tu cuenta de Anthropic. Si te atascas, a los artículos de command not found / error de autenticación.
- Lo básico es el bucle pedir → planificar → revisar el diff → aprobar. Leer el diff y juzgar si está bien es tarea humana.
- Con los modos de permiso evitas que se desboque. Quien empieza debe evitar el bypass e ir ampliando lo que delega mientras confirma.
- Si escribes unas líneas de reglas del proyecto en CLAUDE.md, la IA las respeta más fácilmente.
Con esto, ya tienes a Claude Code funcionando en tu terminal y puedes encargarle su primer trabajo. En el siguiente capítulo 3, «Comparar y elegir herramientas», ordenaremos las diferencias con compañeros como Cursor, GitHub Copilot y Codex, y aprenderás a elegir según la situación.