Códigos 2FA para Claude Code, Codex e Cursor no Mac

Você pede ao Claude Code para entrar num site e conferir uma coisa. Ele acha a página, digita seu e-mail, clica em Enviar código e para por aí. O código foi para o seu celular, e o agente não tem como ler.

Resposta curta: instale o CodeCatch, ative Let Agents Ask for Codes em Settings → Agents e clique em Connect ao lado do seu agente. Quando o site enviar um código, o agente pede esse código ao CodeCatch, e você aprova com Touch ID.

Por que agentes de IA travam no código 2FA

A verificação em duas etapas existe para barrar quem só tem a sua senha. O agente está justamente nessa situação: ele usa o navegador, mas o código vai para o Mensagens ou para a sua caixa de entrada. Então ele fica esperando você digitar o código, ou desiste.

Como o CodeCatch ajuda

O CodeCatch já pega os códigos que chegam no Mensagens e no e-mail do seu Mac. Agora um agente também pode pedir um código a ele, com um comando curto:

codecatch get github.com

O CodeCatch espera o código do github.com e mostra um cartão com o app que fez o pedido, o remetente e a hora. Você clica em Allow e confirma com Touch ID. O agente recebe o código e preenche o campo.

Configure em três passos

1. Instale o CodeCatch e deixe que ele leia o Mensagens e o seu e-mail, como de costume.
2. Abra Settings → Agents e ative Let Agents Ask for Codes. Isso também instala o comando codecatch.
3. Clique em Connect ao lado do Claude Code, do Codex ou do Cursor. Isso adiciona uma pequena skill, que o agente só lê quando precisa de um código. Para outros agentes, copie o texto de Other Agents e cole nas instruções deles.

O ponto verde indica que o agente está conectado. O Cursor também lê as skills do Claude Code e do Codex, então ele já fica coberto quando um dos dois está conectado. Enquanto Let Agents Ask for Codes estiver desativado, o resto da aba fica acinzentado e os agentes não podem pedir códigos.

O que você controla

• Todo código passa por você. Cada Allow pede Touch ID ou a senha do Mac.
• Always Allow para de perguntar quando o pedido vem de um app específico, para um site ou para todos.
• Allow All Without Asking deixa qualquer agente pegar códigos sem perguntar. Para ativar essa opção, também é preciso Touch ID.
• Links de login têm uma opção própria, que vem desativada, porque com o link o agente entra na conta como se fosse você.
• Links de redefinição de senha nunca vão para agentes.

Como o CodeCatch protege o acesso

• O comando fala com o CodeCatch por um socket que só você pode abrir no seu Mac. Nada passa pela rede.
• O CodeCatch verifica a assinatura de código do app que faz o pedido. E o comando confirma que está falando com o CodeCatch de verdade.
• Um código só vale se vier do próprio domínio do site. Um e-mail com o nome “GitHub”, mas enviado de outro domínio, não conta como código do GitHub.
• Um pedido por vez. Três recusas seguidas desativam o acesso dos agentes. As regras automáticas liberam no máximo 20 códigos por hora.
• Em Request History você vê qual app pediu código de qual site e o que aconteceu. O código em si nunca fica salvo ali.

Sendo honesto, há um limite: se um programa já tem Acesso Total ao Disco, ele consegue ler o Mensagens e o Mail sozinho. Isso o CodeCatch não tem como impedir.

Para desenvolvedores e scripts

Use --json para receber o código e os detalhes em JSON, e --since para ignorar códigos que chegaram antes de você clicar em Enviar código:

T=$(date +%s)
# click "Send code" on the site, then:
codecatch get github.com --since $T --json

O comando espera até 90 segundos pelo código, mais o tempo que você leva para aprovar. Os códigos de saída dizem ao script o que fazer em seguida: 0 = OK, 2 = você recusou, 3 = nenhum código chegou, 4 = acesso desativado, 5 = sem aprovação a tempo. O resto está em codecatch --help.

Perguntas frequentes