¿Qué es Claude Code? Definición, usos y ejemplos

Claude Code es el agente de programación de Anthropic: le describes una tarea en lenguaje normal y él lee tu repositorio, edita los ficheros que hagan falta, ejecuta los comandos y los tests, y te enseña los cambios para que los apruebes. Vive en tu terminal, en tu editor, en una app de escritorio y en el navegador.

Para seguir este post te basta con saber qué es un repositorio de git y cómo abrir una terminal. Nada más.

Cómo funciona Claude Code cuando le pides algo

Claude Code trabaja en ciclos: lee, decide, actúa y comprueba lo que ha hecho. Eso es un agente, y es la diferencia real con un chat normal. Un chat te devuelve texto y ahí acaba su trabajo; un agente tiene herramientas para tocar tu ordenador y las usa varias veces seguidas hasta terminar la tarea (ese bucle está explicado paso a paso en qué es un bucle agéntico).

Imagina que le dices: “el test del login está fallando, arréglalo”. Lo que ocurre después no es una respuesta, es una secuencia. Busca el fichero de tests. Lo abre y lo lee. Ejecuta la suite para ver el error de verdad en lugar de adivinarlo. Abre el código de autenticación, encuentra la línea culpable, la edita, y vuelve a lanzar los tests para confirmar que ahora pasan. Si sigue fallando, lo intenta otra vez con la información nueva.

Ese “vuelve a lanzar los tests” es lo importante. El modelo no solo escribe código, también recibe la salida real del terminal, así que puede darse cuenta de que se ha equivocado.

Por debajo hay un modelo de lenguaje, un LLM, que es el mismo tipo de tecnología que hay detrás de ChatGPT o de Claude (qué es un LLM, explicado sin tecnicismos). Lo que cambia no está en el modelo: está en lo que le dejas hacer.

Para qué sirve Claude Code: ejemplos de tareas reales

La documentación oficial de Anthropic lo plantea para dos cosas: construir funcionalidades y bajarse el trabajo repetitivo de desarrollo que nadie quiere hacer. En la práctica, los encargos que mejor le salen son los que tienen un final comprobable:

• Escribir los tests de un módulo que nadie testeó nunca, ejecutarlos y arreglar los que fallen.
• Explicarte un repositorio que acabas de heredar. Le preguntas “¿dónde se valida el pago?” y te lo busca y te lo cuenta, en vez de que te pases dos horas con el buscador del editor.
• Trabajo de git: prepara los cambios, escribe el mensaje del commit, crea la rama y abre la pull request.
• Tareas aburridas y masivas, del estilo de arreglar todos los errores de lint del proyecto o subir una dependencia que rompe cosas en quince sitios.

También se conecta a herramientas externas mediante MCP, un protocolo abierto para que un agente pueda leer y escribir en servicios que no son tu código, como Jira o Google Drive (qué es MCP y por qué importa). Y se le pueden empaquetar procedimientos repetibles en forma de skills, que son instrucciones guardadas que activa cuando vienen al caso.

Dónde se usa: terminal, VS Code, escritorio y navegador

Claude Code no es solo un programa de terminal, aunque ahí es donde nació. La documentación oficial de Anthropic lista cinco superficies: la CLI del terminal, la extensión de VS Code, el plugin para los IDEs de JetBrains, una app de escritorio para macOS y Windows, y el navegador desde claude.ai/code. Todas usan el mismo motor por debajo, así que tu configuración y tus servidores MCP funcionan igual en cualquiera de ellas.

Empezar por la terminal son cuatro líneas:

# 1. Instalas la herramienta (macOS, Linux o WSL)
curl -fsSL https://claude.ai/install.sh | bash

# 2. Entras en la carpeta de tu proyecto
cd mi-proyecto

# 3. Arrancas la sesión y a partir de aquí le hablas en lenguaje normal
claude

# 4. O le lanzas una tarea suelta sin abrir sesión, con la opción -p
claude -p "escribe los tests del módulo de login y ejecútalos"

El fichero CLAUDE.md que dejas en la raíz del proyecto es lo que Claude Code lee al empezar cada sesión: ahí escribes tus convenciones y lo que no se toca nunca.

Casi todas las superficies piden una suscripción de Claude o una cuenta de la consola de Anthropic, y los precios cambian a menudo, así que míralos en la web oficial antes de fiarte de cualquier artículo, incluido este.

Claude Code vs GitHub Copilot: la diferencia es el alcance

La diferencia principal es el tamaño de lo que le encargas. Copilot nació dentro del editor sugiriéndote la siguiente línea mientras escribes; a Claude Code le describes una tarea completa y decide él los pasos.

	Copilot en su modo clásico	Claude Code
Dónde vive	Dentro del editor, mientras tecleas	Terminal, editor, escritorio o navegador
Qué le pides	Que continúe la línea o la función que has empezado	”Arregla este bug y comprueba que los tests pasan”
Quién decide los pasos	Tú. Aceptas o rechazas cada sugerencia	El agente traza el plan y tú apruebas los cambios
Qué puede tocar	El fichero abierto	El repositorio entero, más los comandos que ejecutes tú a mano

