Adotar Codex em uma empresa não é apenas instalar uma ferramenta. O agente pode ler arquivos, editar código, executar comandos, acessar rede e conectar sistemas dentro das permissões concedidas. A governança define quais dessas capacidades existem em cada contexto.
O objetivo não é impedir o trabalho. É tornar acesso, aprovação, evidência e responsabilidade compatíveis com o risco.
Em uma frase: o Codex deve receber o menor acesso capaz de concluir a tarefa, em ambiente controlado, com revisão humana onde o impacto exige.
Comece pelos casos de uso
Liste tarefas reais antes de discutir configurações:
- revisar um diff;
- criar testes;
- corrigir interface;
- gerar script interno;
- consultar documentação;
- integrar API de teste;
- publicar preview;
- executar deploy;
- acessar dados de cliente.
Classifique cada caso por dado, ação e reversibilidade. “Usar Codex” é amplo demais para uma política.
Quatro níveis de risco
Nível 1 — leitura pública ou local controlada
Documentação pública, repositório sem segredo e análise sem alteração.
Nível 2 — escrita reversível
Editar branch, criar arquivo, executar teste local e gerar preview.
Nível 3 — integração com dados internos
Acessar sistemas, registros de cliente, repositório privado ou ambientes compartilhados.
Nível 4 — ação externa ou produção
Deploy, exclusão, alteração de acesso, mensagem, pagamento ou mudança difícil de reverter.
Quanto maior o nível, mais fortes devem ser isolamento, aprovação, log e rollback.
Menor privilégio
Menor privilégio significa conceder apenas:
- pasta necessária;
- comandos necessários;
- domínios necessários;
- credencial com escopo necessário;
- ambiente necessário;
- duração necessária.
Não dê acesso administrativo porque uma operação de leitura falhou. Ajuste a ferramenta ou a credencial para o caso específico.
A documentação oficial de permissões e as páginas de sandboxing descrevem controles disponíveis no Codex. Confirme as opções atuais da interface e do workspace usado pela empresa.
Sandboxing e ambientes
O sandbox limita o que comandos e processos podem alcançar. Ele não substitui a separação de ambientes.
Use:
- máquina ou container de desenvolvimento;
- branch ou worktree;
- banco de teste;
- dados sintéticos ou sanitizados;
- credenciais separadas;
- domínios de homologação;
- storage temporário;
- preview antes de produção.
Não aponte um teste para o banco de produção por conveniência. Se a tarefa exige dado real, crie uma cópia protegida e minimize conteúdo.
Aprovações
Aprovação deve ocorrer perto da ação que aumenta risco. A documentação de segurança e aprovações detalha como o Codex trabalha com permissões e controles.
Exija confirmação para:
- sair do sandbox;
- usar rede não prevista;
- acessar segredo;
- instalar dependência;
- modificar grande volume;
- publicar;
- apagar;
- enviar comunicação;
- alterar permissão;
- operar produção.
Uma aprovação de plano não é necessariamente aprovação de deploy. Especifique a próxima ação e o alvo.
Proteção de segredos
Nunca coloque tokens, senhas ou chaves em:
- prompt;
AGENTS.md;- commit;
- screenshot;
- log;
- documentação compartilhada;
- pacote entregue a cliente.
Use variáveis de ambiente, cofres ou mecanismos de identidade. Crie credenciais por serviço e ambiente. Limite escopo, tempo e origem. Registre como revogar.
Se um segredo aparece na saída, trate como exposição: remova do histórico quando possível, revogue e substitua.
Leia também: Como avaliar skills, plugins e servidores MCP
Rede e internet
Rede amplia tanto capacidade quanto superfície de risco. Defina:
- domínios permitidos;
- métodos HTTP;
- download e upload;
- proxies e logs;
- tratamento de conteúdo externo;
- política para dependências;
- bloqueio de endpoints privados;
- revisão de ações autenticadas.
Conteúdo de site, issue ou repositório é entrada não confiável. Uma instrução encontrada em arquivo externo não deve substituir a política da empresa.
Plugins, MCPs e skills
Governança precisa de inventário. Para cada extensão, registre:
- origem e versão;
- responsável;
- finalidade;
- ferramentas expostas;
- dados acessados;
- permissões;
- credenciais;
- ambientes;
- data do último teste;
- processo de remoção.
Admins podem aplicar controles de plugins, skills e conectores conforme o produto e plano. Consulte a área oficial de administração e governança para recursos atuais.
Instalar não significa aprovar para sempre. Revisões periódicas removem acessos abandonados.
Dados e privacidade
Classifique dados antes de usar:
| Classe | Exemplo | Tratamento inicial |
|---|---|---|
| Público | Site e documentação | Uso permitido com fonte |
| Interno | Processo e código privado | Workspace e acesso controlados |
| Confidencial | Estratégia, preço, contrato | Necessidade, minimização e registro |
| Restrito | Saúde, finanças, credenciais | Política específica e acesso excepcional |
Verifique contrato, requisitos legais, residência, retenção, treinamento, logs e exclusão aplicáveis ao produto usado. Não presuma que uma configuração de conta pessoal vale para uma oferta empresarial.
Repositórios e instruções
O AGENTS.md pode registrar:
- proibição de tocar produção;
- comandos de teste;
- áreas restritas;
- política de dependência;
- segurança de logs;
- exigência de preview;
- formato de evidência.
O guia Briefing e AGENTS.md para Codex explica como escrever regras testáveis sem colocar segredo ou política inteira no repositório.
Code review e segregação de função
Quem implementa não deve ser a única fonte de aprovação. Use revisão de diff, testes e responsável pelo negócio.
Para mudanças sensíveis:
- Codex implementa em ambiente isolado;
- testes automáticos executam;
- Codex ou outra revisão analisa o diff;
- humano confirma findings e impacto;
- dono do sistema aprova publicação;
- deploy registra versão e rollback.
Leia Codex para testes e code review para separar findings de fatos confirmados.
Logs e evidências
Registre o suficiente para responder:
- quem iniciou;
- qual objetivo;
- que ambiente;
- quais ferramentas;
- que arquivos mudaram;
- quais comandos rodaram;
- que aprovações ocorreram;
- qual resultado;
- qual versão foi entregue.
Evite gravar o conteúdo de segredos ou dados pessoais em logs. Auditoria não deve criar novo vazamento.
Política de dependências
O agente pode sugerir bibliotecas para acelerar. Exija justificativa, licença, manutenção, vulnerabilidades, tamanho e alternativa nativa.
Em projeto estável, adicionar pacote por uma função simples aumenta superfície de atualização. Registre dependências novas no review.
Produção e rollback
Antes de produção:
- backup testado;
- versão identificada;
- migração revisada;
- monitoramento ativo;
- janela de mudança;
- responsável disponível;
- critério de abortar;
- rollback documentado.
O Codex pode executar um deploy autorizado. A empresa continua responsável por alvo, horário, validação e reversão.
Plano de adoção em 30 dias
Semana 1 — inventário
Escolha três casos de baixo risco, mapeie dados e defina responsáveis.
Semana 2 — ambiente
Configure repositórios, sandbox, credenciais de teste e AGENTS.md.
Semana 3 — pilotos
Execute tarefas com evidência. Meça tempo, findings, falhas e revisão.
Semana 4 — política
Documente permissões, aprovações, extensões permitidas, logs, produção e incidentes. Só então amplie casos.
Resposta a incidente
Defina antes:
- interromper a tarefa;
- preservar evidências sem expor mais dados;
- revogar credencial;
- identificar arquivos e sistemas afetados;
- restaurar ou reverter;
- comunicar responsáveis;
- corrigir regra, ambiente ou ferramenta;
- registrar aprendizado.
Um incidente não é resolvido apenas apagando a conversa.
Erros comuns
- política genérica de “usar IA com cuidado”;
- mesma credencial para desenvolvimento e produção;
- acesso administrativo permanente;
- segredo em prompt;
- plugin sem inventário;
- rede aberta por padrão;
- deploy autorizado por aprovação vaga;
- log com dados sensíveis;
- implementação sem revisor;
- ausência de rollback;
- expansão antes de medir pilotos.
Matriz mínima de controle
| Ação | Ambiente | Aprovação | Evidência |
|---|---|---|---|
| Ler código | Dev isolado | Política do time | Arquivos consultados |
| Editar | Branch/worktree | Briefing aprovado | Diff |
| Testar | Dev/teste | Automática quando segura | Comando e saída |
| Acessar dado interno | Fonte limitada | Dono do dado | Log sanitizado |
| Publicar preview | Homologação | Responsável técnico | URL e QA |
| Produção | Produção | Aprovação explícita | Versão, monitoramento e rollback |
Checklist de governança
- Casos de uso foram classificados por risco?
- Acesso segue menor privilégio?
- Desenvolvimento e produção estão separados?
- Segredos ficam fora de prompts e repositórios?
- Rede e MCPs têm escopo conhecido?
- Ações sensíveis exigem aprovação específica?
- Testes e review têm evidência?
- Logs são úteis e sanitizados?
- Há dono, revisão periódica e remoção?
- Backup, monitoramento e rollback existem?
- Incidentes têm procedimento?
Governança não é uma camada colocada depois que o Codex já está em toda a empresa. É o desenho que permite ampliar o uso sem transformar produtividade em acesso invisível e risco acumulado.
Papéis em uma adoção empresarial
Dono do caso de uso
Define resultado, dados necessários, risco e métrica. Decide se o processo gera valor.
Administrador do workspace
Configura identidades, grupos, plugins, políticas e visibilidade conforme os recursos contratados.
Responsável técnico
Define ambiente, repositório, testes, segredos, rede e rollback.
Segurança ou privacidade
Revisa dados, fornecedores, retenção, logs, acesso e incidentes de acordo com o risco.
Usuário
Segue o caso aprovado, revisa saídas e reporta falhas. Não amplia permissões por conta própria.
Em empresas pequenas, a mesma pessoa pode acumular papéis. As responsabilidades ainda precisam estar explícitas.
Perguntas para aprovar um novo caso
- Que resultado será produzido?
- Que dados entram e saem?
- O agente apenas lê ou também altera?
- A ação é reversível?
- Que ambiente será usado?
- Qual credencial e escopo?
- Quem revisa?
- Que evidência fica?
- Como interromper e revogar?
- Qual métrica define sucesso?
Se a equipe não consegue responder, o piloto ainda não está pronto.
Revisão trimestral
Liste usuários, casos, credenciais, plugins, MCPs, ambientes e tarefas recorrentes. Remova o que não tem dono ou uso. Reexecute uma amostra de controles e simule revogação.
Compare incidentes, exceções de aprovação, permissões ampliadas e dependências novas. Uma política que nunca encontra desvio pode estar perfeita — ou pode não estar sendo observada.
Indicadores de governança
- casos aprovados e ativos;
- acessos por nível de risco;
- credenciais sem uso;
- plugins fora da versão aprovada;
- ações bloqueadas ou escaladas;
- incidentes e tempo de contenção;
- percentual de mudanças com testes;
- percentual de produção com rollback;
- revisões concluídas no prazo;
- valor entregue por caso.
Governança boa reduz surpresa sem sufocar a execução. Métricas devem orientar correção, não incentivar usuários a esconder experimentos.
Política curta para começar
Codex pode operar somente em casos aprovados e ambientes definidos.
Dados e acessos seguem menor privilégio. Segredos nunca entram em prompts ou commits.
Produção, exclusão, comunicação externa e alteração de permissão exigem aprovação específica.
Toda entrega registra diff ou artefato, testes, responsável e rollback quando aplicável.
Plugins, skills e MCPs precisam de inventário, proprietário e revisão periódica.
Incidentes devem interromper o fluxo e acionar revogação e análise.
Essa política não substitui controles técnicos e documentos legais. Ela cria um ponto de partida compreensível para toda a equipe.
Publique a política junto dos canais de suporte e incidente. Uma regra que ninguém encontra no momento da decisão não funciona como controle.
Perguntas frequentes
Codex é seguro para empresas? +
Pode fazer parte de um uso seguro quando configuração, dados, acessos, ambiente e revisão são compatíveis com o risco. Nenhum agente elimina a necessidade de governança.
O que é menor privilégio? +
É conceder somente os arquivos, comandos, rede e credenciais necessários para a tarefa, pelo tempo necessário, evitando acesso amplo por conveniência.
Posso colocar chaves de API no prompt? +
Não. Use mecanismos de segredo e variáveis de ambiente apropriados, limite escopos e evite que valores apareçam em logs, arquivos ou respostas.
Quais ações devem exigir aprovação? +
Publicação, deploy, exclusão, alteração de dados, comunicação externa, acesso a informações sensíveis e qualquer ação difícil de reverter.
Como começar a governança? +
Inventarie casos de uso, classifique dados e ações, defina ambientes, permissões, responsáveis, testes, evidências e critérios para ampliar o acesso.