Claude Code GitHub Actions

Claude Code GitHub Actions traz automação alimentada por IA para o seu fluxo de trabalho do GitHub. Com uma simples menção @claude em qualquer PR ou issue, Claude pode analisar seu código, criar pull requests, implementar recursos e corrigir bugs - tudo seguindo os padrões do seu projeto.

Claude Code GitHub Actions está atualmente em beta. Recursos e funcionalidades podem evoluir conforme refinamos a experiência.

Claude Code GitHub Actions é construído sobre o Claude Code SDK, que permite integração programática do Claude Code em suas aplicações. Você pode usar o SDK para construir fluxos de trabalho de automação personalizados além do GitHub Actions.

Por que usar Claude Code GitHub Actions?

Criação instantânea de PR: Descreva o que você precisa, e Claude cria um PR completo com todas as mudanças necessárias
Implementação automatizada de código: Transforme issues em código funcional com um único comando
Segue seus padrões: Claude respeita suas diretrizes CLAUDE.md e padrões de código existentes
Configuração simples: Comece em minutos com nosso instalador e chave de API
Seguro por padrão: Seu código permanece nos runners do Github

O que Claude pode fazer?

Claude Code fornece GitHub Actions poderosos que transformam como você trabalha com código:

Claude Code Action

Este GitHub Action permite executar Claude Code dentro dos seus fluxos de trabalho do GitHub Actions. Você pode usar isso para construir qualquer fluxo de trabalho personalizado sobre Claude Code.

Ver repositório →

Claude Code Action (Base)

A fundação para construir fluxos de trabalho personalizados do GitHub com Claude. Este framework extensível dá acesso completo às capacidades do Claude para criar automação personalizada.

Ver repositório →

Configuração

Configuração rápida

A maneira mais fácil de configurar esta action é através do Claude Code no terminal. Apenas abra claude e execute /install-github-app.

Este comando irá guiá-lo através da configuração do app GitHub e segredos necessários.

Você deve ser um administrador do repositório para instalar o app GitHub e adicionar segredos
Este método de início rápido está disponível apenas para usuários diretos da API Anthropic. Se você está usando AWS Bedrock ou Google Vertex AI, por favor veja a seção Usando com AWS Bedrock & Google Vertex AI.

Configuração manual

Se o comando /install-github-app falhar ou você preferir configuração manual, por favor siga estas instruções de configuração manual:

Instale o app Claude GitHub no seu repositório: https://github.com/apps/claude
Adicione ANTHROPIC_API_KEY aos segredos do seu repositório (Aprenda como usar segredos no GitHub Actions)
Copie o arquivo de fluxo de trabalho de examples/claude.yml para o .github/workflows/ do seu repositório

Após completar a configuração rápida ou manual, teste a action marcando @claude em um comentário de issue ou PR!

Casos de uso de exemplo

Claude Code GitHub Actions pode ajudá-lo com uma variedade de tarefas. Para exemplos funcionais completos, veja o diretório de exemplos.

Transformar issues em PRs

Em um comentário de issue:

@claude implemente este recurso baseado na descrição da issue

Claude irá analisar a issue, escrever o código e criar um PR para revisão.

Obter ajuda de implementação

Em um comentário de PR:

@claude como devo implementar autenticação de usuário para este endpoint?

Claude irá analisar seu código e fornecer orientação específica de implementação.

Corrigir bugs rapidamente

Em uma issue:

@claude corrija o TypeError no componente de dashboard do usuário

Claude irá localizar o bug, implementar uma correção e criar um PR.

Melhores práticas

Configuração CLAUDE.md

Crie um arquivo CLAUDE.md na raiz do seu repositório para definir diretrizes de estilo de código, critérios de revisão, regras específicas do projeto e padrões preferidos. Este arquivo guia o entendimento do Claude sobre os padrões do seu projeto.

Considerações de segurança

Nunca faça commit de chaves de API diretamente no seu repositório!

Sempre use GitHub Secrets para chaves de API:

