Claude Code no GitHub: o App, a Action e @claude

1. Instale o aplicativo do GitHub

claude
/install-github-app

O comando orienta a instalação do aplicativo no repositório, o armazenamento da chave de API como segredo do repositório e a abertura de um pull request que adiciona o arquivo do fluxo de trabalho. Você também pode fazer as três etapas manualmente.

2. O fluxo de trabalho

name: Claude
on:
  issue_comment: { types: [created] }
  pull_request_review_comment: { types: [created] }
  issues: { types: [opened, assigned] }

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude') || github.event_name == 'issues'
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 1 }
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
        env:
          ANTHROPIC_BASE_URL: https://aiprimetech.io

Com a linha de ambiente, toda execução no CI passa pelo gateway: o segredo do seu repositório é uma chave do gateway, e o uso é debitado do seu saldo no gateway ou coberto pelo plano ilimitado. Remova a linha de ambiente para cobrar o uso de uma conta da Anthropic.

3. Como usar

• Comente @claude fix the failing test in auth.py em uma issue — ele abre um pull request.
• Comente @claude em uma discussão de revisão de pull request — ele responde e envia alterações para essa branch.
• Atribua uma issue ao aplicativo para que ela seja implementada sem um comentário.
• Agende a execução: um fluxo de trabalho acionado por cron com um prompt fixo (auditoria de dependências, rascunho do registro de alterações).

Custos no CI

Cada acionamento é uma execução completa do agente: fazer checkout, ler os arquivos relevantes, planejar, editar, testar e enviar alterações. Espere dezenas de milhares de tokens por execução em um repositório real. As equipes que integram @claude a todos os PRs são justamente os usuários para quem um plano de preço fixo compensa mais do que a cobrança por token — consulte o guia de preços.

Permissões e segurança

• Conceda ao job apenas as permissões necessárias para a tarefa; contents: write é necessário para enviar alterações.
• Restrinja os acionamentos a colaboradores confiáveis em repositórios públicos — caso contrário, qualquer pessoa que possa comentar poderá gastar seus tokens.
• Use allowed_tools nos parâmetros de entrada da action para delimitar o que o agente pode executar.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Perguntas frequentes

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.