Guia de campo do Claude Code em português

Claude Code no GitHub: como pôr o @claude para trabalhar nos seus pull requests

Há três jeitos de juntar o Claude Code e o GitHub: a sessão na nuvem que parte de um repositório (p. 11), a routine disparada por pull request ou release (p. 102) e a GitHub Action, que responde quando alguém escreve @claude numa issue ou num PR. Este artigo monta a terceira, com o comando que faz quase tudo sozinho, e diz o que ela pode mexer e quanto ela gasta.

Qual dos três você quer

Você querUse
Deixar uma tarefa longa rodando com o computador desligadoSessão na nuvem: claude.ai/code com o repositório do GitHub, ou claude --cloud "tarefa" no terminal (p. 11 e 12)
Algo que roda sozinho a cada PR, release ou horário, salvo na sua contaRoutine, com gatilho do GitHub (p. 102)
Escrever @claude num comentário e receber o código ou a revisão ali mesmoClaude Code GitHub Actions (anthropics/claude-code-action)

A Action roda dentro dos workflows do seu repositório: com @claude num PR ou numa issue, o Claude analisa o código, implementa a mudança e faz commit. Também dá para dar a ela um prompt fixo, que roda em qualquer evento do GitHub sem ninguém chamar (code.claude.com/docs/en/github-actions, lida em 18/10/2026).

O jeito rápido: /install-github-app

Precisa de três coisas: ser administrador do repositório, o repositório estar no github.com (com remoto no GitLab ou no Bitbucket o comando avisa e sai) e o GitHub CLI instalado e logado. No Windows:

PowerShell, Windows

winget install --id GitHub.cli
gh auth login
cd C:\caminho\do\seu\repositorio
claude
/install-github-app

O comando instala o app Claude no GitHub, grava o segredo e abre no navegador um pull request com o claude.yml pronto. Você cria e mescla esse PR, e o @claude passa a responder. Se o Claude Code já tem chave de API, ele a reusa; senão, você escolhe entre um token de longa duração da sua assinatura e colar uma chave. O segredo fica no repositório como CLAUDE_CODE_OAUTH_TOKEN (assinatura) ou ANTHROPIC_API_KEY (API). Esc no meio interrompe: o passo em andamento termina e a mensagem final diz o que já ficou feito. O winget é o instalador de pacotes do Windows; o gh também tem instalador no site cli.github.com.

O jeito manual, se o comando falhar

  1. Instale o app em github.com/apps/claude no repositório.
  2. Crie o segredo em Settings > Secrets and variables > Actions. Com a assinatura (Pro, Max, Team ou Enterprise), gere o token com claude setup-token no seu computador; é o mesmo comando que o guia mostra na tabela de login (p. 10).
  3. Copie o examples/claude.yml do repositório da Action para .github/workflows/. O arquivo, do jeito que está, responde a toda menção ao @claude e lê o segredo ANTHROPIC_API_KEY; com o token da assinatura, troque a linha anthropic_api_key por claude_code_oauth_token.

YAML, .github/workflows/claude.yml (o exemplo da documentação, com o token da assinatura)

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

Para testar, escreva num PR: "@claude explique o que este PR muda e aponte riscos".

O que o app pode mexer, e quem pode chamá-lo

A Action usa três permissões do app: Contents, Issues e Pull requests, todas de leitura e escrita. Só que o app Claude é o mesmo para todos os recursos da Anthropic no GitHub, e ao instalar você aceita o conjunto inteiro, que inclui Actions, Workflows e Repository hooks com escrita; o GitHub não deixa aceitar só uma parte. Quem precisa do mínimo cria um app próprio com as três permissões, seguindo o guia de setup da Action.

Antes de rodar, a Action confere quem chamou: em issue e PR, a pessoa precisa ter permissão de escrita no repositório, e conta de bot é recusada, para um bot não acionar o Claude em laço. Num repositório público, um estranho comentando @claude não dispara nada. Com um prompt fixo no workflow, os resultados vão para o log da execução, não para um comentário, a menos que o prompt mande comentar.

Quanto custa

São duas contas. A do GitHub: a Action roda nos runners hospedados do GitHub e gasta os seus minutos de Actions. A do Claude: cada execução gasta tokens da API ou a cota da assinatura, conforme o segredo. Para gastar menos, a documentação manda escrever um CLAUDE.md curto na raiz (o Claude o lê a cada execução), limitar as voltas com claude_args: "--max-turns 5" e usar gatilho específico, para não rodar à toa. O token de assinatura é preso à conta de quem rodou o claude setup-token: para vários repositórios de uma organização, a documentação recomenda chave de API num segredo da organização. Como o uso da assinatura sai da mesma cota do chat e do terminal (claude.com/pricing: "one pool"), uma Action muito chamada come o limite do plano.

Para tirar

Apague o claude.yml (e o claude-code-review.yml, se escolheu a revisão), apague o segredo e, se nenhum outro recurso usa, desinstale o app nas configurações do GitHub. Apagar o segredo não invalida a chave: para aposentar uma chave de API, apague-a também no Console.

Leia também