Domina Claude Code — De cero a 10x — 1. Descubre Claude Code e instálalo

17 min read min de lecture
Capítulo 01

Descubre Claude Code e instálalo

Capítulo 1 de 10 · 10%

Objetivos de este capítulo

  • Entender qué distingue a Claude Code de un simple autocompletado
  • Instalar la herramienta y lanzar tu primera sesión
  • Elegir entre la extensión de VS Code y la terminal

Por qué Claude Code cambia las reglas del juego

La mayoría de las herramientas de IA para código se limitan a completar una línea. Escribes el inicio de una función y la herramienta adivina el resto. Es útil, pero es asistencia pasiva: toda la inteligencia de la orquestación — qué hacer, en qué orden, cómo verificar — sigue en tu cabeza. Claude Code hace otra cosa: es un agente. Lee tus archivos, ejecuta comandos en tu terminal, escribe código, lanza tests y razona en varias etapas para alcanzar un objetivo que le das en lenguaje natural.

La diferencia es fundamental. Un chatbot clásico te responde con texto que debes copiar y pegar tú mismo. Un autocompletado te propone la línea siguiente. Claude Code, en cambio, actúa: si le pides «corrige el bug en el script de publicación», va a buscar el archivo en cuestión, leer el código, entender el error, proponer una corrección, aplicarla y volver a lanzar el script para verificar que funciona. Tú supervisas. Es el paso del rol de ejecutor al de director.

Para Lea, eso significa que no va a «pedir trozos de texto» a una IA. Va a confiarle una misión completa — «publica este tema en mis 4 redes» — y Claude lo orquesta todo: investigación, redacción, visual, publicación. Y como vas a descubrir, lo que hace esta aproximación realmente poderosa es que se capitaliza: cada automatización construida queda disponible para siempre.

El bucle agéntico: leer, ejecutar, escribir, razonar

Bajo el capó, Claude Code funciona en bucle: observa el estado de tu proyecto, decide una acción, la ejecuta, observa el resultado y decide el siguiente paso. Este bucle continúa hasta que el objetivo se alcanza — o hasta que te necesita para decidir. Es exactamente como delegar en un colaborador: das la misión y las restricciones, y él gestiona las etapas intermedias.

flowchart LR
  U["Tú: misión en lenguaje natural"] --> C["Claude Code"]
  C --> L["Lee tus archivos"]
  C --> X["Ejecuta comandos"]
  C --> W["Escribe código"]
  L --> R["Razona y encadena las etapas"]
  X --> R
  W --> R
  R --> OK["Objetivo alcanzado"]
Un agente: una misión como entrada, un bucle leer / ejecutar / escribir / razonar hasta el resultado.

Este bucle tiene una consecuencia práctica importante: la calidad de lo que obtienes depende de la calidad de la misión que das. «Escríbeme un post» producirá un resultado mediocre. «Escribe un post de LinkedIn de 150 palabras sobre el residuo cero, tono cálido, terminado con una pregunta abierta» producirá algo utilizable. Todo este curso te enseña a codificar esas precisiones de una vez por todas, en lugar de reescribirlas cada vez.

El objetivo del curso — pasar de «he oído hablar de la IA» a «la IA me ahorra varias horas cada semana», con frameworks que reutilizas infinitamente.

Instalar Claude Code

Claude Code se instala vía npm, el gestor de paquetes de Node.js. Necesitas por tanto Node.js 18 o superior — si no lo tienes, descarga la versión LTS desde el sitio oficial de Node.js, la instalación toma dos minutos. Después, abre una terminal y ejecuta:

bash
# Verificar que Node.js está instalado (18+ requerido)
node --version

# Instalar Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Situarse en la carpeta de tu proyecto
cd mi-proyecto

# Lanzar Claude Code
claude

En el primer arranque, Claude Code te pide conectarte a tu cuenta de Anthropic. Dos opciones: una suscripción Claude (Pro o Max), o una clave API de la consola de Anthropic facturada por uso. Para empezar, la suscripción es más simple: una cuota mensual previsible, sin sorpresas. Una vez autenticado, estás listo.

En Windows, Claude Code funciona nativamente en PowerShell, pero muchos usuarios prefieren lanzarlo en WSL (Windows Subsystem for Linux) o Git Bash para aprovechar un entorno de comandos Unix más estándar. Si un comando de shell se comporta de forma extraña, esa es la primera pista a verificar.

Lanza siempre claude desde la carpeta de tu proyecto, no desde tu carpeta personal. Claude Code toma la carpeta actual como raíz de trabajo: ahí es donde lee los archivos, y ahí buscará tu configuración (.claude/, CLAUDE.md) en los próximos capítulos.

Tu primera sesión

Una vez en la sesión, hablas con Claude en lenguaje natural, como con un colega. Pero algunos comandos integrados — los que empiezan por / — merecen conocerse desde el primer día:

  • /help — lista todos los comandos disponibles.
  • /init — analiza tu proyecto y genera un primer archivo CLAUDE.md (la memoria de proyecto, le dedicamos el capítulo 8).
  • /clear — borra la conversación para empezar de nuevo con un contexto limpio.
  • /model — muestra y cambia el modelo utilizado.
  • Esc — interrumpe a Claude en plena acción si ves que va en la dirección equivocada.
  • @ruta/archivo — referencia un archivo concreto en tu mensaje para que Claude lo lea.

Tómate cinco minutos para jugar: pídele «lista los archivos de esta carpeta y describe lo que entiendes del proyecto». Verás la mecánica en directo: propone ejecutar un comando, te pide permiso, lo ejecuta, lee el resultado y te hace una síntesis. Esta petición de permiso sistemática puede parecer pesada — ese es justamente el tema del capítulo 2.

¿Extensión de VS Code o terminal?

