Automatizar tareas de código con Claude Code

Al terminar vas a tener a Claude Code resolviendo una tarea real en tu proyecto, de punta a punta, sin que sueltes el control: tú apruebas cada cambio que importa. Eso te ahorra el ida y vuelta de copiar y pegar entre el chat y el editor, y te deja delegar lo aburrido para concentrarte en decidir. La diferencia con un chat normal es enorme: Claude Code no te dice “haz esto y aquello”, sino que abre los archivos, los modifica y ejecuta lo que haga falta, mostrándote cada movimiento antes de aplicarlo.

La promesa del tutorial es modesta y por eso útil: en veinte minutos te montas el flujo completo en tu propio repositorio, con una tarea pequeña pero real, y aprendes el ritmo de trabajo que después escala a tareas largas. Si vienes de copiar fragmentos desde el navegador, vas a notar el salto enseguida: el agente entiende la estructura del proyecto, respeta las convenciones que detecta y deja el cambio listo para revisar como si fuera un compañero al que le explicaste qué hacer.

Antes de empezar conviene tener clara una cosa: Claude Code no es un editor visual ni una extensión del navegador, es una herramienta de línea de comandos. Si nunca abriste PowerShell o la Terminal, te recomiendo familiarizarte con cd y ls/dir antes de seguir; no necesitas mucho más para esta lección.

Antes de empezar

Necesitas una cuenta de Anthropic con un plan de pago activo (Pro, Max, Team o Enterprise). Si solo tienes el plan gratuito, Claude Code no arranca: lo primero que va a hacer al instalarse es abrir el navegador para que inicies sesión, y rechaza la sesión si la cuenta no tiene crédito. Si te falta el plan, primero abre claude.ai, contrata el que se ajuste a tu uso y vuelve aquí.

También conviene tener el proyecto bajo control de versiones desde el primer minuto. Si la carpeta donde vas a trabajar todavía no es un repositorio Git, ejecuta git init antes de invocar a Claude. Así puedes revertir cualquier cambio con un comando si el resultado no te convence. Si trabajas en un proyecto del trabajo, asegúrate de tener permiso para usar IA sobre ese código: hay empresas que solo permiten herramientas auditadas.

El recorrido completo

El primer paso, instalar la herramienta, es el más mecánico pero también el que más confusión genera la primera vez. Los comandos del frontmatter usan el instalador nativo de Anthropic, que coloca el binario claude en una carpeta del sistema y la añade al PATH. Eso significa que, una vez instalado, puedes escribir claude desde cualquier carpeta y arrancar. En Windows, si copias el comando en PowerShell y te pide elevar permisos, acéptalo solo si confías en la fuente (estás copiando desde el dominio claude.ai, así que es seguro). En Mac, si el script de instalación pide tu contraseña, también es normal: la necesita para escribir en /usr/local/bin o equivalente.

El segundo paso, entrar a la carpeta del proyecto y ejecutar claude, es donde la sesión cobra contexto. Claude Code no es un servidor permanente: cada vez que lo lanzas dentro de una carpeta, esa carpeta se convierte en su entorno de trabajo. Lee los archivos que necesita, recuerda lo que está pasando dentro de esa conversación y se cierra cuando salgas. La primera vez te abrirá el navegador para que inicies sesión con tu cuenta de Anthropic; las siguientes recuerda las credenciales y entra directo.

El tercer paso es donde está el truco. Cuando le describes la tarea, no te limites a una frase corta como “haz un formulario”: añade qué framework usas, dónde van los componentes, qué estilo de código sigues. El ejemplo del frontmatter ya muestra el patrón: pedir el formulario, pero también pedir el plan antes de tocar archivos. Esa última coletilla cambia todo el flujo: en vez de empezar a editar a ciegas, Claude te muestra una lista de archivos que va a crear o modificar y espera tu aprobación. Tienes la oportunidad de corregir el rumbo antes de que escriba una sola línea.

El cuarto paso es la revisión activa de los cambios. Para cada edición Claude muestra un diff con verde para lo añadido y rojo para lo quitado. No apruebes en automático: leer los diffs es rápido y atrapa cosas como nombres de variables que no encajan con tu estilo, dependencias añadidas que no querías o lógica duplicada. Si algo no te gusta, dilo en lenguaje natural: “el nombre del componente no me gusta, llámalo FormularioContacto”, y Claude reescribe el diff antes de aplicarlo. Esta capa de aprobación humano-en-el-bucle es lo que distingue a Claude Code de las herramientas que editan archivos a ciegas.

