Claude Code — Flujos de trabajo · Agentes de IA para programar

Mini-flujos de trabajo específicos de esta herramienta, construidos sólo con comandos verificados. Las versiones que funcionan en cualquiera de las tres herramientas están en Entender un repositorio nuevo (y el resto de recorridos, como Construir una feature de principio a fin) y en la matriz de funcionalidades.

Entender un código

cd el-repo
claude

> /init
> dame un recorrido general de este código: puntos de entrada, flujo de datos y los módulos más delicados
> ¿cómo funciona el flujo de facturación de principio a fin?
> /compact conserva el resumen de arquitectura

Consejos:

/init escribe un CLAUDE.md inicial para que las siguientes sesiones arranquen mejor informadas (ver Instrucciones de proyecto (CLAUDE.md)).
Las exploraciones grandes se delegan automáticamente al subagente Explore, que es de solo lectura, así tu contexto principal se mantiene limpio (ver Subagentes).
¿Trabajas con varios repos? /add-dir ../otro-repo o claude --add-dir.
Usa /btw para las dudas rápidas que no quieres que queden en el historial.

Construir una feature

claude --permission-mode plan

> /plan añade paginación al endpoint /users
# revisa el plan y apruébalo
> implementa el plan y luego ejecuta los tests
> /diff
> haz el commit con un mensaje de conventional commits

Consejos:

El modo plan es de solo lectura hasta que apruebas el plan — el sitio más barato para detectar un enfoque equivocado (ver Permisos).
Shift+Tab entra en modo plan en cualquier momento.
/diff muestra los cambios sin commitear antes de que hagas el commit.
¿Implementación larga? /background desacopla la sesión como agente en segundo plano; puedes vigilarla con /tasks.

Depurar

cat salida-del-test-que-falla.log | claude -p "encuentra la causa raíz"

o de forma interactiva:

> el flujo de login devuelve un 401 después de refrescar el token — este es el test que falla: [pegar]
> formula una hipótesis, añade logging para confirmarla y luego arréglalo
> /rewind          # si el arreglo lo empeoró — devuelve código y conversación a un checkpoint

Consejos:

/rewind (o Esc+Esc) devuelve tanto el código como la conversación a un checkpoint — el deshacer más rápido.
/debug [descripción] diagnostica problemas del propio Claude Code; /doctor revisa la instalación.
Pasar la entrada por tubería (cat archivo | claude -p "...") va muy bien con logs grandes que inundarían la interfaz interactiva.

Refactorizar

claude -w refactor-auth        # arranca en un worktree de git aislado

> /plan extrae la lógica de auth de middleware.ts a lib/auth/ sin cambiar el comportamiento
> impleméntalo y mantén los tests en verde después de cada paso

Consejos:

--worktree (-w) aísla el refactor en <repo>/.claude/worktrees/<nombre>, así tu copia de trabajo se queda limpia.
Para cambios amplios y repetitivos, /batch <instrucción> descompone el trabajo en unidades que se ejecutan en worktrees.
/branch bifurca una conversación anterior si quieres probar dos estrategias de refactor.

Revisar código

> /review 123                  # revisión rápida, en solo lectura, del PR 123
> /code-review high            # revisión del diff local con varios agentes
> /code-review high --fix      # lo mismo, pero aplicando los arreglos propuestos
> /security-review             # pasada de vulnerabilidades sobre el diff
> /pr-comments 123             # trae los comentarios de la revisión para atenderlos

Consejos:

/review, /code-review y /security-review son distintos: comprobación rápida de un PR en solo lectura, revisión profunda del diff con varios agentes (low→ultra; ultra corre en la nube) y pasada centrada en seguridad.
Retoma la sesión que hay detrás de un PR con /resume (pegando la URL del PR) o con claude --from-pr 123.

Automatizar en modo headless

# una sola ejecución, en formato legible por máquinas
claude -p "lista los comentarios TODO de src/" --output-format json

# acotado y con presupuesto
claude -p "arregla los tests que fallan" --max-turns 10 --max-budget-usd 2 --allowedTools "Bash(pnpm test *)" "Edit" "Read"

# encadena ejecuciones usando los IDs de sesión
claude -p "redacta la migración" --output-format json    # saca session_id del JSON
claude --resume <session_id> -p "ahora aplica el feedback de la revisión"

Consejos:

Los comandos slash, tanto los integrados como los tuyos, no están disponibles en modo -p.
--json-schema devuelve salida estructurada y validada en el campo structured_output.
Todos los flags de automatización están en Flags del CLI.

Última verificación: 2026-09-07

Fuentes oficiales:

Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.