Conceptos básicos de los flujos de trabajo de código de Claude
10 ejemplos para empezar con los flujos de trabajo principales: 7 básicos y 3 intermedios.
Prerrequisitos / Instalación rápida
- Claude Code instalado y conectado a un proyecto real (consulta la guía de instalación de Claude Code 101 si aún no lo has hecho).
- Una base de código con una suite de pruebas o un linter ya configurados; los ejemplos a continuación asumen
npm test, pero sustituye los comandos de prueba/linter reales de tu proyecto. - Una sesión de terminal abierta en la raíz del proyecto para que las lecturas de archivos, ediciones y comandos de Claude Code se resuelvan contra el mismo directorio de trabajo.
Ejemplos básicos
1. Pide a Claude Code que localice una función
Descripción en una línea: apunta a Claude Code a un símbolo y deja que su herramienta de búsqueda integrada encuentre todos los lugares donde vive y se utiliza.
> Encuentra la función que calcula el total del pedido y muéstrame todos los lugares donde se llama.- Claude Code ejecuta su búsqueda integrada similar a grep en el repositorio en lugar de adivinar una ruta de archivo basándose solo en el nombre.
- Devuelve la definición más cada sitio de llamada, que es el punto de partida para cualquier edición; no puedes cambiar de forma segura la firma de una función sin saber quién la llama.
- No se modifican archivos en este paso; es pura investigación, por lo que normalmente no necesita aprobación de permisos.
- Si la primera búsqueda no encuentra coincidencias (por ejemplo, la función se reexporta con un alias), pide a Claude Code que amplíe la búsqueda en lugar de editar a ciegas.
Relacionado: Búsqueda en una base de código con la herramienta Grep integrada de Claude Code - cómo funciona realmente el paso de búsqueda
2. Lee el archivo antes de proponer una edición
Descripción en una línea: el bucle siempre comienza con una lectura, incluso para un archivo que crees que ya conoces.
> Abre src/utils/pricing.ts y explica qué hace calculateOrderTotal.- Claude Code lee el archivo completo (o la región relevante) en el contexto antes de proponer cualquier cambio, en lugar de depender de un resumen de memoria.
- Esto basa la edición en el código tal como existe realmente en este momento, incluidos los comentarios, el manejo de casos extremos y las convenciones de formato.
- Un paso de solo lectura como este suele ser aprobado automáticamente, ya que no toca el sistema de archivos.
- Saltar directamente a "simplemente arréglalo" sin un paso de lectura tiende a producir ediciones que ignoran las convenciones locales; pedir una lectura primero prepara una mejor diferencia.
3. Realiza una edición pequeña y específica
Descripción en una línea: convierte una función localizada en una corrección de una línea y revisa la diferencia propuesta.
- return price * quantity;
+ return Math.round(price * quantity * 100) / 100;- Claude Code propone el cambio como una diferencia (diff) contra el archivo que acaba de leer, por lo que puedes ver exactamente qué cambiará antes de que se aplique.
- Las ediciones pequeñas y específicas son más fáciles de verificar visualmente que las reescrituras grandes; pide el cambio más pequeño que solucione el problema descrito.
- Dependiendo del modo de permisos, la aplicación de la edición puede ser aprobada automáticamente (ediciones de archivos), mientras que un comando de seguimiento como la ejecución de una prueba desencadena una solicitud de aprobación.
- Si la diferencia afecta a más del error descrito, pide a Claude Code que la reduzca antes de aceptarla.
Relacionado: Una lista de verificación para revisar las diferencias propuestas por Claude Code - qué revisar antes de aprobar
4. Ejecuta un linter para comprobar la edición
Descripción en una línea: después de una edición, ejecuta el linter del proyecto como el paso de "ejecución" del bucle.
> Ejecuta el linter en src/utils/pricing.ts y arregla cualquier cosa que marque.- Claude Code ejecuta el comando de lint real (
eslint,ruff,golangci-lint, lo que sea que use el proyecto) en lugar de revisar el estilo visualmente a mano. - Ejecutar un comando bash arbitrario es el tipo de acción que comúnmente solicita aprobación, dependiendo de tu modo de permisos.
- Los fallos de lint se leen de nuevo en el contexto, por lo que Claude Code puede proponer una corrección de seguimiento sin que tengas que pegar la salida del error tú mismo.
- Mantén el bucle ajustado: una edición, una ejecución de lint, una mirada al resultado, antes de pasar al siguiente cambio.
Relacionado: Cómo decide Claude Code cuándo ejecutar un comando y cuándo pedir permiso - por qué algunos comandos solicitan y otros no
5. Ejecuta una sola prueba para verificar la corrección
Descripción en una línea: reduce la ejecución de la prueba solo a la prueba que cubre el cambio que realizaste.
> Ejecuta solo el archivo de prueba de precios y dime si pasa.npm test -- pricing.test.ts- Ejecutar un solo archivo de prueba proporciona una retroalimentación más rápida que la suite completa mientras sigues iterando en una función.
- Claude Code lee la salida de la prueba directamente, por lo que un fallo es seguido por un diagnóstico, no solo por un informe de aprobado/fallido.
- Este es el paso de "verificar" del bucle; una edición no está completa hasta que algo se ha ejecutado y confirmado.
- Si la prueba ya estaba pasando antes de tu edición, esto también confirma que no has introducido una regresión.
6. Relee un archivo antes de una segunda edición
Descripción en una línea: Claude Code relee un archivo inmediatamente antes de editarlo de nuevo, incluso dentro de la misma sesión.
> Ahora también actualiza la lógica de descuento en el mismo archivo.- Claude Code relee el archivo justo antes de aplicar una segunda edición en lugar de confiar en la copia en memoria del paso 2.
- Esto protege contra el trabajo con una versión obsoleta si el archivo cambió desde la última vez que se leyó, ya sea por ti, por un formateador o por una llamada de herramienta anterior.
- A veces notarás que una segunda lectura ocurre automáticamente sin ninguna indicación adicional de tu parte; ese es un comportamiento esperado, no un trabajo perdido.
- Si editaste el archivo fuera de Claude Code (en tu propio editor) entre turnos, esta relectura es lo que evita que la siguiente diferencia anule tus cambios.
Relacionado: Por qué Claude Code relee los archivos antes de editarlos - el problema de la obsolescencia que esto resuelve
7. Aprueba o deniega una solicitud de permiso
Descripción en una línea: sabe qué estás mirando cuando Claude Code pregunta antes de ejecutar un comando.
Claude quiere ejecutar: npm test
¿Permitir este comando? (s/n)- Algunas acciones, notablemente la ejecución de comandos bash, pueden solicitar aprobación explícita dependiendo de tu modo de permisos actual, mientras que muchas lecturas y ediciones de archivos se aprueban automáticamente.
- Lee el comando exacto antes de aprobar; es tu único punto de control contra un efecto secundario no deseado (como un script destructivo o una llamada de red).
- Si esperas ejecutar el mismo comando seguro repetidamente en una sesión, la mayoría de los modos de permisos te permiten aprobarlo una vez para el resto de la sesión en lugar de cada vez.
- Denegar una solicitud es una parte normal del bucle, no un fallo; Claude Code propondrá una alternativa una vez que sepa que el comando fue rechazado.
Relacionado: Cómo decide Claude Code cuándo ejecutar un comando y cuándo pedir permiso - el desglose completo de los modos de permisos
Ejemplos intermedios
8. Realiza un cambio pequeño en varios archivos en un solo turno
Descripción en una línea: renombra o extiende algo que tiene sitios de llamada en más de un archivo, todo en un solo turno.
> Renombra calculateOrderTotal a calculateCartTotal en todas partes donde se
define y se usa, y actualiza la importación en checkout.ts.- Claude Code coordina la edición en todos los archivos afectados en un solo turno, manteniendo la definición de la función, sus exportaciones y sus sitios de llamada consistentes.
- Relee cada archivo justo antes de editarlo, la misma verificación de obsolescencia del ejemplo 6, aplicada archivo por archivo en el conjunto.
- Después de que las ediciones se apliquen, vuelve a ejecutar el paso de verificación del bucle (un pase de lint y las pruebas relevantes) para detectar cualquier sitio de llamada que la búsqueda haya pasado por alto.
- Los cambios en varios archivos son exactamente donde una búsqueda estrecha y bien definida (ejemplo 1) da sus frutos; una búsqueda incompleta aquí significa un renombre incompleto.
Relacionado: Realizar ediciones en varios archivos en un solo turno de Claude Code - análisis más profundo de este patrón
9. Ejecuta la suite de pruebas e itera sobre un fallo
Descripción en una línea: deja que Claude Code ejecute la suite completa, lea un fallo y arréglalo sin que tengas que transmitir el stack trace a mano.
> Ejecuta la suite de pruebas completa. Si algo falla, mira el fallo y arréglalo,
luego vuelve a ejecutar hasta que pase.FAIL src/checkout.test.ts
● aplica el descuento antes de impuestos
se esperaba 90 en lugar de 92.5- Claude Code ejecuta la suite, lee la salida de fallos como el fragmento anterior directamente y propone una corrección dirigida a la aserción fallida en lugar de una reescritura amplia.
- Después de la corrección, vuelve a ejecutar la suite (o al menos el archivo fallido) automáticamente, cerrando el bucle en lugar de detenerse en "Creo que esto debería funcionar".
- Esto solo funciona cuando Claude Code tiene permiso para ejecutar el comando de prueba; en un modo de permisos más estricto, es posible que necesites aprobar cada ejecución.
- Si una corrección hace que otra prueba falle, esa es una señal útil; deja que el bucle continúe en lugar de revertir inmediatamente.
Relacionado: Ejecutar pruebas e iterar sobre fallos automáticamente - el patrón completo para este flujo de trabajo
10. Extiende el bucle con un servidor MCP
Descripción en una línea: integra una herramienta externa, como un rastreador de incidencias, para que el bucle pueda comenzar desde un ticket en lugar de una descripción manual.
> Busca el ticket PROJ-482 e implementa la corrección que describe, luego abre
una ejecución de prueba vinculada una vez que pase.- Un servidor MCP (Model Context Protocol) conecta Claude Code a herramientas externas (rastreadores de incidencias, bases de datos, API internas), de modo que el paso de lectura pueda comenzar desde un ticket en lugar de una indicación que escribiste de memoria.
- El resto del bucle no cambia: lee el código relevante, propone una edición, ejecuta las pruebas, verifica el resultado; la herramienta MCP simplemente proporciona contexto adicional o realiza una acción externa.
- Cada llamada a la herramienta MCP está sujeta a la misma lógica de permisos que un comando bash o una edición de archivo; espera una solicitud la primera vez que se utiliza una nueva herramienta, dependiendo de tu modo de permisos.
- Comienza con un servidor MCP para un flujo de trabajo (como la búsqueda de tickets) antes de conectar varios; es más fácil confiar en la salida del bucle cuando sabes exactamente qué herramientas tocó.
Relacionado: Conectar un servidor MCP para extender el conjunto de herramientas de Claude Code - cómo configurar uno | Navegar por la REPL, las indicaciones y los comandos de barra de Claude Code - conceptos básicos de la REPL si eres nuevo en el modelo de sesión
Versiones de la pila: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026: Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.