Adicione sua chave de API como um segredo do repositório chamado ANTHROPIC_API_KEY
Referencie-a em fluxos de trabalho: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
Limite permissões de action apenas ao necessário
Revise as sugestões do Claude antes de fazer merge

Sempre use GitHub Secrets (ex., ${{ secrets.ANTHROPIC_API_KEY }}) ao invés de codificar chaves de API diretamente nos seus arquivos de fluxo de trabalho.

Otimizando performance

Use templates de issue para fornecer contexto, mantenha seu CLAUDE.md conciso e focado, e configure timeouts apropriados para seus fluxos de trabalho.

Custos de CI

Ao usar Claude Code GitHub Actions, esteja ciente dos custos associados:

Custos do GitHub Actions:

Claude Code executa em runners hospedados pelo GitHub, que consomem seus minutos do GitHub Actions
Veja documentação de cobrança do GitHub para preços detalhados e limites de minutos

Custos de API:

Cada interação do Claude consome tokens de API baseado no comprimento de prompts e respostas
Uso de tokens varia pela complexidade da tarefa e tamanho da base de código
Veja página de preços do Claude para taxas atuais de tokens

Dicas de otimização de custos:

Use comandos @claude específicos para reduzir chamadas de API desnecessárias
Configure limites apropriados de max_turns para prevenir iterações excessivas
Defina timeout_minutes razoáveis para evitar fluxos de trabalho descontrolados
Considere usar controles de concorrência do GitHub para limitar execuções paralelas

Exemplos de configuração

Para configurações de fluxo de trabalho prontas para uso para diferentes casos de uso, incluindo:

Configuração básica de fluxo de trabalho para comentários de issue e PR
Revisões automatizadas de código em pull requests
Implementações personalizadas para necessidades específicas

Visite o diretório de exemplos no repositório Claude Code Action.

O repositório de exemplos inclui fluxos de trabalho completos e testados que você pode copiar diretamente para seu diretório .github/workflows/.

Usando com AWS Bedrock & Google Vertex AI

Para ambientes empresariais, você pode usar Claude Code GitHub Actions com sua própria infraestrutura de nuvem. Esta abordagem dá controle sobre residência de dados e cobrança mantendo a mesma funcionalidade.

Pré-requisitos

Antes de configurar Claude Code GitHub Actions com provedores de nuvem, você precisa:

Para Google Cloud Vertex AI:

Um Projeto Google Cloud com Vertex AI habilitado
Workload Identity Federation configurado para GitHub Actions
Uma conta de serviço com as permissões necessárias
Um GitHub App (recomendado) ou use o GITHUB_TOKEN padrão

Para AWS Bedrock:

Uma conta AWS com Amazon Bedrock habilitado
GitHub OIDC Identity Provider configurado na AWS
Uma função IAM com permissões Bedrock
Um GitHub App (recomendado) ou use o GITHUB_TOKEN padrão

Criar um GitHub App personalizado (Recomendado para Provedores 3P)

Para melhor controle e segurança ao usar provedores 3P como Vertex AI ou Bedrock, recomendamos criar seu próprio GitHub App:

Vá para https://github.com/settings/apps/new
Preencha as informações básicas:
- Nome do GitHub App: Escolha um nome único (ex., “YourOrg Claude Assistant”)
- URL da Homepage: Site da sua organização ou URL do repositório
Configure as configurações do app:
- Webhooks: Desmarque “Active” (não necessário para esta integração)
Defina as permissões necessárias:
- Permissões do repositório:
  - Contents: Read & Write
  - Issues: Read & Write
  - Pull requests: Read & Write
Clique em “Create GitHub App”
Após a criação, clique em “Generate a private key” e salve o arquivo .pem baixado
Anote seu App ID da página de configurações do app
Instale o app no seu repositório:
- Da página de configurações do seu app, clique em “Install App” na barra lateral esquerda
- Selecione sua conta ou organização
- Escolha “Only select repositories” e selecione o repositório específico
- Clique em “Install”
Adicione a chave privada como um segredo ao seu repositório:
- Vá para Configurações do seu repositório → Secrets and variables → Actions
- Crie um novo segredo chamado APP_PRIVATE_KEY com o conteúdo do arquivo .pem
Adicione o App ID como um segredo:

