Como usar Claude e Codex na empresa sem perder a governança

O que você vai encontrar neste artigo:

• Por que o uso individual de IA, sozinho, não vira governança
• As três camadas que organizam o trabalho: onde se produz, onde se registra e onde se executa
• Como dividir o uso entre os times sem travar ninguém
• O que pode e o que não pode entrar na conversa, e quem aprova o que sai dela
• O Notion como fonte da verdade da empresa: o que registrar e como nomear
• Boas práticas para o desenvolvimento com Claude Code e Codex: instruções no repositório, permissões, revisão e publicação
• Um checklist de uma página para a empresa se avaliar
• Onde a Bytebio entra: organizar o uso ou orientar as equipes

Em quase toda empresa, a IA chegou pela porta dos fundos. Alguém abriu uma conta, resolveu em vinte minutos uma tarefa que levaria uma tarde, contou ao colega, e em pouco tempo metade do time usava. A produtividade é real. O que não existe é o resto: ninguém sabe que dados foram colados em quais conversas, as boas análises moram em históricos pessoais, e a decisão tomada com ajuda da IA não deixou rastro além de uma frase no WhatsApp.

Proibir não resolve, porque a proibição só empurra o uso para fora da vista. Liberar tudo também não. O caminho é separar o que a IA faz bem, que é produzir, do que a empresa precisa guardar, que é o que decidiu e o que assumiu como verdade, e dar a cada coisa o seu lugar.

Este artigo propõe um desenho simples para isso. Os exemplos usam Claude e Codex, tanto no trabalho do dia a dia quanto no desenvolvimento, mas o desenho vale para qualquer assistente.

O problema não é a IA, é o trabalho que some

Quando cada pessoa usa a IA por conta própria, três coisas se repetem.

• O conhecimento fica preso na conversa. A análise que ficou boa, o texto aprovado, o critério que o time combinou em dez mensagens: tudo isso existe só no histórico de quem conversou. Quando essa pessoa sai de férias ou da empresa, o trabalho sai junto.
• O dado entra sem critério. Ninguém decidiu o que pode ser colado numa conversa. Cada um usa o próprio bom senso, e o bom senso de uma pessoa não é uma política da empresa.
• A ação fica sem dono. Quando o assistente passa a enviar mensagem, mexer em cadastro ou alterar código, a pergunta deixa de ser o que ele escreveu e passa a ser quem autorizou.

Nenhum dos três é um defeito da ferramenta. São lacunas de organização, e organização é trabalho da empresa, não do fornecedor da IA.

Três camadas, cada uma com seu papel

O desenho que usamos separa o trabalho em três camadas, cada uma com um lugar e uma regra.

A frase que resume o desenho é curta: o que importa sai da conversa. Quando um resultado vira decisão, documento ou código, ele é levado para a camada de registro ou de execução, com autor, data e origem. A conversa pode ser apagada sem prejuízo, porque o que valia dela já está num lugar que a empresa controla.

Isso tem uma consequência prática boa: a empresa deixa de depender de uma ferramenta específica. Se amanhã o time trocar de assistente, ou usar dois ao mesmo tempo, o conhecimento continua no mesmo lugar. Sobre por que o registro precisa existir antes de a IA entrar, vale ler documentar para não depender.

Organizar o uso entre os times

Dar acesso a todos e esperar que se organizem é o caminho mais curto para o problema do começo. Algumas decisões simples evitam isso.

Contexto por área, não por pessoa. Cada time (comercial, atendimento, financeiro, desenvolvimento) ganha um contexto-padrão: o que a empresa faz, o vocabulário, o tom, as regras que valem sempre. Sem isso, cada pessoa explica tudo de novo e cada uma recebe um resultado diferente para a mesma pergunta. O contexto é escrito uma vez, guardado no Notion e colado ou conectado onde a ferramenta permitir.

Papéis claros, e poucos. Quatro bastam para começar: quem usa; quem mantém o contexto de cada time; quem aprova conectores e acessos, em geral a área de TI ou de segurança; e quem responde pelos dados pessoais, em geral o jurídico ou o encarregado de dados.

O que é pessoal e o que é da empresa. Rascunho e exploração são livres. O que vira entrega para cliente, documento oficial ou decisão passa a pertencer à empresa e vai para o registro.

Biblioteca de pedidos que funcionam. O pedido que deu certo é um ativo. Quando alguém acerta um bom roteiro de análise ou um bom modelo de resposta, ele vai para uma página do Notion com dono e data, em vez de ficar na memória de uma pessoa.

Conta da empresa, não conta pessoal. Os recursos de administração variam por plano. A página do plano Enterprise do Claude lista, por exemplo, login único (SSO), provisionamento de usuários, controle de acesso por papel, logs de auditoria e controles de retenção de dados. Antes de escolher, confira o que o plano que a empresa vai contratar inclui, para o Claude e para o Codex, na documentação oficial de cada um. É dessa lista que sai a resposta para a pergunta que a TI vai fazer: quem acessou o quê e quando.

