La freccia sullo schermo

Cos'è e perché conta

A volte Claude Code ha bisogno di un tuo clic: un permesso del Mac, una finestra che chiede conferma, un'impostazione da accendere. E lo scrive nel terminale: «clicca su Consenti». Solo che tu non stai guardando il terminale. E quando ci arrivi, quel bottone lo devi ancora trovare, in mezzo a dieci finestre.

big-arrow-on-the-screen risolve proprio questo. Il comando si chiama bigarrow: è un piccolo programma per Mac che disegna sopra tutte le finestre una freccia grande con un cartello, tipo «Clicca Consenti». Insieme arriva una skill, cioè un file di istruzioni che Claude Code legge quando gli serve: gli insegna quando indicare e come. I clic passano attraverso la freccia, la tastiera resta dove stavi scrivendo, e la freccia sparisce da sola.

È un progetto open source di terze parti, con licenza MIT: non è di Anthropic. È gratis, il codice è su GitHub (github.com/franzenzenhofer/big-arrow-on-the-screen) e funziona solo su Mac. Serve a chi passa la giornata con Claude Code e si perde tra finestre e impostazioni. E anche a chi aiuta qualcuno meno pratico.

1. Installalo con Homebrew

Homebrew è il gestore di pacchetti più usato su Mac: installa programmi dal terminale con un comando. Se non ce l'hai, lo trovi su brew.sh. Poi nel terminale scrivi:

brew install franzenzenhofer/tap/bigarrow

Homebrew lo compila sul tuo Mac, quindi ti servono Xcode installato e macOS 14 o successivo. Per controllare che sia andato tutto bene, scrivi bigarrow --version: deve rispondere con la versione installata.

2. Insegnalo a Claude Code

Il programma da solo non basta: Claude deve sapere che esiste e quando usarlo. Questo comando copia la skill tra le skill personali di Claude Code, nella cartella ~/.claude/skills, così vale in tutti i tuoi progetti (installa anche quella per Codex):

bigarrow install-skill

Apri una sessione nuova di Claude Code. Da lì Claude la usa da solo quando gli serve un tuo clic, oppure la chiami tu scrivendo /big-arrow. Per disegnare la freccia non serve nessun permesso del Mac, quindi puoi provarla subito:

Con bigarrow disegna una freccia che indica il centro del mio schermo, con scritto «Funziona». Poi toglila.

3. Il permesso di Accessibilità, solo per indicare per nome

La freccia può puntare in due modi. A coordinate, cioè su un punto preciso dello schermo: nessun permesso. Oppure per nome: Claude chiede al Mac dov'è il bottone «Consenti» in quell'app e ci punta sopra. Questo è il modo più preciso, e richiede il permesso di Accessibilità.

Il dettaglio che frega tutti: il permesso non va a bigarrow, ma all'app da cui usi Claude Code. Se lo usi nel Terminale va al Terminale; se lo usi in iTerm2, Ghostty, VS Code o nell'app Claude, va a quella.

1. Apri Impostazioni di Sistema, poi Privacy e sicurezza, poi Accessibilità. Nelle versioni più recenti di macOS la voce può avere un altro nome: se manca il permesso, l'errore di bigarrow ti dice l'app e la schermata giusta.
2. Accendi l'interruttore dell'app da cui usi Claude Code. Se non è nell'elenco, aggiungila con il pulsante +.
3. Nel terminale scrivi bigarrow doctor. Ti mostra i permessi e gli schermi collegati, e ti dice a quale app va dato il permesso.

4. I prompt per farti indicare, invece di scrivere

La skill dice già a Claude di indicare invece di scrivere. Io però lo metto anche nero su bianco nel CLAUDE.md, il file di regole che Claude legge a ogni sessione, così non se ne dimentica:

Quando ti serve un mio clic, non scrivermi «clicca su…»: apri tu la schermata giusta e indicami il bottone con bigarrow, con un cartello che dice cosa fare e cosa succede dopo il clic.

E quando sei tu a non trovare una cosa nel Mac, o in un'app:

Non trovo dove si attiva [l'impostazione]. Apri tu la schermata giusta e indicami con bigarrow cosa toccare, un passo alla volta. I clic li faccio io.

Se devi incollare qualcosa, un codice o un comando, il valore può stare sul cartello come pulsante da copiare: un clic e ce l'hai negli appunti.

Devo incollare [il valore] in [app]. Indicami il campo giusto con bigarrow e metti il valore sul cartello come pulsante da copiare.

5. Fai sparire la freccia quando rispondi

Ogni freccia finisce da sola: dopo un tempo massimo (di base 8 secondi per una freccia veloce, 5 minuti per una che resta finché serve), quando Claude la toglie con bigarrow stop, o quando si chiude la sessione di Claude che l'ha disegnata. Se clicchi sul cartello o sull'asta, sparisce.

In più c'è un hook, cioè un comando che Claude Code lancia da solo in un momento preciso. Questo parte ogni volta che mandi un messaggio a Claude e toglie le frecce di quella sessione: hai risposto, quindi la freccia non serve più. Va nel file ~/.claude/settings.json:

{
  "hooks": {
    "UserPromptSubmit": [
      { "hooks": [ { "type": "command", "command": "bigarrow stop --hook" } ] }
    ]
  }
}

Se in quel file hai già altre impostazioni o altri hook, non sostituirlo: va aggiunta solo questa parte. Io lo faccio fare a Claude:

Aggiungi a ~/.claude/settings.json un hook UserPromptSubmit che lancia bigarrow stop --hook. Non toccare le impostazioni e gli hook che ci sono già, e mostrami il file prima di salvarlo.

6. Cosa non fa, e i limiti

• Non clicca mai, non scrive e non cattura lo schermo. Indica e basta: il clic lo fai tu.
• Non ti ruba la tastiera: puoi continuare a scrivere mentre la freccia è sullo schermo.
• Funziona solo su Mac, con macOS 14 o successivo.
• Dentro le pagine web di Chrome, indicare per nome funziona solo se Chrome è stato avviato con l'opzione --force-renderer-accessibility (o con VoiceOver acceso). Altrimenti Claude punta alle coordinate della pagina. La barra di Chrome e le app fatte con Electron funzionano.
• Non è una protezione. Se un clic approva, paga o cancella qualcosa, la skill chiede a Claude di scriverlo sul cartello: leggilo sempre prima di cliccare.

Gli errori più comuni

• Dare il permesso di Accessibilità a bigarrow invece che all'app da cui usi Claude Code. Il Mac lo controlla sull'app che lancia il comando.
• Installare il programma e dimenticare bigarrow install-skill. Senza la skill, Claude non sa che la freccia esiste.
• Incollare l'hook sopra un settings.json che ha già altro, e perdere le impostazioni di prima.
• Cliccare dove indica la freccia senza leggere il cartello. Se il cartello non dice cosa succede dopo il clic, chiedilo a Claude.

Checklist

• bigarrow --version risponde nel terminale
• Ho lanciato bigarrow install-skill e aperto una sessione nuova
• La freccia di prova è comparsa sullo schermo
• L'app da cui uso Claude Code ha il permesso di Accessibilità
• bigarrow doctor non segnala permessi mancanti
• L'hook con bigarrow stop --hook è in ~/.claude/settings.json
• Nel CLAUDE.md c'è la riga che chiede di indicare invece di scrivere

Domande frequenti