Crie um novo segredo chamado APP_ID com o ID do seu GitHub App

Este app será usado com a action actions/create-github-app-token para gerar tokens de autenticação nos seus fluxos de trabalho.

Alternativa para API Anthropic ou se você não quer configurar seu próprio app Github: Use o app oficial Anthropic:

Instale de: https://github.com/apps/claude
Nenhuma configuração adicional necessária para autenticação

Configurar autenticação do provedor de nuvem

Escolha seu provedor de nuvem e configure autenticação segura:

AWS Bedrock

Google Vertex AI

Adicionar Segredos Necessários

Adicione os seguintes segredos ao seu repositório (Settings → Secrets and variables → Actions):

Para API Anthropic (Direta):

Para Autenticação de API:
- ANTHROPIC_API_KEY: Sua chave de API Anthropic de console.anthropic.com
Para GitHub App (se usando seu próprio app):
- APP_ID: ID do seu GitHub App
- APP_PRIVATE_KEY: O conteúdo da chave privada (.pem)

Para Google Cloud Vertex AI

Para Autenticação GCP:
- GCP_WORKLOAD_IDENTITY_PROVIDER
- GCP_SERVICE_ACCOUNT
Para GitHub App (se usando seu próprio app):
- APP_ID: ID do seu GitHub App
- APP_PRIVATE_KEY: O conteúdo da chave privada (.pem)

Para AWS Bedrock

Para Autenticação AWS:
- AWS_ROLE_TO_ASSUME
Para GitHub App (se usando seu próprio app):
- APP_ID: ID do seu GitHub App
- APP_PRIVATE_KEY: O conteúdo da chave privada (.pem)

Criar arquivos de fluxo de trabalho

Crie arquivos de fluxo de trabalho do GitHub Actions que se integram com seu provedor de nuvem. Os exemplos abaixo mostram configurações completas para AWS Bedrock e Google Vertex AI:

Fluxo de trabalho AWS Bedrock

Pré-requisitos:

Acesso AWS Bedrock habilitado com permissões do modelo Claude
GitHub configurado como provedor de identidade OIDC na AWS
Função IAM com permissões Bedrock que confia no GitHub Actions

Segredos GitHub necessários:

Nome do Segredo	Descrição
`AWS_ROLE_TO_ASSUME`	ARN da função IAM para acesso Bedrock
`APP_ID`	ID do seu GitHub App (das configurações do app)
`APP_PRIVATE_KEY`	A chave privada que você gerou para seu GitHub App

name: Claude PR Action 

permissions:
  contents: write
  pull-requests: write
  issues: write
  id-token: write 

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]

jobs:
  claude-pr:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    env:
      AWS_REGION: us-west-2
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Generate GitHub App token
        id: app-token
        uses: actions/create-github-app-token@v2
        with:
          app-id: ${{ secrets.APP_ID }}
          private-key: ${{ secrets.APP_PRIVATE_KEY }}

      - name: Configure AWS Credentials (OIDC)
        uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
          aws-region: us-west-2

      - uses: ./.github/actions/claude-pr-action
        with:
          trigger_phrase: "@claude"
          timeout_minutes: "60"
          github_token: ${{ steps.app-token.outputs.token }}
          use_bedrock: "true"
          model: "us.anthropic.claude-3-7-sonnet-20250219-v1:0"

O formato do ID do modelo para Bedrock inclui o prefixo da região (ex., us.anthropic.claude...) e sufixo da versão.

Fluxo de trabalho Google Vertex AI

Pré-requisitos:

API Vertex AI habilitada no seu projeto GCP
Workload Identity Federation configurado para GitHub
Conta de serviço com permissões Vertex AI

Segredos GitHub necessários:

