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

URL: https://agentvera.dev/pt/blog/ai-coding-agents-for-agencies/ · Publicado: 2026-11-09

Como uma agência pode usar Claude Code, Codex e outros agentes de programação em vários projetos de clientes sem misturar contas, contexto, segredos ou custos.

**Resumo:**

- Uma pasta, um arquivo de instruções e, quando o cliente pedir, uma conta de agente por cliente. A maioria das confusões vem do contexto compartilhado, não do modelo.
- Dê a cada cliente o próprio CLAUDE.md ou AGENTS.md com o stack, as regras e o que o agente nunca deve tocar. Os agentes leem esse arquivo no início de cada sessão.
- Acompanhe os tokens por agente e revise cada diff antes que ele chegue ao cliente. O agente escreve o código; a agência continua responsável pelo que é entregue.

**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](/pt/blog/git-worktree-parallel-agents/) 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:

```markdown
# 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](/pt/blog/switch-claude-code-accounts/) 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](/pt/blog/claude-code-usage-limits/) 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](/pt/) é 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](/pt/features/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](/pt/features/account-switching/).
- **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](/pt/features/token-budgets/).
- **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](/pt/features/code-review/).

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](https://code.claude.com/docs/en/settings "Claude Code settings"), [AGENTS.md](https://agents.md/ "AGENTS.md format").

## Perguntas frequentes

**Uma agência pode usar uma única conta do Claude Code para todos os projetos de clientes?** Tecnicamente, sim: um agente trabalha na pasta em que você o inicia. Se você deve fazer isso depende do seu contrato e dos termos do provedor. Alguns clientes querem que o trabalho seja feito em uma conta que eles pagam ou controlam; nesse caso, dê a esse cliente um login próprio e uma pasta de configuração própria.

**Como evito que um agente misture o código de dois clientes?** Inicie cada agente na pasta do próprio cliente, nunca em uma pasta acima que contenha vários clientes, e coloque as regras do cliente em um CLAUDE.md ou AGENTS.md na raiz dessa pasta. Um agente só lê o que consegue alcançar a partir de onde começa.

**Como cobro de um cliente o uso de agentes de IA?** Meça tokens ou custo por agente e por pasta de cliente e depois decida se repassa pelo custo, inclui no seu valor ou ignora. Não dá para cobrar o que você não mediu, então configure isso antes do primeiro projeto, não depois.

**Os agentes devem fazer push direto no repositório do cliente?** Deixe o agente trabalhar em uma branch ou em um git worktree e abrir um pull request, e revise o diff você mesmo antes do merge. O cliente paga pelo seu julgamento, e é nessa etapa que ele aparece.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/