Dados: o que entra, o que não entra, o que sai

Três regras cobrem a maior parte do risco.

1. Classifique o dado em três níveis. Aberto (pode entrar em qualquer conversa), interno (entra só na conta da empresa) e restrito (dado pessoal sensível, de saúde, financeiro, e credenciais de qualquer tipo). O restrito não entra, ou entra só num ambiente que a empresa aprovou para isso. Credencial, senha e chave de acesso nunca entram, em nenhum nível. A base legal e a finalidade do tratamento de dado pessoal na LGPD são decisão do jurídico, e a classificação é o que torna essa decisão aplicável no dia a dia.

2. Conecte com a menor permissão possível. Quando o assistente se conecta a um sistema (CRM, agenda, drive, banco de dados), a regra é começar só com leitura, liberar escrita só onde há necessidade e revisar de tempos em tempos quem tem acesso a quê. Um conector por finalidade, com dono.

3. Humano aprova o que tem efeito externo. Enviar mensagem, publicar, apagar, pagar, alterar cadastro de cliente: o assistente propõe, a pessoa confirma. Quando a automação passa a ser recorrente e de alto volume, como um agente que atende cliente, o controle deixa de ser a aprovação a cada ação e passa a ser registro completo, versionamento e aprovação de mudança. É a diferença entre revisar cada resposta e revisar o sistema que responde.

Para o quadro geral de governança de IA e seus pilares, veja governança de IA: sucesso ou fracasso.

O Notion como fonte da verdade

A segunda camada só funciona se tiver forma. Notion é o que usamos e recomendamos, mas o que importa é o desenho: um lugar único, com regras de nome, de dono e de vigência.

O que se registra.

• Decisões: o que foi decidido, por quê, por quem, quando e que alternativas foram descartadas. É a página que responde, daqui a seis meses, "por que fizemos assim".
• Documentos finais: a versão vigente de política, proposta, manual, roteiro. Rascunho fica no Claude ou no Codex; o que vale fica aqui.
• Análises: com a pergunta, os dados de origem, a data e a conclusão. Uma análise sem data e sem origem envelhece sem aviso.
• Conversas relevantes: um banco com uma linha por conversa que produziu algo, com título específico, ferramenta de origem, resumo que dê para pesquisar, status e link para reabrir. Não se guarda tudo, só o que teve efeito.

Convenções mínimas. Título que diga o assunto, e não "Conversa 12". Fonte: a ferramenta e a data. Dono: uma pessoa, não um time. Status: rascunho, revisado, vigente ou substituído. Data de revisão, para que a página diga quando deixa de ser confiável.

Vigência e conflito. Quando duas páginas dizem coisas diferentes, o time precisa saber qual vale. Uma regra de precedência escrita (por exemplo, a instrução da direção vem antes da política publicada, que vem antes de uma proposta em andamento) resolve a maioria dos casos antes de virarem discussão.

Como a IA entra no registro. Quando a ferramenta se conecta ao Notion por um conector, ela lê e escreve nas mesmas páginas que o time usa. Quando não, a pessoa leva o resultado para lá. Nos dois casos, uma pessoa revisa antes de a página ganhar o status de vigente: o assistente rascunha, a empresa decide.

Na própria Bytebio é assim que funciona. As conversas que produzem algo viram uma linha num banco do Notion, com título, origem, resumo, status e o link para reabrir, e o conteúdo institucional parte de páginas do Notion tratadas como fonte, com ordem de precedência para quando há conflito.

Desenvolvimento com Claude Code e Codex

Em desenvolvimento, a governança tem uma vantagem: já existe uma cultura de versionamento, revisão e publicação. A boa prática é fazer o assistente entrar nessa cultura, e não contorná-la.

1. Instruções no repositório. O Claude Code lê o arquivo CLAUDE.md no início de cada sessão, e o Codex lê o AGENTS.md. Os dois ficam no repositório, versionados com o código e compartilhados pelo Git, então a instrução vale para toda a equipe e muda por revisão, como o resto. Ali entram os comandos de build e de teste, as convenções, o que nunca deve ser feito e onde estão as decisões. A documentação do Claude Code recomenda arquivos curtos, abaixo de 200 linhas, e concretos: "rode npm test antes do commit" funciona melhor que "teste suas mudanças". No Codex, os arquivos são lidos da raiz do repositório até a pasta de trabalho, com os mais próximos prevalecendo, e o conjunto é limitado a 32 KiB por padrão.

Um esqueleto enxuto, que serve para as duas ferramentas:

# Instruções do projeto

## Comandos
- Testes: npm test
- Build: npm run build

## Regras
- Nunca publicar em produção sem autorização de uma pessoa.
- Segredos ficam fora do repositório.
- Decisões em docs/DECISOES.md, estado atual em docs/ESTADO.md.

