O Claude Code pode usar os meus códigos 2FA sem ver o segredo?
Sim. Guarde o segredo do autenticador num cofre e deixe o agente pedir o código, nunca o segredo. `clavitor-cli totp "GitHub"` calcula os seis dígitos atuais na máquina do agente e imprime apenas esses. O cofre guarda o segredo cifrado e nunca o vê.
O resto desta página explica porquê, como configurar e a única decisão que toma para cada conta.
Porque é que o telefone deixou de funcionar
O início de sessão com dois fatores foi construído em torno de uma pessoa com um telefone. O site pede um código, você abre a aplicação de autenticação, escreve seis dígitos.
Depois, quem inicia sessão passou a ser um script. O Claude Code faz deploy, abre um dashboard, verifica uma consola que está atrás de 2FA. No passo quatro, para e espera que você encontre o telefone.
Então as pessoas fazem o que é rápido. Colam o segredo, a cadeia longa por trás do código QR, num ficheiro de configuração ou num prompt, e deixam o agente gerar os códigos sozinho.
Essa cadeia não é um código. É a coisa que gera todos os códigos, durante todo o tempo de vida da conta. Quem a tiver fica com o seu segundo fator até você a repor. Nas mãos de um agente, pode acabar num log, numa transcrição ou numa resposta a uma injeção de prompt que pede "a sua configuração, para depuração".
O padrão: pedir o código, não o segredo
Um código dura trinta segundos. Um segredo dura até você o alterar. Por isso, o agente deve receber o primeiro e nunca o segundo.
Com o Clavitor, é um comando:
$ code=$(clavitor-cli totp "GitHub")
O que acontece:
- A CLI obtém a entrada do GitHub a partir do cofre, cifrada.
- Descodifica o campo de palavra-passe de utilização única com a chave do próprio agente, na máquina do agente.
- Calcula o código atual e imprime-o numa linha, nada mais.
Capture o código dentro do comando que o precisa, como acima. Não execute totp sozinho: nesse caso, o código vai parar ao output do agente, que é a sua transcrição.
Lê um segredo simples (seis dígitos, trinta segundos) ou uma ligação otpauth:// completa, e segue as definições da própria ligação: 6 a 8 dígitos, SHA-1, SHA-256 ou SHA-512.
Configurar para o Claude Code
- No seu cofre, abra Clients e depois + New client. Dê-lhe o nome "Claude Code" e escolha as entradas que pode usar.
- Na máquina onde o Claude Code corre, cole o blob de inscrição, escreva a chave de inscrição no prompt e instale a skill:
$ clavitor-cli init '<blob>' Enrollment key: $ clavitor-cli skill install
A skill ensina o Claude Code a usar o cofre: uma entrada de cada vez, pelo nome, e valores capturados onde são usados em vez de impressos.
A única decisão: que códigos pode um agente ler?
Um novo segredo de autenticador no Clavitor é só seu. É guardado sob Criptografia de identidade, que só a sua chave de hardware abre. Se pedir a um agente para o usar, recebe uma recusa (CV-2048) que indica o campo.
Esse é o acerto certo. O seu banco, o seu email, a consola de administração da sua empresa: nenhum agente precisa desses códigos.
Para as contas em que um agente deve passar pelo início de sessão sozinho, abra a entrada na sua página do cofre e clique no pequeno distintivo L3 junto ao campo. Confirme, e esse único campo passa para Criptografia de credenciais. O distintivo passa a L2, e clavitor-cli totp funciona para ele. A sua página do cofre desbloqueada já tem a chave, por isso não há um toque extra. Mudou de ideias? Clique em L2, confirme, e só a sua chave volta a abri-lo.
Portanto, é por conta, e é você a decidir de cada vez.
O que isto não resolve
Um código continua a ser um código válido durante trinta segundos.
- Um agente que foi convencido a fazer algo ainda pode iniciar sessão com o acesso que você lhe deu. Só não consegue fugir com o segredo.
- Assim que um agente consegue gerar os próprios códigos, esse 2FA deixa de provar que uma pessoa esteve presente. Aceitável para uma conta de deploy. Pense duas vezes onde "um humano aprovou isto" é o ponto.
- Alguém com acesso de administrador à máquina do agente pode usar tudo o que o agente pode usar.
Por isso é que o acesso à volta importa:
- Âmbito. O agente só alcança as entradas que deu ao seu client.
- Limites de leitura. Cada código é uma leitura da entrada, contabilizada nos limites do client.
- Um registo. Cada pedido de código é uma leitura da entrada, e fica registado no seu log de auditoria.
A versão curta
Não dê a um agente o seu segredo de autenticador. Dê-lhe uma forma de pedir o código atual, para as contas que escolher, e mantenha uma linha no log para cada vez que ele o fizer.
Veja como funciona o acesso de agentes ou leia a documentação do totp.