Agentes de programación con IA para agencias y proyectos de clientes

Para usar agentes de programación con IA en varios proyectos de clientes, dale a cada cliente su propia carpeta, su propio archivo de instrucciones y, cuando el contrato lo exija, su propia cuenta de agente, e inicia cada agente solo dentro de la carpeta de ese cliente. La mayoría de los problemas que las agencias cuentan con los agentes (convenciones equivocadas, contexto filtrado, costes inesperados) vienen de una configuración compartida, no del modelo.

Esta guía es para agencias pequeñas y freelancers que ya usan Claude Code, Codex u otro agente de programación en un proyecto y ahora lo quieren en cinco. Cubre la configuración por cliente, cómo mantener los costes a la vista, la revisión antes de entregar y cómo tenerlo todo en una sola ventana.

Por qué falla una sola configuración para todos los clientes

Un agente de programación trabaja con lo que ve: la carpeta en la que se inicia, los archivos de instrucciones que hay en ella y la cuenta con la que ha iniciado sesión. Cuando todo eso se comparte entre clientes, fallan tres cosas:

• Las convenciones se filtran. El agente toma costumbres del código o las instrucciones del último cliente y las aplica al siguiente.
• Los costes se difuminan. Una cuenta y una barra de uso para todo significa que no puedes saber qué cliente consumió qué.
• El acceso es más amplio de lo debido. Un agente iniciado en una carpeta superior puede leer todas las carpetas de clientes que hay debajo, incluidos los archivos .env.

La solución es aburrida y funciona: un límite por cliente.

Paso 1: una carpeta por cliente, e inicia los agentes dentro

Mantén cada cliente en su propia carpeta, con su propio repositorio:

~/clients/
  acme-shop/
  dental-clinic-site/
  logistics-dashboard/

Inicia siempre el agente desde dentro de una carpeta de cliente, nunca desde ~/clients/. Claude Code, Codex y Gemini CLI tratan la carpeta en la que los inicias como el proyecto. Si necesitas un segundo agente en el mismo cliente, por ejemplo uno para corregir un bug y otro para una página nueva, dale un git worktree para que no editen los mismos archivos.

Paso 2: escribe un archivo de instrucciones por cliente

Todo agente de programación lee un archivo de instrucciones del proyecto al inicio de una sesión: CLAUDE.md en Claude Code, AGENTS.md en Codex y muchos otros. Pon uno en la raíz de cada carpeta de cliente. Que sea breve y concreto:

# Cliente: tienda online (tema de Shopify + API en Node)

- Stack: tema Liquid, Node 22, Postgres. Tests: npm test.
- Estilo del cliente: nada de dependencias nuevas sin preguntar; textos en turco e inglés.
- No tocar nunca: ajustes de pago, /infra, archivos .env de producción.
- Terminado significa: los tests pasan y hay un pull request con un resumen breve para el cliente.

Este archivo marca la diferencia entre un agente que adivina y uno que sigue las reglas del cliente. Cuando un cliente cambia una regla, cambia el archivo, no tus prompts.

Paso 3: decide las cuentas por cliente

A algunos clientes no les importa con qué cuenta trabaja el agente. Otros quieren que el trabajo se haga en una cuenta que pagan ellos, o prohíben enviar su código a un proveedor que no han aprobado. Revisa primero el contrato.

Cuando un cliente necesite su propio inicio de sesión, dale a esa cuenta su propia carpeta de configuración. Claude Code lee su carpeta de CLAUDE_CONFIG_DIR y Codex de CODEX_HOME, así que dos carpetas son dos sesiones en la misma máquina sin cerrar sesión. Nuestra guía para cambiar de cuenta en Claude Code muestra la configuración manual paso a paso.

Paso 4: mantén los secretos fuera de alcance

Los agentes leen archivos para entender un proyecto, y los .env son archivos. Por cliente:

• deja las credenciales de producción fuera de la carpeta de trabajo; usa un .env de desarrollo con claves de prueba;
• añade las rutas sensibles al archivo de instrucciones, en «no tocar nunca»;
• usa los ajustes de permisos del agente para que pregunte antes de ejecutar comandos que despliegan, migran o borran.

Paso 5: mide los tokens por cliente

Si piensas facturar el uso de IA, o simplemente quieres saber qué cliente es rentable, mídelo por agente y por carpeta desde el primer día. Ayudan dos reglas sencillas:

• pon un tope diario por agente, para que un bucle atascado no queme el presupuesto de un cliente durante la noche;
• usa el modelo más barato para cambios rutinarios y el más potente solo para diseño y depuración.

Nuestro artículo sobre los límites de uso de Claude Code explica cómo funcionan los límites de 5 horas y semanal, algo que importa en cuanto varios clientes comparten una suscripción.

Paso 6: revisa cada diff antes de que lo vea el cliente

Deja que los agentes trabajen en una rama y abran un pull request. Lee el diff, ejecuta los tests y comprueba la página tú mismo. Los clientes no pagan por código que escribió un agente; pagan por código que revisó alguien de su confianza. Un breve resumen escrito por pull request también facilita el informe semanal al cliente.

Todo esto en una ventana con AgentVera

Los pasos anteriores funcionan con terminales normales. Lo difícil es tener a la vista cinco clientes y diez agentes. AgentVera es una app de escritorio para macOS, Windows y Linux que ejecuta Claude Code, Codex, Gemini CLI y otros agentes uno al lado del otro, cada uno en una terminal real con tu propia instalación y tu propio inicio de sesión. Para el trabajo de agencia, lo que importa es:

• Una cuadrícula por proyecto. Cada carpeta de cliente tiene su propio conjunto de agentes, y cambias de cliente sin perder su estado. Consulta espacio de trabajo.
• Una cuenta por agente. Añade cuentas en Settings → Accounts y elige una al crear un agente, para que los agentes de un cliente siempre usen el inicio de sesión correcto. Consulta cuentas.
• Topes de tokens por agente. Topes por agente, por turno y por día, un aviso al 80 %, y al llegar al tope el agente se detiene pero conserva su conversación. Consulta presupuestos de tokens.
• Revisión de código antes de entregar. Revisa los cambios del agente dentro de la app antes de que lleguen al repositorio del cliente. Consulta revisión de código.

El plan gratuito incluye hasta 18 agentes, MCP, Git, Docker, SSH, revisión de código y ahorro de tokens. Pro cuesta 9,99 $ al mes; si nunca has tenido una prueba, tu primer inicio de sesión en la app activa Pro durante 7 días sin tarjeta.

En resumen

Los agentes escalan a muchos clientes cuando cada cliente tiene un límite claro: su propia carpeta, su propio archivo de instrucciones, la cuenta correcta, ningún secreto de producción a su alcance, su propio recuento de tokens y una revisión humana antes de entregar. Configúralo una vez por cliente y añadir el sexto cliente te llevará minutos, no una semana de limpieza.

Fuentes: Claude Code settings, AGENTS.md.