Agentes de programação com IA para agências e projetos de clientes

Para usar agentes de programação com IA em vários projetos de clientes, dê a cada cliente uma pasta própria, um arquivo de instruções próprio e, quando o contrato exigir, uma conta de agente própria, e inicie cada agente somente dentro da pasta desse cliente. A maioria dos problemas que as agências relatam com agentes (convenções erradas, contexto vazado, custos inesperados) vem de uma configuração compartilhada, não do modelo.

Este guia é para pequenas agências e freelancers que já usam Claude Code, Codex ou outro agente de programação em um projeto e agora querem usá-lo em cinco. Ele cobre a configuração por cliente, como manter os custos visíveis, a revisão antes da entrega e como manter tudo isso em uma só janela.

Por que uma configuração para todos os clientes não funciona

Um agente de programação trabalha com o que enxerga: a pasta em que começa, os arquivos de instruções que estão nela e a conta em que está logado. Quando isso é compartilhado entre clientes, três coisas dão errado:

• As convenções vazam. O agente pega hábitos do código ou das instruções do último cliente e aplica no próximo.
• Os custos se misturam. Uma conta e uma barra de uso para tudo significam que você não sabe qual cliente usou o quê.
• O acesso é maior do que deveria. Um agente iniciado em uma pasta acima consegue ler todas as pastas de clientes abaixo dela, incluindo arquivos .env.

A solução é sem graça e funciona: uma fronteira por cliente.

Passo 1: uma pasta por cliente, e inicie os agentes dentro dela

Mantenha cada cliente na própria pasta, com o próprio repositório:

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

Sempre inicie o agente de dentro de uma pasta de cliente, nunca a partir de ~/clients/. Claude Code, Codex e Gemini CLI tratam a pasta em que você os inicia como o projeto. Se precisar de um segundo agente no mesmo cliente, por exemplo um corrigindo um bug e outro fazendo uma página nova, dê a ele um git worktree para que não editem os mesmos arquivos.

Passo 2: escreva um arquivo de instruções por cliente

Todo agente de programação lê um arquivo de instruções do projeto no início de uma sessão: CLAUDE.md no Claude Code, AGENTS.md no Codex e em muitos outros. Coloque um na raiz de cada pasta de cliente. Seja breve e específico:

# Cliente: loja online (tema Shopify + API em Node)

- Stack: tema Liquid, Node 22, Postgres. Testes: npm test.
- Estilo do cliente: nada de dependências novas sem perguntar; textos em turco e inglês.
- Nunca tocar: configurações de pagamento, /infra, arquivos .env de produção.
- Pronto significa: testes passando e um pull request com um resumo curto para o cliente.

Esse arquivo é a diferença entre um agente que chuta e um que segue as regras do cliente. Quando o cliente mudar uma regra, mude o arquivo, não seus prompts.

Passo 3: defina as contas por cliente

Alguns clientes não se importam com a conta em que o agente roda. Outros querem que o trabalho seja feito em uma conta que eles pagam, ou proíbem enviar o código deles a um provedor que não aprovaram. Confira o contrato primeiro.

Quando um cliente precisar de um login próprio, dê a essa conta uma pasta de configuração própria. O Claude Code lê a pasta dele de CLAUDE_CONFIG_DIR e o Codex de CODEX_HOME, então duas pastas significam dois logins na mesma máquina sem fazer logout. Nosso guia sobre trocar de conta no Claude Code mostra a configuração manual passo a passo.

Passo 4: mantenha os segredos fora de alcance

Agentes leem arquivos para entender um projeto, e .env é arquivo. Por cliente:

• deixe as credenciais de produção fora da pasta de trabalho; use um .env de desenvolvimento com chaves de teste;
• adicione os caminhos sensíveis ao arquivo de instruções, em “nunca tocar”;
• use as configurações de permissão do agente para que ele pergunte antes de rodar comandos que fazem deploy, migram ou apagam.

Passo 5: meça os tokens por cliente

Se você pretende cobrar o uso de IA, ou só quer saber qual cliente dá lucro, meça por agente e por pasta desde o primeiro dia. Duas regras simples ajudam:

• defina um limite diário por agente, para que um loop travado não queime o orçamento de um cliente durante a noite;
• use o modelo mais barato para edições de rotina e o mais forte só para design e depuração.

Nosso post sobre os limites de uso do Claude Code explica como funcionam os limites de 5 horas e semanal, o que importa quando vários clientes dividem uma assinatura.

Passo 6: revise cada diff antes que o cliente veja

Deixe os agentes trabalharem em uma branch e abrirem um pull request. Leia o diff, rode os testes e confira a página você mesmo. Clientes não pagam por código que um agente escreveu; pagam por código que alguém de confiança conferiu. Um resumo curto por escrito em cada pull request também facilita a atualização semanal para o cliente.

Tudo isso em uma janela com o AgentVera

Os passos acima funcionam com terminais comuns. O difícil é manter cinco clientes e dez agentes à vista. O AgentVera é um app de desktop para macOS, Windows e Linux que roda Claude Code, Codex, Gemini CLI e outros agentes lado a lado, cada um em um terminal real com a sua própria instalação e o seu próprio login. Para o trabalho de agência, o que importa é:

• Uma grade por projeto. Cada pasta de cliente tem o próprio conjunto de agentes, e você alterna entre clientes sem perder o estado deles. Veja workspace.
• Uma conta por agente. Adicione contas em Settings → Accounts e escolha uma ao criar um agente, para que os agentes de um cliente sempre rodem no login certo. Veja contas.
• Limites de tokens por agente. Limites por agente, por turno e por dia, um aviso em 80% e, ao atingir o limite, o agente para mas mantém a conversa. Veja orçamentos de tokens.
• Revisão de código antes da entrega. Revise as alterações do agente dentro do app antes que elas cheguem ao repositório do cliente. Veja revisão de código.

O plano gratuito inclui até 18 agentes, MCP, Git, Docker, SSH, revisão de código e economia de tokens. O Pro custa US$ 9,99 por mês; se você nunca teve um teste, seu primeiro login no app ativa o Pro por 7 dias sem cartão.

Para fechar

Agentes escalam para muitos clientes quando cada cliente tem uma fronteira clara: pasta própria, arquivo de instruções próprio, a conta certa, nenhum segredo de produção ao alcance, contagem de tokens própria e uma revisão humana antes da entrega. Configure isso uma vez por cliente e adicionar o sexto cliente leva minutos, não uma semana de limpeza.

Fontes: Claude Code settings, AGENTS.md.