Governança de Claude Code na empresa: as cinco respostas antes de liberar o agente

Claude Code roda na máquina do dev, com as permissões dele, e alcança código, credencial e nuvem. As cinco respostas, o inventário de três colunas e o registro que vão te pedir.

O agente roda nesta mesa, com as permissões de quem senta nela

Antes de liberar Claude Code, ou qualquer agente de código, dentro da sua empresa, você precisa de cinco respostas. Nenhuma delas é sobre o modelo:

1. Em qual máquina o agente roda e com quais permissões ele executa cada comando.
2. Quais credenciais essa máquina alcança hoje sem pedir senha a ninguém.
3. O que fica registrado de cada sessão: o pedido, os comandos executados, o que mudou no repositório.
4. Quem aprova o que o agente escreveu antes daquilo chegar no seu cliente.
5. Quanto cada tarefa custa e quem lê essa conta no fim do mês.

O CIO.com publicou anteontem uma matéria com as cinco coisas que um CIO precisa entender para governar Claude Code. A primeira é justamente a que ninguém levanta na reunião de aprovação: o agente roda localmente na estação de trabalho do funcionário, executa comandos com as permissões daquele funcionário e, desse lugar, alcança código-fonte, credenciais, ambientes de nuvem e os sistemas conectados. A assinatura tem cara de ferramenta de produtividade. O que foi assinado é uma concessão de acesso.

O crachá que você entregou sem olhar o que ele abre

Na obra a portaria anota quem entrou. No software o acesso só acumula

Antes de entregar software, eu fui responsável técnico de estrutura metálica em obra. Lá, ninguém entra no canteiro sem assinar na portaria, sem crachá e sem alguém saber a que ele veio. A chave do contêiner de ferramenta tem dono com nome. Se o cabo de solda desaparece, você sabe em meia hora quem tinha acesso à chave, porque a lista existe em papel.

Agora olhe a conta de um desenvolvedor sênior que está na sua empresa há uns três anos. Ela acumulou acesso do jeito que acesso acumula: chave de meio de pagamento num arquivo de ambiente de um projeto de 2022, token de integração contínua com permissão de escrever em qualquer repositório, credencial de leitura num banco que tem dado real de cliente porque uma vez precisou reproduzir um bug, perfil de administrador num painel de nuvem usado numa madrugada de incidente e nunca revogado.

Enquanto é gente digitando, cada um desses acessos só é usado quando a pessoa decide usar. Com agente, a escolha de qual comando rodar sai do objetivo descrito em uma frase, e o caminho até o objetivo é a máquina que monta. Essa autonomia é o ponto da ferramenta, e é também o que muda a pergunta da reunião. Ela deixa de ser "eu confio nesse profissional" e passa a ser "o que essa estação de trabalho alcança a partir de uma frase".

Tem uma coisa que piora a conta em quem herdou sistema de terceiro. Quando a gente entra num código que a casa não escreveu, e já escrevi sobre os sete primeiros dias de um sistema herdado, o inventário de credencial é a parte que nunca vem documentada. Chave antiga fica no histórico do repositório, viva, esperando alguém pedir.

Chave, dono, última troca: o inventário que cabe numa planilha

Antes de ligar agente em qualquer repositório, aqui dentro a gente responde três colunas:

• Chave: qual credencial existe, onde ela está escrita e o que exatamente ela abre, com o nome do sistema do outro lado.
• Dono: qual pessoa responde por aquela chave hoje, não qual time, porque time não é responsável por nada às três da manhã.
• Última troca: em que data aquela credencial foi rotacionada pela última vez, e por quem.

No sistema de gestão que eu construo para a Revin, esse inventário tem umas 30 e poucas linhas. Não é bonito. É uma tabela. A terceira coluna é a que mais machuca, porque quase sempre a resposta honesta é "nunca", e isso coloca uma pergunta de propriedade na mesa: de quem é o seu código e de quem são as chaves que abrem a casa dele.

Feito o inventário, a decisão de liberar o agente fica simples. Você não precisa de política de dez páginas. Precisa saber quais dessas linhas estão ao alcance da máquina onde o agente vai rodar e cortar as que não deveriam estar lá antes da primeira sessão.