El quinto paso, pedir verificación, suele saltarse y es donde se cuelan los errores. Que Claude diga “listo, funciona” no significa que funcione: necesita ejecutar el código para comprobarlo. Pídele explícitamente que arranque el proyecto, abra el navegador (o el endpoint si es backend) y confirme que ve el formulario. Si tu proyecto tiene suite de pruebas, pídele que la ejecute. Cuando algo falla, no le digas “arréglalo” y ya: léete el error con él, dile qué interpretas tú y deja que itere. En tareas grandes, el bucle “ejecuta–falla–arregla” puede repetirse varias veces; es normal.

A lo largo del recorrido vas a notar que Claude pide permiso para cosas concretas. Las primeras veces puede irritar, pero ese permiso explícito es lo que evita que borre por error un archivo crítico o instale una dependencia pesada sin avisar. Si te aburre confirmar lo mismo veinte veces, hay forma de autorizar globalmente ciertos comandos para esa sesión; lo encuentras en la documentación. Empieza estricto y suelta solo cuando confíes en el patrón.

Cómo saber que cada parte funciona

Tras la instalación, lanzar claude --version debería devolverte un número de versión y no un error de comando no encontrado; si la terminal te dice que no reconoce claude, cierra y reabre la ventana para que tome el PATH actualizado. Tras ejecutar claude dentro de tu proyecto, debería abrirse un prompt interactivo con el nombre de la carpeta como contexto y un cursor parpadeando esperando tu instrucción.

Cuando pidas la tarea, sabrás que el flujo va bien si Claude responde primero con un plan en texto, después solicita permiso para crear o editar archivos concretos y, tras aprobarlos, muestra los diffs uno a uno. Si todo eso ocurre y al final el proyecto arranca sin errores cuando le pides verificarlo, has completado el bucle. Una pista útil: pídele al final un resumen en una frase de lo que cambió; ese resumen debe coincidir con lo que tú esperabas.

Errores frecuentes y cómo salir de ellos

• El comando claude no se reconoce. Cierra y reabre la terminal para que tome el PATH actualizado. Si sigue sin aparecer, vuelve a ejecutar el instalador de tu sistema; suele ser un fallo de PATH y no de instalación en sí.
• No abre el navegador para iniciar sesión. Copia a mano la URL que imprime la terminal y pégala en el navegador donde ya tienes tu cuenta de Anthropic abierta. Si el navegador por defecto del sistema no es donde estás logueado, esto es lo más común.
• Edita archivos que no querías. Frénalo con Ctrl+C, revierte con git checkout . y vuelve a pedir la tarea aclarando qué archivos o carpetas no debe tocar. Por eso conviene tener Git inicializado desde el principio.
• Dice que terminó pero el proyecto no corre. Pídele explícitamente que ejecute el proyecto o las pruebas y que arregle los errores que aparezcan, en vez de confiar en su resumen. Un agente puede creer que terminó cuando solo terminó de escribir.
• Se queda sin contexto en tareas largas. Divide el pedido en pasos chicos y empieza una sesión nueva cuando cambies de objetivo. Si la conversación se vuelve confusa, salir y volver a entrar suele dejarlo más enfocado que seguir hilando.
• Pide permiso una y otra vez para el mismo comando. Es lo esperado por diseño. Si te ralentiza, autoriza ese comando concreto durante la sesión cuando aparezca la opción; no aceptes “permitir todo” sin entender qué estás autorizando.

Variaciones útiles

Si trabajas solo en proyectos personales, te basta con esta receta: instalar, abrir el proyecto y pedir tareas chicas a medida. Si trabajas en equipo, conviene añadir un archivo CLAUDE.md en la raíz del repositorio con las reglas que todo el mundo respeta: estilo de código, comandos de testing, qué carpetas son sagradas. Claude lo lee solo al arrancar la sesión y eso te ahorra repetir contexto cada vez. Si el repositorio es de cliente, asegúrate de que ese cliente acepta que uses IA sobre su código antes de empezar.

Para tareas repetitivas (escribir tests, generar documentación, refactorizar un patrón) considera convertir la instrucción en un comando reutilizable. Esto se conecta con las skills y plugins que se cubren en la lección de equipar Claude Code: en vez de tipear el mismo prompt cada lunes, lo ejecutas con un atajo. Para proyectos grandes con monorepo, conviene lanzarlo dentro del paquete específico en lugar de en la raíz, así no se distrae leyendo todo el repositorio.

Siguiente paso

Cuando ya tengas la base, suma capacidades extra. Crea un CLAUDE.md con las reglas de tu proyecto (estilo, comandos, qué evitar) para que Claude lo lea automáticamente al arrancar. Después dale herramientas externas con la lección de “Equipa tu Claude Code con skills, MCPs y plugins”: un MCP de sistema de archivos amplía dónde puede mirar, y los plugins añaden comandos especializados. Y si lo tuyo es trabajar contra GitHub, conéctalo a tu repo con la lección de “Automatizar tu repo de GitHub con Claude” para que actúe directamente sobre issues y pull requests.