Cómo usar Claude Code

Qué es Claude Code, y qué no es

Claude Code es Claude corriendo en tu terminal, con permiso para leer y escribir los archivos de tu proyecto. Esa es toda la diferencia, y es enorme.

Cuando usás Claude en el navegador, le pegás un pedazo de código, te responde, y vos copiás la respuesta de vuelta. Sos el cable entre los dos. Claude Code elimina ese cable: abre tus archivos, los edita, corre los comandos, ve los errores que salen y los arregla. Vos dejás de transcribir y pasás a dirigir.

Dos confusiones que vale la pena despejar de entrada:

No es un autocompletado. No es la cosa que te sugiere la línea siguiente mientras escribís. Le pedís una tarea entera —"agregá login con correo", "arreglá este bug", "migrá esto a la versión nueva"— y la ejecuta de punta a punta.

No es para programadores solamente. Sí ayuda saber programar, pero lo que separa a quien saca resultados de quien no, no es el nivel técnico. Es saber qué pedir y cómo verificarlo. Eso se aprende, y es de lo que trata el resto de esta guía.

---

El setup mínimo que casi todos se saltan

Instalarlo toma cinco minutos. Configurarlo bien toma veinte, y es la diferencia entre una herramienta que te sirve y una que te frustra.

1. Instalación

Se instala desde la terminal y se corre parándote dentro de la carpeta de tu proyecto. Está también en las extensiones de VS Code y JetBrains, en la app de escritorio y en el navegador. La terminal sigue siendo donde se siente mejor, porque es donde vive tu proyecto de verdad.

2. El archivo CLAUDE.md — este es el paso que cambia todo

En la raíz de tu proyecto creás un archivo llamado CLAUDE.md. Claude Code lo lee automáticamente al arrancar, en cada sesión, sin que se lo pidas.

Ahí adentro va lo que la IA no puede adivinar mirando el código:

• Qué es este proyecto y para quién
• Con qué está construido y por qué
• Cómo se corre, cómo se prueba, cómo se despliega
• Las reglas que no se rompen ("nunca hacer merge directo a main", "todo texto va en español", "no instalar librerías nuevas sin preguntar")
• Los errores que ya cometió antes y no querés que repita

Ese archivo es criterio en forma de texto. Sin él, cada sesión arranca de cero y la IA improvisa. Con él, arranca sabiendo cómo se trabaja acá.

Al final de esta página te dejo la plantilla lista para pegar en tu proyecto.

3. Los permisos

Claude Code pregunta antes de tocar archivos o correr comandos. Al principio eso cansa y la tentación es aprobar todo de una vez. No lo hagas todavía. Los primeros días miralo trabajar: ahí es donde entendés cómo piensa, qué hace bien y dónde se va por las ramas. Después automatizás lo que ya sabés que es seguro.

---

Por qué la mayoría lo usa mal

Acá está el corazón del asunto. La gente prueba Claude Code, saca algo impresionante el primer día, y a la semana lo abandona porque "se rompe todo". No es la herramienta. Son tres hábitos.

Error 1: pedir todo de una vez

El pedido típico es "hacéme una app de tareas con login, base de datos, notificaciones y modo oscuro". La IA lo intenta, porque siempre lo intenta. Te devuelve doscientos archivos que más o menos funcionan y que no entendés. Cuando algo falla, no sabés ni por dónde empezar a mirar.

La alternativa es aburrida y funciona: pedile una pieza que puedas verificar en dos minutos. Que corra. Que la mires. Recién entonces la siguiente. Vas más lento las primeras dos horas y muchísimo más rápido el resto de la semana.

Error 2: no darle contexto y culpar al prompt

Cuando el resultado sale genérico, el reflejo es reescribir el prompt con más adjetivos. Casi nunca es el prompt. Es que la IA no sabe nada de tu proyecto: no sabe que ya tenés una función que hace eso, que ese componente se usa en otras cuatro pantallas, que esa librería la sacaron el mes pasado a propósito.

Un CLAUDE.md bien escrito resuelve más problemas que cualquier truco de prompting. Es la misma idea de siempre: el resultado no sale del prompt, sale del criterio que le pasás como contexto.

Error 3: no verificar

Este es el caro. La IA te dice "listo, ya funciona" con total seguridad. Y a veces no funciona. No está mintiendo — está prediciendo texto plausible, y "listo, ya funciona" es exactamente lo que iría ahí.

La regla: si no lo viste correr, no está hecho. Abrí la página. Apretá el botón. Corré la prueba. Toma treinta segundos y te ahorra descubrir dentro de tres días que algo lleva roto desde el martes.

El patrón detrás de los tres

Los tres errores son el mismo error con distinta ropa: delegar sin dirigir. La IA es un ejecutor extraordinario y un decididor mediocre. Si le pasás las decisiones, te devuelve promedio. Si las tomás vos y le pasás la ejecución, te devuelve algo que parece hecho por alguien que sabe.

---

De demo a algo que sirve

Este es el salto que casi nadie hace, y es el único que importa si lo que querés es un proyecto real y no una captura de pantalla.

Una demo se ve bien. Un proyecto real tiene la plomería puesta:

El pago cobra de verdad. No un botón que dice "Comprar" y muestra un cartel de gracias. El cobro que llega a tu cuenta, con su confirmación, su correo y su registro de qué se vendió.

Sabés qué estás midiendo. Analítica instalada y verificada, con los eventos que importan disparando de verdad. Casi todo el mundo instala el código de medición y nunca comprueba que los eventos lleguen. Después mira un panel lleno de ceros y concluye que nadie entra.

Google la encuentra. Título propio en cada ruta, descripción, imagen para cuando la compartís, sitemap. Nada de eso rompe el sitio si falta. Solo hace que no exista.

No se ve hecha con IA. Las páginas de error, los estados vacíos, qué pasa cuando algo carga lento o falla. La IA no los hace porque no se los pediste, y son exactamente lo que delata que atrás no hubo nadie mirando.

Nada de esto lo resuelve un modelo mejor. El modelo que salga el mes que viene va a escribir mejor código y va a seguir sin saber que tu pasarela de pago necesita un webhook confirmado, porque eso no es un problema de código: es un problema de saber qué tiene que existir.

---

Cómo seguir

Si querés que la IA construya con criterio en lugar de improvisar, el orden es este:

1. Escribí tu CLAUDE.md una vez. Bajá la plantilla de acá abajo y completala.
2. Pedí de a una pieza verificable.
3. Verificá cada una antes de seguir.
4. Cuando funcione, ponele la plomería: cobro, medición, SEO, estados de error.

Los primeros tres los podés empezar hoy. El cuarto es el que separa un experimento de algo que se puede cobrar.