"Meu time é sênior, isso é paranoia"

No arquivo que é o caixa, quem aprova continua tendo nome e sobrenome

Essa frase aparece em call comercial toda semana, e ela tem meia razão. Ninguém está desconfiando do seu sênior. O que mudou é o volume e a origem do que entra no sistema.

Segundo pesquisa da Sonar com mais de 1.100 desenvolvedores profissionais, publicada pelo CIO.com, perto de 72% de quem experimentou ferramenta de IA para código passou a usar todo dia, e uns 42% do código que chega a produção já sai delas, com projeção de 65% para o ano que vem. No mesmo levantamento, 96% dizem não confiar plenamente no que recebem. Então a sua empresa já está no cenário em que quase metade do código novo nasce de uma frase, e quem escreve a frase não controla cada passo do caminho.

Paciência com a palavra governança, que soa a slide de consultoria. Na prática aqui ela significa duas tabelas e uma reunião de quinze minutos.

O registro que alguém vai te pedir no dia do incidente

Imagine que, numa terça, um cliente seu abre uma tela e vê o pedido de outro cliente. Isso acontece, e o problema raramente é o modelo: é uma consulta que perdeu o filtro de empresa. A pergunta que o seu jurídico vai fazer no mesmo dia tem quatro partes: qual sessão gerou aquela mudança, qual era o pedido original, qual comando rodou no ambiente e quem aprovou a entrada em produção.

Se a resposta para qualquer uma das quatro for "a gente não guarda", você vai reconstruir a história por memória de gente. Já vi isso custar uma semana de três pessoas. É a mesma lógica de quem descobriu a queda primeiro, você ou o seu cliente: quando a instrumentação não existe, o cliente é o seu sistema de monitoramento.

Registro de sessão de agente é barato de ligar e caro de não ter. Guarde o pedido, o diff e o nome de quem aprovou. Seis meses, no mínimo.

A revisão continua tendo nome e sobrenome

Agente escreve rápido e escreve plausível. Esses são dois atributos diferentes de correto. A parte chata da revisão ele faz bem, e eu escrevi em detalhe até onde dá para tirar o humano do pull request. O que não muda de dono é a decisão sobre regra de negócio, sobre o que acontece quando dá erro e sobre o que vai cobrar cartão de cliente.

Na prática, o que a gente faz antes de liberar agente num repositório é separar o sistema em dois tipos de lugar. Tem arquivo que é vitrine, onde um erro é feio e reversível. E tem arquivo que é o caixa, onde um erro é dinheiro saindo. No segundo, humano aprova linha por linha, com teste que verifica resultado e não só roda sem estourar.

A conta que chega sem nota

A quinta resposta é a mais prosaica e a que estoura mais rápido. Uso de agente é consumo, e consumo sem rateio por tarefa vira uma fatura que ninguém sabe explicar na reunião de custo. Ponha o preço de cada pedido na tela de quem aperta o botão, antes de rodar, e depois leia a conta junto com a entrega. É o mesmo raciocínio de como medir o ROI de IA no desenvolvimento sem contar linha de código: o numerador é mudança que ficou de pé em produção, o denominador é tudo que você pagou para ela entrar.

Onde essa régua falha

Não sei se isso vale para quem tem dois desenvolvedores e nenhum cliente pagante ainda. Numa empresa desse tamanho, montar inventário de chave antes do primeiro usuário real é otimizar o que não existe, e eu mesmo não faria. A régua começa a valer no dia em que existe dado de terceiro no banco e contrato assinado com cláusula de confidencialidade, o que em geral acontece antes de alguém perceber.

E existe o caso em que o conselho sai caro: equipe que já opera com credencial de curta duração, acesso pedido na hora e revogado depois. Ali o inventário é redundante, e a conversa inteira muda de lugar.

Fora desses dois extremos, a pergunta para levar à sua reunião de segunda é curta. Abra a máquina de um desenvolvedor do seu time, liste o que aquela estação alcança sem digitar senha nenhuma, e diga em voz alta se você autorizaria esse mesmo acesso a um fornecedor que você contratou ontem. Porque, do ponto de vista do seu sistema, é exatamente isso que um agente é.