Der Pfeil auf dem Bildschirm

Was es ist und warum es zählt

Manchmal braucht Claude Code einen Klick von dir: eine Mac-Berechtigung, ein Fenster, das eine Bestätigung will, eine Einstellung zum Einschalten. Und es schreibt das ins Terminal: „klick auf Erlauben“. Nur schaust du gerade nicht aufs Terminal. Und wenn du hinschaust, musst du den Button zwischen zehn Fenstern erst noch finden.

big-arrow-on-the-screen löst genau das. Der Befehl heißt bigarrow: ein kleines Mac-Programm, das über alle Fenster einen großen Pfeil mit einem Schild zeichnet, etwa „Klick auf Erlauben“. Dazu kommt ein Skill, also eine Datei mit Anweisungen, die Claude Code liest, wenn es sie braucht: Sie bringt Claude bei, wann und wie es zeigen soll. Klicks gehen durch den Pfeil hindurch, die Tastatur bleibt, wo du gerade tippst, und der Pfeil verschwindet von selbst.

Es ist ein Open-Source-Projekt eines Dritten, MIT-lizenziert: nicht von Anthropic. Es ist kostenlos, der Code liegt auf GitHub (github.com/franzenzenhofer/big-arrow-on-the-screen) und es läuft nur auf dem Mac. Es ist für alle, die den Tag mit Claude Code verbringen und sich zwischen Fenstern und Einstellungen verlieren. Und für alle, die jemandem helfen, der sich weniger auskennt.

1. Mit Homebrew installieren

Homebrew ist der meistgenutzte Paketmanager auf dem Mac: Er installiert Programme mit einem Befehl im Terminal. Wenn du ihn nicht hast, findest du ihn auf brew.sh. Dann tippst du im Terminal:

brew install franzenzenhofer/tap/bigarrow

Homebrew kompiliert es auf deinem Mac, du brauchst also ein installiertes Xcode und macOS 14 oder neuer. Um zu prüfen, ob alles geklappt hat, tippst du bigarrow --version: Es sollte mit der installierten Version antworten.

2. Claude Code beibringen, es zu nutzen

Das Programm allein reicht nicht: Claude muss wissen, dass es existiert und wann es benutzt wird. Dieser Befehl kopiert den Skill zu den persönlichen Skills von Claude Code, in den Ordner ~/.claude/skills, damit er in all deinen Projekten gilt (er installiert auch den für Codex):

bigarrow install-skill

Öffne eine neue Sitzung von Claude Code. Ab dann nutzt Claude den Skill von selbst, wenn es einen Klick von dir braucht, oder du rufst ihn selbst mit /big-arrow auf. Zum Zeichnen des Pfeils braucht es keine Mac-Berechtigung, du kannst ihn also sofort ausprobieren:

Zeichne mit bigarrow einen Pfeil, der auf die Mitte meines Bildschirms zeigt, mit dem Schild „Es funktioniert“. Dann entferne ihn.

3. Die Bedienungshilfen-Berechtigung, nur zum Zeigen per Name

Der Pfeil kann auf zwei Arten zeigen. Per Koordinaten, also auf einen genauen Punkt des Bildschirms: keine Berechtigung nötig. Oder per Name: Claude fragt den Mac, wo der Button „Erlauben“ in dieser App ist, und zeigt genau darauf. Das ist die präziseste Art, und sie braucht die Berechtigung für Bedienungshilfen.

Das Detail, über das alle stolpern: Die Berechtigung bekommt nicht bigarrow, sondern die App, aus der du Claude Code nutzt. Nutzt du es im Terminal, bekommt sie das Terminal; nutzt du es in iTerm2, Ghostty, VS Code oder der Claude-App, bekommt sie diese.

1. Öffne die Systemeinstellungen, dann Datenschutz & Sicherheit, dann Bedienungshilfen. In den neuesten macOS-Versionen kann der Punkt anders heißen: Fehlt die Berechtigung, nennt dir die Fehlermeldung von bigarrow die App und den richtigen Bereich.
2. Schalte den Schalter der App ein, aus der du Claude Code nutzt. Steht sie nicht in der Liste, füge sie mit dem Button + hinzu.
3. Tippe im Terminal bigarrow doctor. Es zeigt dir die Berechtigungen und die angeschlossenen Bildschirme und sagt dir, welche App die Berechtigung braucht.

4. Die Prompts, damit Claude zeigt statt schreibt