Sé honesto con la comparación, porque la línea se está borrando: GitHub añadió a Copilot capacidades para planificar cambios y abrir pull requests, así que ya no es solo autocompletado. La distinción útil hoy no es “uno completa y el otro razona”, sino cuál de los dos usas por defecto y desde dónde. Si tu trabajo diario es teclear en el editor con ayuda, el autocompletado te sirve. Si lo que quieres es delegar una tarea entera y revisar el resultado, ahí es donde encaja un agente.

Claude Code, el chat de Claude y los Proyectos de Claude

Son tres productos distintos y se confunden constantemente. El chat de claude.ai es una conversación: le pegas código, te responde código, y copiar y pegar es cosa tuya. Claude Code tiene acceso a tus ficheros y ejecuta comandos, así que no hay copiar y pegar.

Los Proyectos de Claude son otra cosa: un espacio dentro de claude.ai donde subes documentos y fijas unas instrucciones, y todas las conversaciones que abras dentro los tienen en cuenta sin que tengas que repetirlos (qué es un Proyecto de Claude, con más detalle). Sirven para trabajo de conocimiento con documentación estable, no para tocar un repositorio. Si es eso lo que buscabas, tienes también el paso a paso para crear un Proyecto en Claude explicado aparte.

Regla rápida: si necesitas que alguien ejecute comandos en tu máquina, es Claude Code. Si necesitas un espacio de consulta con tus documentos, es un Proyecto.

Qué revisar antes de dejarlo suelto

El error de principiante es aprobar los cambios sin leerlos. El modelo puede equivocarse con seguridad absoluta, inventarse una función de una librería que no existe o entender mal lo que le pediste (eso tiene nombre: alucinación, y es inevitable, no un fallo puntual). Tu red de seguridad es git: trabaja siempre sobre una rama, mira el diff antes de hacer commit y así cualquier desastre se deshace en un comando.

Yo he acabado con una costumbre que parece tonta y me ha ahorrado muchos disgustos: antes de leer el diff, miro la lista de ficheros tocados. Si ahí aparece uno que yo no habría abierto para esa tarea, un fichero de configuración, un test que no venía a cuento, ese es el sitio por donde empiezo a revisar. Casi siempre el problema está justo ahí, y me evita leer trescientas líneas de cambios correctos para encontrar la mala.

El segundo error es pedirle demasiado de golpe. “Refactoriza el backend” es una instrucción que garantiza un desastre difícil de revisar. “Extrae la lógica de precios a su propio módulo y deja los tests pasando” es un encargo con un final que puedes comprobar en cinco minutos.

Cuando le cojas el punto, el paso siguiente suele ser lanzar varias sesiones a la vez, y ahí aparece un problema nuevo: dos agentes en la misma carpeta se pisan los ficheros. La solución es darle a cada uno su propia copia del árbol de trabajo, que es exactamente lo que explico en Git worktrees y Claude Code: agentes en paralelo sin conflictos.

Y si lo que te interesa no es solo usar la herramienta sino entender cómo se diseñan estos sistemas por dentro, ese es el contenido del curso Patrones de Diseño para Agentes de IA.

Preguntas frecuentes

¿Claude Code es lo mismo que Claude, el de claude.ai?

No. Claude es el asistente con el que conversas en el navegador, y Claude Code es la herramienta que usa ese mismo modelo pero con acceso a tu proyecto: abre tus ficheros, los edita y ejecuta comandos en tu ordenador. El modelo se parece, lo que puede hacer no.

¿Qué tareas concretas le puedo pedir a Claude Code?

Los ejemplos que mejor salen son los que tienen un final comprobable: escribir los tests de un módulo que nadie testeó y dejarlos en verde, averiguar por qué falla el login y arreglarlo, contarte dónde se valida el pago en un repositorio que acabas de heredar, limpiar todos los errores de lint del proyecto, o preparar el commit y abrir la pull request. Los que salen mal son los encargos vagos, del estilo de “refactoriza el backend”.

¿En qué se diferencia Claude Code de GitHub Copilot?

En el tamaño del encargo. Copilot se usa sobre todo escribiendo en el editor y sugiriéndote lo que viene a continuación, mientras que a Claude Code le pides una tarea entera y la ejecuta él de principio a fin, tests incluidos.

¿Necesito saber programar para usar Claude Code?

Sí, aunque menos de lo que crees para empezar. Puedes pedirle cosas en lenguaje normal y funcionará, pero alguien tiene que leer el diff y decidir si el cambio es correcto, y esa persona eres tú. Sin criterio para revisar, lo que consigues es acumular código que nadie entiende a una velocidad mayor. Si estás aprendiendo, úsalo para explorar repositorios y para que te explique código antes que para escribirlo del tirón.

¿Funciona con cualquier lenguaje y cualquier repositorio?

Sí. No está atado a un lenguaje ni a un framework, porque lo que hace es leer ficheros y ejecutar los comandos que ya usas en ese proyecto. Le va mejor en repositorios con tests y con un README decente, por la misma razón que a un compañero nuevo.

¿Puedo usar Claude Code en español?

Sí, le hablas en español y te responde en español, incluidos los mensajes de commit si se lo pides. El código y los nombres de las herramientas siguen en inglés, como en cualquier proyecto.