Nome do Segredo	Descrição
`GCP_WORKLOAD_IDENTITY_PROVIDER`	Nome do recurso do provedor de identidade workload
`GCP_SERVICE_ACCOUNT`	Email da conta de serviço com acesso Vertex AI
`APP_ID`	ID do seu GitHub App (das configurações do app)
`APP_PRIVATE_KEY`	A chave privada que você gerou para seu GitHub App

name: Claude PR Action

permissions:
  contents: write
  pull-requests: write
  issues: write
  id-token: write  

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]

jobs:
  claude-pr:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Generate GitHub App token
        id: app-token
        uses: actions/create-github-app-token@v2
        with:
          app-id: ${{ secrets.APP_ID }}
          private-key: ${{ secrets.APP_PRIVATE_KEY }}

      - name: Authenticate to Google Cloud
        id: auth
        uses: google-github-actions/auth@v2
        with:
          workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
          service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}
      
      - uses: ./.github/actions/claude-pr-action
        with:
          trigger_phrase: "@claude"
          timeout_minutes: "60"
          github_token: ${{ steps.app-token.outputs.token }}
          use_vertex: "true"
          model: "claude-3-7-sonnet@20250219"
        env:
          ANTHROPIC_VERTEX_PROJECT_ID: ${{ steps.auth.outputs.project_id }}
          CLOUD_ML_REGION: us-east5
          VERTEX_REGION_CLAUDE_3_7_SONNET: us-east5

O ID do projeto é automaticamente recuperado do passo de autenticação do Google Cloud, então você não precisa codificá-lo.

Solução de problemas

Claude não respondendo a comandos @claude

Verifique se o GitHub App está instalado corretamente, verifique se os fluxos de trabalho estão habilitados, certifique-se de que a chave de API está definida nos segredos do repositório, e confirme que o comentário contém @claude (não /claude).

CI não executando nos commits do Claude

Certifique-se de que está usando o GitHub App ou app personalizado (não o usuário Actions), verifique se os triggers do fluxo de trabalho incluem os eventos necessários, e verifique se as permissões do app incluem triggers de CI.

Erros de autenticação

Confirme se a chave de API é válida e tem permissões suficientes. Para Bedrock/Vertex, verifique a configuração de credenciais e certifique-se de que os segredos estão nomeados corretamente nos fluxos de trabalho.

Configuração avançada

Parâmetros da action

O Claude Code Action suporta estes parâmetros principais:

Parâmetro	Descrição	Obrigatório
`prompt`	O prompt para enviar ao Claude	Sim*
`prompt_file`	Caminho para arquivo contendo prompt	Sim*
`anthropic_api_key`	Chave de API Anthropic	Sim**
`max_turns`	Máximo de turnos de conversa	Não
`timeout_minutes`	Timeout de execução	Não

*Ou prompt ou prompt_file obrigatório
**Obrigatório para API Anthropic direta, não para Bedrock/Vertex

Métodos alternativos de integração

Embora o comando /install-github-app seja a abordagem recomendada, você também pode:

GitHub App Personalizado: Para organizações que precisam de nomes de usuário com marca ou fluxos de autenticação personalizados. Crie seu próprio GitHub App com permissões necessárias (contents, issues, pull requests) e use a action actions/create-github-app-token para gerar tokens nos seus fluxos de trabalho.
GitHub Actions Manual: Configuração direta de fluxo de trabalho para máxima flexibilidade
Configuração MCP: Carregamento dinâmico de servidores Model Context Protocol

Veja o repositório Claude Code Action para documentação detalhada.

Personalizando o comportamento do Claude

Você pode configurar o comportamento do Claude de duas maneiras:

CLAUDE.md: Defina padrões de codificação, critérios de revisão e regras específicas do projeto em um arquivo CLAUDE.md na raiz do seu repositório. Claude seguirá essas diretrizes ao criar PRs e responder a solicitações. Confira nossa documentação de Memória para mais detalhes.
Prompts personalizados: Use o parâmetro prompt no arquivo de fluxo de trabalho para fornecer instruções específicas do fluxo de trabalho. Isso permite personalizar o comportamento do Claude para diferentes fluxos de trabalho ou tarefas.