Der Skill sagt Claude schon, dass es zeigen statt schreiben soll. Ich schreibe es trotzdem schwarz auf weiß in die CLAUDE.md, die Regeldatei, die Claude in jeder Sitzung liest, damit es das nicht vergisst:

Wenn du einen Klick von mir brauchst, schreib mir nicht „klick auf…“: Öffne selbst den richtigen Bildschirm und zeig mir den Button mit bigarrow, mit einem Schild, das sagt, was zu tun ist und was nach dem Klick passiert.

Und wenn du selbst etwas auf dem Mac oder in einer App nicht findest:

Ich finde nicht, wo man [die Einstellung] einschaltet. Öffne selbst den richtigen Bildschirm und zeig mir mit bigarrow, was ich anklicken muss, einen Schritt nach dem anderen. Die Klicks mache ich.

Wenn du etwas einfügen musst, einen Code oder einen Befehl, kann der Wert als Kopier-Button auf dem Schild stehen: ein Klick und er ist in der Zwischenablage.

Ich muss [den Wert] in [App] einfügen. Zeig mir mit bigarrow das richtige Feld und setz den Wert als Kopier-Button aufs Schild.

5. Den Pfeil verschwinden lassen, sobald du antwortest

Jeder Pfeil endet von selbst: nach einer Höchstzeit (standardmäßig 8 Sekunden für einen schnellen Pfeil, 5 Minuten für einen, der bleibt, solange er gebraucht wird), wenn Claude ihn mit bigarrow stop entfernt, oder wenn die Claude-Sitzung endet, die ihn gezeichnet hat. Klickst du auf Schild oder Schaft, verschwindet er.

Dazu gibt es einen Hook, also einen Befehl, den Claude Code zu einem bestimmten Zeitpunkt selbst ausführt. Dieser läuft jedes Mal, wenn du Claude eine Nachricht schickst, und entfernt die Pfeile dieser Sitzung: Du hast geantwortet, der Pfeil wird nicht mehr gebraucht. Er gehört in die Datei ~/.claude/settings.json:

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

Wenn diese Datei schon andere Einstellungen oder Hooks enthält, ersetz sie nicht: Nur dieser Teil muss dazu. Ich lasse das Claude machen:

Füge in ~/.claude/settings.json einen UserPromptSubmit-Hook hinzu, der bigarrow stop --hook ausführt. Rühr die vorhandenen Einstellungen und Hooks nicht an und zeig mir die Datei, bevor du sie speicherst.

6. Was es nicht tut, und die Grenzen

• Es klickt nie, tippt nie und nimmt den Bildschirm nie auf. Es zeigt nur: Den Klick machst du.
• Es klaut dir nicht die Tastatur: Du kannst weitertippen, während der Pfeil auf dem Bildschirm ist.
• Es läuft nur auf dem Mac, mit macOS 14 oder neuer.
• In Chrome-Webseiten funktioniert das Zeigen per Name nur, wenn Chrome mit der Option --force-renderer-accessibility gestartet wurde (oder mit eingeschaltetem VoiceOver). Sonst zeigt Claude auf Koordinaten der Seite. Die Leiste von Chrome und mit Electron gebaute Apps funktionieren.
• Es ist kein Schutz. Wenn ein Klick etwas genehmigt, bezahlt oder löscht, verlangt der Skill von Claude, das aufs Schild zu schreiben: Lies es immer, bevor du klickst.

Häufige Fehler

• Die Bedienungshilfen-Berechtigung an bigarrow geben statt an die App, aus der du Claude Code nutzt. Der Mac prüft sie bei der App, die den Befehl startet.
• Das Programm installieren und bigarrow install-skill vergessen. Ohne den Skill weiß Claude nicht, dass es den Pfeil gibt.
• Den Hook über eine settings.json kopieren, in der schon anderes steht, und die bisherigen Einstellungen verlieren.
• Dorthin klicken, wo der Pfeil hinzeigt, ohne das Schild zu lesen. Sagt das Schild nicht, was nach dem Klick passiert, frag Claude.

Checkliste

• bigarrow --version antwortet im Terminal
• Ich habe bigarrow install-skill ausgeführt und eine neue Sitzung geöffnet
• Der Testpfeil ist auf dem Bildschirm erschienen
• Die App, aus der ich Claude Code nutze, hat die Bedienungshilfen-Berechtigung
• bigarrow doctor meldet keine fehlenden Berechtigungen
• Der Hook mit bigarrow stop --hook steht in ~/.claude/settings.json
• In der CLAUDE.md steht die Zeile, die Zeigen statt Schreiben verlangt

Häufige Fragen