A seta no ecrã

O que é e porque importa

Às vezes o Claude Code precisa de um clique teu: uma permissão do Mac, uma janela a pedir confirmação, uma definição para ligar. E escreve-o no terminal: «clica em Permitir». Só que tu não estás a olhar para o terminal. E quando lá chegas, ainda tens de encontrar esse botão no meio de dez janelas.

O big-arrow-on-the-screen resolve exatamente isto. O comando chama-se bigarrow: é um pequeno programa para Mac que desenha por cima de todas as janelas uma seta grande com um cartaz, tipo «Clica em Permitir». Vem com uma skill, ou seja, um ficheiro de instruções que o Claude Code lê quando precisa: ensina-lhe quando apontar e como. Os cliques passam através da seta, o teclado fica onde estavas a escrever e a seta desaparece sozinha.

É um projeto open source de terceiros, com licença MIT: não é da Anthropic. É grátis, o código está no GitHub (github.com/franzenzenhofer/big-arrow-on-the-screen) e só funciona no Mac. Serve a quem passa o dia com o Claude Code e se perde entre janelas e definições. E também a quem ajuda alguém com menos prática.

1. Instala-o com o Homebrew

O Homebrew é o gestor de pacotes mais usado no Mac: instala programas a partir do terminal com um comando. Se não o tens, encontras em brew.sh. Depois escreve no terminal:

brew install franzenzenhofer/tap/bigarrow

O Homebrew compila-o no teu Mac, por isso precisas do Xcode instalado e do macOS 14 ou posterior. Para confirmar que correu tudo bem, escreve bigarrow --version: deve responder com a versão instalada.

2. Ensina-o ao Claude Code

O programa sozinho não chega: o Claude tem de saber que existe e quando o usar. Este comando copia a skill para as skills pessoais do Claude Code, na pasta ~/.claude/skills, para valer em todos os teus projetos (também instala a do Codex):

bigarrow install-skill

Abre uma sessão nova do Claude Code. A partir daí o Claude usa-a sozinho quando precisa de um clique teu, ou chamas-la tu escrevendo /big-arrow. Para desenhar a seta não é preciso nenhuma permissão do Mac, por isso podes experimentá-la já:

Com o bigarrow desenha uma seta a apontar para o centro do meu ecrã, com o cartaz «Funciona». Depois tira-a.

3. A permissão de Acessibilidade, só para apontar pelo nome

A seta pode apontar de duas maneiras. Por coordenadas, ou seja, para um ponto exato do ecrã: sem permissões. Ou pelo nome: o Claude pergunta ao Mac onde está o botão «Permitir» nessa app e aponta mesmo para ele. É a forma mais precisa, e precisa da permissão de Acessibilidade.

O pormenor que apanha toda a gente: a permissão não vai para o bigarrow, mas para a app a partir da qual usas o Claude Code. Se o usas no Terminal, vai para o Terminal; se o usas no iTerm2, no Ghostty, no VS Code ou na app Claude, vai para essa.

1. Abre as Definições do Sistema, depois Privacidade e segurança, depois Acessibilidade. Nas versões mais recentes do macOS a opção pode ter outro nome: se faltar a permissão, o erro do bigarrow diz-te a app e o ecrã certo.
2. Liga o interruptor da app a partir da qual usas o Claude Code. Se não estiver na lista, adiciona-a com o botão +.
3. No terminal escreve bigarrow doctor. Mostra-te as permissões e os ecrãs ligados, e diz-te a que app tens de dar a permissão.

4. Os prompts para te apontar em vez de escrever

A skill já diz ao Claude para apontar em vez de escrever. Mas eu ponho isto também preto no branco no CLAUDE.md, o ficheiro de regras que o Claude lê em cada sessão, para não se esquecer:

Quando precisares de um clique meu, não me escrevas «clica em…»: abre tu o ecrã certo e aponta-me o botão com o bigarrow, com um cartaz que diga o que fazer e o que acontece depois do clique.

E quando és tu que não encontras alguma coisa no Mac, ou numa app:

Não encontro onde se ativa [a definição]. Abre tu o ecrã certo e aponta-me com o bigarrow o que tocar, um passo de cada vez. Os cliques faço-os eu.

Se tens de colar alguma coisa, um código ou um comando, o valor pode ficar no cartaz como botão para copiar: um clique e fica na área de transferência.

Tenho de colar [o valor] em [app]. Aponta-me o campo certo com o bigarrow e põe o valor no cartaz como botão para copiar.

5. Faz a seta desaparecer quando respondes

Cada seta acaba sozinha: depois de um tempo máximo (por defeito 8 segundos para uma seta rápida, 5 minutos para uma que fica enquanto for precisa), quando o Claude a tira com bigarrow stop, ou quando fecha a sessão do Claude que a desenhou. Se clicares no cartaz ou na haste, desaparece.

Além disso há um hook, ou seja, um comando que o Claude Code corre sozinho num momento preciso. Este corre sempre que envias uma mensagem ao Claude e tira as setas dessa sessão: já respondeste, por isso a seta já não é precisa. Vai no ficheiro ~/.claude/settings.json:

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

Se esse ficheiro já tem outras definições ou outros hooks, não o substituas: só é preciso acrescentar esta parte. Eu peço ao Claude:

Acrescenta ao ~/.claude/settings.json um hook UserPromptSubmit que corra bigarrow stop --hook. Não mexas nas definições e nos hooks que já lá estão, e mostra-me o ficheiro antes de o guardar.

6. O que não faz, e os limites

• Nunca clica, não escreve e não captura o ecrã. Só aponta: o clique fazes tu.
• Não te rouba o teclado: podes continuar a escrever enquanto a seta está no ecrã.
• Só funciona no Mac, com macOS 14 ou posterior.
• Dentro das páginas web do Chrome, apontar pelo nome só funciona se o Chrome tiver sido aberto com a opção --force-renderer-accessibility (ou com o VoiceOver ligado). Caso contrário, o Claude aponta para coordenadas da página. A barra do Chrome e as apps feitas com Electron funcionam.
• Não é uma proteção. Se um clique aprova, paga ou apaga alguma coisa, a skill pede ao Claude para o escrever no cartaz: lê-o sempre antes de clicar.

Os erros mais comuns

• Dar a permissão de Acessibilidade ao bigarrow em vez da app a partir da qual usas o Claude Code. O Mac verifica-a na app que lança o comando.
• Instalar o programa e esquecer o bigarrow install-skill. Sem a skill, o Claude não sabe que a seta existe.
• Colar o hook por cima de um settings.json que já tem outras coisas e perder as definições que lá estavam.
• Clicar onde a seta aponta sem ler o cartaz. Se o cartaz não diz o que acontece depois do clique, pergunta ao Claude.

Checklist

• bigarrow --version responde no terminal
• Corri bigarrow install-skill e abri uma sessão nova
• A seta de teste apareceu no ecrã
• A app a partir da qual uso o Claude Code tem a permissão de Acessibilidade
• bigarrow doctor não assinala permissões em falta
• O hook com bigarrow stop --hook está no ~/.claude/settings.json
• No CLAUDE.md está a linha que pede para apontar em vez de escrever

Perguntas frequentes