La flèche sur l'écran

Ce que c'est et pourquoi ça compte

Parfois Claude Code a besoin d'un clic de ta part : une autorisation du Mac, une fenêtre qui demande une confirmation, un réglage à activer. Et il l'écrit dans le terminal : « clique sur Autoriser ». Sauf que tu ne regardes pas le terminal. Et quand tu y arrives, il te reste à trouver ce bouton au milieu de dix fenêtres.

big-arrow-on-the-screen règle exactement ça. La commande s'appelle bigarrow : un petit programme pour Mac qui dessine au-dessus de toutes les fenêtres une grande flèche avec un panneau, du genre « Clique sur Autoriser ». Il est livré avec une skill, c'est-à-dire un fichier d'instructions que Claude Code lit quand il en a besoin : elle lui apprend quand montrer et comment. Les clics traversent la flèche, le clavier reste là où tu écrivais, et la flèche disparaît toute seule.

C'est un projet open source tiers, sous licence MIT : il n'est pas d'Anthropic. Il est gratuit, le code est sur GitHub (github.com/franzenzenhofer/big-arrow-on-the-screen) et il ne fonctionne que sur Mac. Il sert à ceux qui passent la journée avec Claude Code et se perdent entre fenêtres et réglages. Et à ceux qui aident quelqu'un de moins à l'aise.

1. Installe-le avec Homebrew

Homebrew est le gestionnaire de paquets le plus utilisé sur Mac : il installe des programmes depuis le terminal en une commande. Si tu ne l'as pas, tu le trouves sur brew.sh. Ensuite, tape dans le terminal :

brew install franzenzenhofer/tap/bigarrow

Homebrew le compile sur ton Mac, donc il te faut Xcode installé et macOS 14 ou plus récent. Pour vérifier que tout s'est bien passé, tape bigarrow --version : il doit répondre avec la version installée.

2. Apprends-le à Claude Code

Le programme seul ne suffit pas : Claude doit savoir qu'il existe et quand l'utiliser. Cette commande copie la skill parmi les skills personnelles de Claude Code, dans le dossier ~/.claude/skills, pour qu'elle serve dans tous tes projets (elle installe aussi celle pour Codex) :

bigarrow install-skill

Ouvre une nouvelle session de Claude Code. À partir de là, Claude l'utilise tout seul quand il a besoin d'un clic de ta part, ou tu l'appelles toi-même en tapant /big-arrow. Pour dessiner la flèche, aucune autorisation du Mac n'est nécessaire, tu peux donc l'essayer tout de suite :

Avec bigarrow, dessine une flèche qui montre le centre de mon écran, avec le panneau « Ça marche ». Puis enlève-la.

3. L'autorisation d'Accessibilité, seulement pour montrer par le nom

La flèche peut viser de deux façons. Par coordonnées, c'est-à-dire un point précis de l'écran : aucune autorisation. Ou par le nom : Claude demande au Mac où se trouve le bouton « Autoriser » dans cette app et vise pile dessus. C'est la façon la plus précise, et elle demande l'autorisation d'Accessibilité.

Le détail qui piège tout le monde : l'autorisation ne va pas à bigarrow, mais à l'app depuis laquelle tu utilises Claude Code. Si tu l'utilises dans Terminal, elle va à Terminal ; si tu l'utilises dans iTerm2, Ghostty, VS Code ou l'app Claude, elle va à celle-là.

1. Ouvre Réglages Système, puis Confidentialité et sécurité, puis Accessibilité. Dans les versions les plus récentes de macOS, la rubrique peut porter un autre nom : si l'autorisation manque, l'erreur de bigarrow t'indique l'app et le bon panneau.
2. Active l'interrupteur de l'app depuis laquelle tu utilises Claude Code. Si elle n'est pas dans la liste, ajoute-la avec le bouton +.
3. Dans le terminal, tape bigarrow doctor. Il te montre les autorisations et les écrans branchés, et te dit à quelle app donner l'autorisation.

4. Les prompts pour qu'il montre au lieu d'écrire