Claude Code funciona de dos maneras en VS Code: la extensión oficial (interfaz en la barra lateral) o la terminal integrada (comando claude). Ambas ejecutan exactamente el mismo motor — la diferencia es puramente ergonómica.

Extensión VS Code (recomendada)Interfaz limpia y guiada, diffs visuales de las modificaciones, ideal para el 99% de la gente. Cubre todo lo que abarca este curso.
TerminalModo Vim para editar más rápido, scriptable, y opciones avanzadas como el modo navegador que permite a Claude probar tus apps web. Para usuarios cómodos con la línea de comandos.
Todo este curso funciona de forma idéntica en la extensión y en la terminal. Empieza por la extensión si eres principiante: verás las modificaciones de archivos como diffs coloreados, lo que ayuda enormemente a entender lo que Claude hace.

¿Qué modelo usar?

Claude Code te deja elegir el modelo vía /model. La regla simple: usa el modelo más capaz disponible para casi todo — razonamiento técnico, creación de skills, integraciones de API, depuración. Estas tareas exigen mantener un razonamiento a lo largo de muchas etapas, y ahí es exactamente donde los modelos más potentes marcan la diferencia.

Reserva los modelos más ligeros (y más baratos) para las tareas simples y repetitivas: reformatear un archivo, renombrar variables, generar variantes de un texto ya validado. Para este curso, mantén el modelo más potente en todo — la orquestación y la coordinación de subagentes se benefician directamente. Un error de razonamiento en medio de una cadena de 10 etapas cuesta mucho más en tiempo que la diferencia de precio entre dos modelos.

Lo que vas a construir en este curso

Cada capítulo añade un ladrillo al sistema de Lea. Capítulo 2: los ajustes que hacen el trabajo fluido. Capítulo 3: una primera skill /post que publica en una red. Capítulo 4: la voz de marca para que los posts suenen humanos. Capítulo 5: un hook que bloquea toda publicación no conforme. Capítulo 6: subagentes que publican en 4 redes en paralelo. Capítulo 7: el comando capstone /plan-week que programa una semana entera. Capítulo 8: la memoria de proyecto que hace que todo sobreviva de una sesión a otra.

El orden no es casual: es la progresión natural de toda automatización seria. Primero hacer que funcione una vez (skill), luego hacerlo fiable (hook), luego escalar (subagentes), luego capitalizar (memoria). Podrás repetir exactamente esta secuencia en cualquier otro proyecto — contabilidad, soporte al cliente, vigilancia competitiva.

🛠️ Te toca a ti

Contexto

Empiezas el proyecto de Lea. Antes de escribir la menor automatización, debes tener un entorno funcional y entender, viéndolo en acción, qué distingue a un agente de un chatbot. También es el momento de verificar que tu autenticación y tus herramientas básicas están en su sitio — todo el resto del curso se apoya en ello.

Instrucciones

  1. Instala Node.js 18+ si aún no lo tienes (node --version para verificar), luego instala Claude Code con npm install -g @anthropic-ai/claude-code.
  2. Crea una carpeta marketing-ia y lanza claude dentro.
  3. Conéctate a tu cuenta de Anthropic cuando la herramienta te lo pida.
  4. Pídele a Claude: «preséntate y dime qué puedes hacer en esta carpeta».
  5. Pídele crear un archivo README.md describiendo el proyecto de Lea, y observa la petición de permiso y luego el diff.
  6. Escribe /help y recorre la lista de comandos integrados.
  7. Anota la diferencia con un simple chatbot: tiene acceso a tus archivos y a tu terminal, y encadena las acciones por sí solo.
Pista — Si el comando claude no se encuentra, verifica que la carpeta global de npm está en tu PATH (npm config get prefix te da su ubicación), o simplemente reinicia tu terminal.

En resumen

  • Claude Code es un agente: lee, ejecuta, escribe y razona en bucle a lo largo de varias etapas.
  • Un chatbot responde con texto; un agente actúa sobre tus archivos y tu terminal bajo tu supervisión.
  • Instalación con un comando npm (Node.js 18+ requerido), luego claude en tu proyecto.
  • Lanza siempre Claude Code desde la carpeta del proyecto: es su raíz de trabajo.
  • Comandos que debes conocer: /help, /init, /clear, /model, Esc para interrumpir.
  • La extensión de VS Code es adecuada para la mayoría; la terminal ofrece Vim y opciones avanzadas.
  • Usa el modelo más capaz para el trabajo técnico; los modelos ligeros para lo repetitivo.

Quiz — comprueba tu comprensión

1. ¿Qué distingue mejor a Claude Code de un autocompletado clásico?

Claude Code es un agente autónomo capaz de encadenar acciones, no solo de completar texto.

2. Para la mayoría de los usuarios, ¿qué interfaz se recomienda?

La extensión ofrece una interfaz guiada con diffs visuales que cubre todo el curso. La terminal sigue siendo una opción avanzada.

3. ¿Por qué hay que lanzar claude desde la carpeta de tu proyecto?

Claude Code toma la carpeta actual como raíz: ahí es donde lee tus archivos y tu configuración de proyecto.

4. ¿Qué tecla permite interrumpir a Claude en plena acción?

Esc interrumpe la acción en curso — indispensable cuando ves que Claude va en la dirección equivocada.

5. ¿Cuándo usar un modelo ligero en lugar del más capaz?

El razonamiento multi-etapas se beneficia del modelo más potente; lo repetitivo simple puede correr en un modelo ligero, más barato.

Auteur(s)

R

REHOUMA Haythem

Haythem Rehouma est un ingénieur et architecte IA et cloud, formateur et enseignant technique, avec un profil orienté IA médicale, AWS, MLOps, LLM/RAG et vision par ordinateur.