Cómo ejecutar varios agentes de IA en un mismo repositorio (sin conflictos de Git)
Hacer correr varios agentes en un proyecto exige tres cosas: una máquina que los aloje, un directorio que compartan, y una regla que decida quién escribe dónde. Sin la tercera, el segundo agente borra el trabajo del primero sin que nada lo avise.
Paso a paso
- Crea el proyecto. Un canvas arranca su propia máquina y un repositorio privado. Ahí vive el directorio compartido, y es el mismo para todos los agentes que abras después.
- Conecta tus cuentas. Enlaza la suscripción o la clave de API que ya pagas en Anthropic, OpenAI o cualquier otro. Ningún token se revende, el consumo queda en tu cuenta.
- Abre una ventana por agente. Claude Code, Codex, Kimi y OpenCode se abren cada uno en su ventana, con una terminal real. Dos ventanas en el plan Solo, cinco en el Pro.
- Divide por archivo, no por tarea. Dale a cada agente un rincón del proyecto en vez de una tarea que lo atraviesa todo. Dos agentes en dos zonas avanzan en paralelo, dos agentes en el mismo archivo se esperan.
- Deja que el tablero arbitre. Un agente reserva las rutas que va a tocar antes de escribir, y el servidor se las niega a los demás hasta que las libera. Ves quién tiene qué, y quién espera.
Lo que hay que tener a mano
Un repositorio, aunque esté vacío, y una cuenta en un proveedor de modelos. El resto lo pone el proyecto: la máquina, el directorio y el tablero que reparte los archivos.
Un archivo de instrucciones en la raíz del repositorio cambia el resultado más que cualquier ajuste. Los agentes lo leen al arrancar, y evita los primeros cinco errores de cada uno.
El reparto que funciona
La unidad correcta no es la función, es el archivo. Un agente en la API, uno en la interfaz, uno en las pruebas: se cruzan poco y casi nunca esperan. Tres agentes en "la página de pago" se pelearán por los mismos tres archivos toda la hora.
Lo que miras mientras tanto
Las terminales corren en sus ventanas, y el tablero muestra quién tiene cada ruta. Un agente atascado se ve antes de causar daño, y esa es la diferencia real con una cola invisible. El mecanismo en detalle.
Respuestas directas
¿Cuántos agentes a la vez son útiles?
Tantos como frentes independientes tenga el proyecto en ese momento, lo que da dos o tres la mayoría de las veces y cinco en una refactorización grande. Más allá de eso, los agentes pasan el tiempo esperando archivos en vez de escribir.
¿Hace falta un git worktree por agente?
Es el método que recomiendan la mayoría de las guías, y funciona: cada agente recibe su copia de trabajo con su propio índice, así que no hay colisiones. El coste es una fusión por copia, y un conflicto que aparece al final. En un directorio compartido con reserva, no hay nada que fusionar porque nunca existieron dos versiones vivas.
¿Hace falta una rama por agente?
No, y ese es el punto. Una rama por agente traslada el conflicto al momento de la fusión, cuando ya nadie recuerda el razonamiento. Un directorio compartido con reserva resuelve el conflicto en el segundo en que ocurre.
¿Qué pasa si dos agentes quieren el mismo archivo?
El segundo espera. Lo ves en pantalla, tú también, y puedes darle otra cosa que hacer de inmediato en vez de descubrir el problema una hora después.