Ir al contenido
learn

Programación agéntica con Claude Code y Codex — Misión

La mayor parte de este sitio se escribió con un agente de programación. Describo una tarea, el agente lee archivos, ejecuta comandos, edita, ejecuta las pruebas y vuelve con un diff y un resumen. Cuando funciona, es más rápido que hacerlo yo mismo; cuando no, el error puede ser sutil: una prueba que no ejecutó, una regla que olvidó, una rama que hizo push.

Quiero entender lo que pasa entre mi petición y el diff: qué archivos lee el agente, qué tiene permitido ejecutar, qué recuerda y cómo poner barreras de protección que no dependan de la buena voluntad del agente. Después, usarlo en GuitarAlchemist/ga, una solución .NET de 111 proyectos, y más adelante en Gaia e IX.

Escribes C# o Java profesionalmente. Conoces tu IDE, Git, una herramienta de compilación y un framework de pruebas. Puede que hayas usado el autocompletado de código (IntelliSense, las sugerencias en línea de GitHub Copilot), pero nunca has dejado que un agente ejecute comandos en tu repositorio. No necesitas saber nada de modelos de lenguaje.

Autocompletado del IDE Claude Code CLI de Codex
Se ejecuta dentro del editor, en cada pulsación en una terminal, como sesión en una terminal, como sesión
Actúa sobre la línea que estás escribiendo todo el repositorio: lee, edita, ejecuta comandos lo mismo
Pregunta antes de actuar nunca actúa modos y reglas de permisos modos de sandbox y políticas de aprobación
Instrucciones de proyecto ninguna CLAUDE.md AGENTS.md
Barreras de protección deterministas ninguna hooks hooks, sandbox
Herramientas adicionales extensiones del editor servidores MCP, skills, subagentes servidores MCP, skills, subagentes
No interactivo no claude -p codex exec

Fuentes: cómo funciona Claude Code, CLI de Codex, aprobaciones y seguridad de Codex.

  • Este sitio, spareilleux/learn: un sitio Astro con cursos en tres idiomas, una CI que ejecuta el código de cada curso y un AGENTS.md que ha crecido con cada error que un agente cometió aquí. Varias sesiones de agente trabajan en él al mismo tiempo.
  • GuitarAlchemist/ga, fijado en el commit a826864 (2026-09-14): una aplicación de teoría musical en C# y F#, con un CLAUDE.md, un AGENTS.md, skills y subagentes de proyecto, y GaMcpServer, un servidor MCP que expone su teoría musical a los agentes. Este curso lee ga; nunca escribe en él.
  • explicar el bucle entre el modelo y las herramientas, y lo que un agente puede hacer sin preguntar;
  • instalar Claude Code y la CLI de Codex en Windows, Linux y macOS, y ejecutarlos de forma interactiva y desde un script;
  • escribir instrucciones de proyecto que lean ambos agentes, y saber lo que no pueden imponer;
  • bloquear un comando peligroso con un hook, empaquetar un procedimiento como skill y delegar en un subagente;
  • escribir un servidor MCP en C#, probarlo sin agente y conectarlo a ambos agentes;
  • usar estas herramientas en una solución .NET real, y revisar lo que hizo el agente.
# Lección Ya conoces
1 Agentes, herramientas y permisos las refactorizaciones del IDE, lanzar una compilación desde la terminal
2 Contexto de proyecto: CLAUDE.md, AGENTS.md, memoria y compactación README.md, .editorconfig, una página de wiki que nadie lee
3 Hooks, skills y subagentes los hooks de Git, los analizadores, los scripts de tools/
4 MCP: un servidor C# para ambos agentes un servicio JSON-RPC o gRPC, la inyección de dependencias
5 Skills de Matt Pocock: métodos de ingeniería ejecutables runbooks, TDD, división en issues
6 Sandcastle: una ejecución aislada de un agente contenedores, ramas, aislamiento de procesos
7 Compound Engineering: cerrar el ciclo de aprendizaje pipelines de entrega, postmortems, documentación reutilizable
8 Trabajar en GuitarAlchemist/ga: planificar, compilar, probar, revisar (próximamente) la revisión de una pull request
9 Agentes en la CI, y varios agentes en un mismo repositorio GitHub Actions, la protección de ramas
10 Gaia e IX: agentes que ejecutan otros agentes orquestación, colas
— Diario