Se a equipe usa as duas ferramentas, um arquivo só resolve: nas versões recentes, o Claude Code lê o AGENTS.md quando não há CLAUDE.md, e aceita importá-lo com uma linha @AGENTS.md dentro do CLAUDE.md.

2. Instrução orienta, configuração garante. Esta é a distinção que mais se perde. Segundo a própria documentação, o Claude Code trata o CLAUDE.md como contexto, não como configuração imposta. O que precisa ser garantido, como impedir uma ação ou o acesso a um arquivo, vai em configurações gerenciadas, que a organização distribui às máquinas e que o cliente aplica independentemente do que o assistente decida, ou em hooks, que rodam em momentos fixos. O Codex tem a sua versão disso, com sandbox e aprovações de agente. Regra prática: o que "nunca pode acontecer" não é uma frase no arquivo de instruções, é um bloqueio.

3. Permissão mínima e ambiente isolado. O assistente começa lendo e pede aprovação para o que altera. Segredo fica fora do repositório e fora do contexto da conversa. Trabalho em ramo próprio, e não na principal.

4. O mesmo fluxo de entrega dos humanos. Ramo, pull request, revisão, testes automáticos, merge. O assistente abre o pull request; não publica direto na principal. Publicar em produção exige a autorização de uma pessoa, na hora, e a verificação de que build e testes passam antes.

5. Memória do projeto no repositório. Cada sessão começa sem lembrar da anterior. Um arquivo curto de estado, com o que estamos fazendo, onde paramos e o que vem a seguir, atualizado ao fim de cada etapa, faz qualquer sessão, de qualquer pessoa ou ferramenta, retomar do ponto certo. O Claude Code também guarda anotações automáticas, mas elas ficam na máquina de quem usa; o que a equipe precisa saber vai para o repositório.

6. Várias sessões em paralelo pedem fila. Com mais de uma sessão trabalhando no mesmo sistema, o risco muda de lugar. Já vimos acontecer: duas sessões publicando o mesmo sistema, e uma desfazendo sem querer a correção da outra. A solução é pequena e barata: um painel ou script que mostra o que está aberto, a ordem de integração e o que está no ar, e a regra de integrar uma mudança de cada vez.

7. App gerado por IA não é sistema. Um aplicativo montado em uma tarde numa plataforma como o Base44 prova a ideia, mas só vira ferramenta da empresa quando ganha permissão por perfil, suporte a volume, integração e um dono. Esse caminho está em vibe coding na empresa.

Checklist de uma página

Pessoas e contas

1. As contas são da empresa, com administrador definido, e não cartões pessoais.
2. Cada time tem um dono do contexto-padrão.
3. Existe uma pessoa que aprova conectores e acessos.

Dados

4. Os três níveis (aberto, interno, restrito) estão escritos e o time conhece.
5. Credencial, senha e chave nunca entram numa conversa.
6. Cada conector tem dono e a menor permissão possível.
7. Toda ação com efeito externo passa por aprovação de uma pessoa.

Registro

8. Decisões, documentos finais e análises vão para o Notion, com fonte, dono, status e data de revisão.
9. Há uma regra escrita de precedência para quando duas fontes divergem.
10. O assistente rascunha; uma pessoa dá o status de vigente.

Desenvolvimento

11. Cada repositório tem seu arquivo de instruções, curto e concreto.
12. O que não pode acontecer está em configuração, não só em instrução.
13. A mudança chega por ramo, revisão e testes; a publicação exige autorização.
14. Existe um arquivo de estado e, havendo várias sessões, uma fila.

Por onde começar

Não comece pela empresa inteira. Escolha um time e uma rotina em que a IA já é usada, e faça o desenho completo nela.

1. Defina o lugar do registro e a convenção de nome, dono e status. Meia página basta.
2. Escreva a política de uso em uma página: os três níveis de dado, o que exige aprovação e quem aprova.
3. No desenvolvimento, escreva o arquivo de instruções do repositório e mova para configuração o que não pode falhar.
4. Use, e depois revise. O que o time contornou mostra onde a regra estava errada. Ajuste a regra, não o time.

Depois que um time funciona, os outros copiam o desenho com os ajustes do próprio trabalho.

Como a Bytebio pode ajudar

A Bytebio é uma casa de engenharia de Ribeirão Preto, desde 2009, que coloca IA, automação e CRM em produção dentro de empresas que dependem da operação para faturar, e fica responsável pelo que constrói. Dentro de Operações Inteligentes, ajudamos a organizar o uso de Claude e Codex: o desenho das camadas, a estrutura de registro no Notion, as regras de dados e, no desenvolvimento, o arquivo de instruções, as permissões e o fluxo de entrega. Também orientamos as equipes, para que a prática continue funcionando depois que a consultoria termina.

Se a IA já é usada na sua empresa, mas o que ela produz ainda mora em conversas pessoais, fale com a Bytebio. Começamos conversando sobre como o trabalho acontece hoje e dizemos com franqueza por onde vale organizar primeiro.