La skill dit déjà à Claude de montrer au lieu d'écrire. Mais moi, je l'écris noir sur blanc dans le CLAUDE.md, le fichier de règles que Claude lit à chaque session, pour qu'il ne l'oublie pas :

Quand tu as besoin d'un clic de ma part, ne m'écris pas « clique sur… » : ouvre toi-même le bon écran et montre-moi le bouton avec bigarrow, avec un panneau qui dit quoi faire et ce qui se passe après le clic.

Et quand c'est toi qui ne trouves pas quelque chose sur le Mac, ou dans une app :

Je ne trouve pas où on active [le réglage]. Ouvre toi-même le bon écran et montre-moi avec bigarrow sur quoi cliquer, une étape à la fois. Les clics, c'est moi qui les fais.

Si tu dois coller quelque chose, un code ou une commande, la valeur peut figurer sur le panneau comme bouton à copier : un clic et c'est dans le presse-papiers.

Je dois coller [la valeur] dans [app]. Montre-moi le bon champ avec bigarrow et mets la valeur sur le panneau comme bouton à copier.

5. Fais disparaître la flèche quand tu réponds

Chaque flèche se termine toute seule : après un temps maximum (par défaut 8 secondes pour une flèche rapide, 5 minutes pour une qui reste tant qu'il faut), quand Claude l'enlève avec bigarrow stop, ou quand la session de Claude qui l'a dessinée se ferme. Si tu cliques sur le panneau ou sur la tige, elle disparaît.

En plus, il y a un hook, c'est-à-dire une commande que Claude Code lance tout seul à un moment précis. Celui-ci se déclenche chaque fois que tu envoies un message à Claude et enlève les flèches de cette session : tu as répondu, la flèche ne sert plus. Il va dans le fichier ~/.claude/settings.json :

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

Si ce fichier contient déjà d'autres réglages ou d'autres hooks, ne le remplace pas : il faut seulement ajouter cette partie. Moi, je le fais faire à Claude :

Ajoute dans ~/.claude/settings.json un hook UserPromptSubmit qui lance bigarrow stop --hook. Ne touche pas aux réglages et aux hooks déjà présents, et montre-moi le fichier avant de l'enregistrer.

6. Ce qu'il ne fait pas, et ses limites

• Il ne clique jamais, n'écrit pas et ne capture pas l'écran. Il montre, c'est tout : le clic, c'est toi.
• Il ne te vole pas le clavier : tu peux continuer à écrire pendant que la flèche est à l'écran.
• Il ne fonctionne que sur Mac, avec macOS 14 ou plus récent.
• Dans les pages web de Chrome, montrer par le nom ne marche que si Chrome a été lancé avec l'option --force-renderer-accessibility (ou avec VoiceOver activé). Sinon, Claude vise des coordonnées de la page. La barre de Chrome et les apps faites avec Electron fonctionnent.
• Ce n'est pas une protection. Si un clic approuve, paie ou supprime quelque chose, la skill demande à Claude de l'écrire sur le panneau : lis-le toujours avant de cliquer.

Les erreurs les plus courantes

• Donner l'autorisation d'Accessibilité à bigarrow au lieu de l'app depuis laquelle tu utilises Claude Code. Le Mac la vérifie sur l'app qui lance la commande.
• Installer le programme et oublier bigarrow install-skill. Sans la skill, Claude ne sait pas que la flèche existe.
• Coller le hook par-dessus un settings.json qui contient déjà autre chose, et perdre les réglages d'avant.
• Cliquer là où montre la flèche sans lire le panneau. Si le panneau ne dit pas ce qui se passe après le clic, demande-le à Claude.

Check-list

• bigarrow --version répond dans le terminal
• J'ai lancé bigarrow install-skill et ouvert une nouvelle session
• La flèche de test est apparue à l'écran
• L'app depuis laquelle j'utilise Claude Code a l'autorisation d'Accessibilité
• bigarrow doctor ne signale aucune autorisation manquante
• Le hook avec bigarrow stop --hook est dans ~/.claude/settings.json
• Le CLAUDE.md contient la ligne qui demande de montrer au lieu d'écrire

Questions fréquentes