Codici 2FA per Claude Code, Codex e Cursor sul Mac

Chiedi a Claude Code di accedere a un sito e di controllare una cosa. L’agente trova la pagina, inserisce la tua email, fa clic su Invia codice e si ferma: il codice è arrivato sul telefono e l’agente non può leggerlo.

In breve: installa CodeCatch, attiva Let Agents Ask for Codes in Settings → Agents e fai clic su Connect accanto al tuo agente. Quando un sito invia un codice, l’agente lo chiede a CodeCatch e tu lo approvi con Touch ID.

Perché gli agenti AI si bloccano sulla 2FA

L’autenticazione a due fattori serve a fermare chi conosce solo la tua password. Ed è proprio la situazione di un agente: sa usare il browser, ma il codice arriva in Messaggi o nella tua casella di posta. Così aspetta che tu lo inserisca, oppure rinuncia.

Come aiuta CodeCatch

CodeCatch raccoglie già i codici che arrivano sul Mac da Messaggi e dalla posta. Ora anche un agente può chiedergliene uno, con un breve comando:

codecatch get github.com

CodeCatch aspetta il codice di github.com, poi ti mostra una scheda con l’app che lo chiede, il mittente e l’ora. Fai clic su Allow e confermi con Touch ID. L’agente riceve il codice e lo inserisce.

Configurazione in tre passaggi

1. Installa CodeCatch e dai l’accesso a Messaggi e alla posta, come al solito.
2. Apri Settings → Agents e attiva Let Agents Ask for Codes. Così installi anche il comando codecatch.
3. Fai clic su Connect accanto a Claude Code, Codex o Cursor. Questo aggiunge una piccola skill, che l’agente legge solo quando gli serve un codice. Per gli altri agenti, copia il testo sotto Other Agents nelle loro istruzioni.

Il pallino verde vuol dire che l’agente è collegato. Cursor legge anche le skill di Claude Code e di Codex, quindi basta collegare uno dei due. Finché l’opzione Let Agents Ask for Codes è disattivata, il resto della pagina resta in grigio e gli agenti non possono chiedere codici.

Cosa decidi tu

• Ogni codice va approvato. Per Allow serve ogni volta Touch ID o la password del Mac.
• Always Allow salta la richiesta per un sito, o per tutti i siti, quando a chiedere è una certa app.
• Allow All Without Asking dà i codici a qualsiasi agente senza chiedere. Anche per attivarlo serve Touch ID.
• I link di accesso hanno un interruttore a parte e sono disattivati di default, perché un link fa accedere l’agente a nome tuo.
• I link per reimpostare la password non vanno mai agli agenti.

Come CodeCatch protegge i codici

• Il comando parla con CodeCatch attraverso un socket che sul tuo Mac puoi aprire solo tu. Niente passa dalla rete.
• CodeCatch riconosce l’app che fa la richiesta dalla sua firma digitale. Il comando, a sua volta, verifica di parlare con il vero CodeCatch.
• Un codice vale solo se arriva dal dominio del sito. Un’email che si presenta come “GitHub” ma arriva da un altro dominio non vale come codice di GitHub.
• Una richiesta alla volta. Tre rifiuti di fila disattivano l’accesso degli agenti. Le regole danno al massimo 20 codici l’ora.
• La Request History mostra quale app ha chiesto il codice di quale sito e com’è andata. Il codice non lo conserva mai.

C’è però un limite: se un programma ha già l’Accesso completo al disco, può leggere da solo Messaggi e Mail. CodeCatch non può impedirlo.

Per sviluppatori e script

Con --json ricevi il codice e i dettagli in JSON. Con --since salti i codici arrivati prima del tuo clic su Invia codice:

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

Il comando aspetta il codice fino a 90 secondi, più il tempo che ti serve per approvarlo. Dal codice di uscita lo script capisce cosa fare: 0 = ok, 2 = hai rifiutato, 3 = nessun codice arrivato, 4 = accesso disattivato, 5 = non approvato in tempo. Il resto è in codecatch --help.

Domande