Claude seguirá essas diretrizes ao criar PRs e responder a solicitações.

Protocolo de Contexto de Modelo (MCP)Claude Code SDK

On this page

Por que usar Claude Code GitHub Actions?
O que Claude pode fazer?
Claude Code Action
Claude Code Action (Base)
Configuração
Configuração rápida
Configuração manual
Casos de uso de exemplo
Transformar issues em PRs
Obter ajuda de implementação
Corrigir bugs rapidamente
Melhores práticas
Configuração CLAUDE.md
Considerações de segurança
Otimizando performance
Custos de CI
Exemplos de configuração
Usando com AWS Bedrock & Google Vertex AI
Pré-requisitos
Para Google Cloud Vertex AI:
Para AWS Bedrock:
Solução de problemas
Claude não respondendo a comandos @claude
CI não executando nos commits do Claude
Erros de autenticação
Configuração avançada
Parâmetros da action
Métodos alternativos de integração
Personalizando o comportamento do Claude

Começando

Construir com Claude

Implantação

Administração

Referência

Recursos

Claude Code GitHub Actions

Por que usar Claude Code GitHub Actions?

O que Claude pode fazer?

Claude Code Action

Claude Code Action (Base)

Configuração

Configuração rápida

Configuração manual

Casos de uso de exemplo

Transformar issues em PRs

Obter ajuda de implementação

Corrigir bugs rapidamente

Melhores práticas

Configuração CLAUDE.md

Considerações de segurança

Otimizando performance

Custos de CI

Exemplos de configuração

Usando com AWS Bedrock & Google Vertex AI

Pré-requisitos

Para Google Cloud Vertex AI:

Para AWS Bedrock:

Para API Anthropic (Direta):

Para Google Cloud Vertex AI

Para AWS Bedrock

Solução de problemas

Claude não respondendo a comandos @claude

CI não executando nos commits do Claude

Erros de autenticação

Configuração avançada

Parâmetros da action

Métodos alternativos de integração

Personalizando o comportamento do Claude

Começando

Construir com Claude

Implantação

Administração

Referência

Recursos

​Por que usar Claude Code GitHub Actions?

​O que Claude pode fazer?

​Claude Code Action

​Claude Code Action (Base)

​Configuração

​Configuração rápida

​Configuração manual

​Casos de uso de exemplo

​Transformar issues em PRs

​Obter ajuda de implementação

​Corrigir bugs rapidamente

​Melhores práticas

​Configuração CLAUDE.md

​Considerações de segurança

​Otimizando performance

​Custos de CI

​Exemplos de configuração

​Usando com AWS Bedrock & Google Vertex AI

​Pré-requisitos

​Para Google Cloud Vertex AI:

​Para AWS Bedrock:

​Para API Anthropic (Direta):

​Para Google Cloud Vertex AI

​Para AWS Bedrock

​Solução de problemas

​Claude não respondendo a comandos @claude

​CI não executando nos commits do Claude

​Erros de autenticação

​Configuração avançada

​Parâmetros da action

​Métodos alternativos de integração

​Personalizando o comportamento do Claude

Por que usar Claude Code GitHub Actions?

O que Claude pode fazer?

Claude Code Action

Claude Code Action (Base)

Configuração

Configuração rápida

Configuração manual

Casos de uso de exemplo

Transformar issues em PRs

Obter ajuda de implementação

Corrigir bugs rapidamente

Melhores práticas

Configuração CLAUDE.md

Considerações de segurança

Otimizando performance

Custos de CI

Exemplos de configuração

Usando com AWS Bedrock & Google Vertex AI

Pré-requisitos

Para Google Cloud Vertex AI:

Para AWS Bedrock:

Para API Anthropic (Direta):

Para Google Cloud Vertex AI

Para AWS Bedrock

Solução de problemas

Claude não respondendo a comandos @claude

CI não executando nos commits do Claude

Erros de autenticação

Configuração avançada

Parâmetros da action

Métodos alternativos de integração

Personalizando o comportamento do Claude