Blog

O que é Claude Code GitHub Actions?

Ashley Goolam

Ashley Goolam

9 junho 2025

O que é Claude Code GitHub Actions?

Gostaria de turbinar seu fluxo de trabalho de desenvolvimento com IA? Conheça a Ação do Github Claude Code, um divisor de águas que traz a IA Claude da Anthropic para seus repositórios GitHub. Basta mencionar um @claude em um pull request ou issue, e pronto — o Claude cria código, corrige bugs ou refatora como um profissional, tudo via Github Actions. Configurei isso em 15 minutos, e é incrivelmente eficiente! Neste tutorial, guiarei você pela instalação da Ação do Github Claude Code, sua configuração e uso para automatizar suas tarefas de codificação. Pronto para deixar a IA fazer o trabalho pesado? Vamos mergulhar!

💡
Trabalhando com APIs ou documentando seus projetos? Pegue o APIdog para otimizar o design e teste de API. É um companheiro perfeito para seus fluxos de trabalho do Github Actions!
button

Por Que a Ação do Github Claude Code Arrasa

A Ação do Github Claude Code é como ter um programador genial na sua equipe, 24 horas por dia, 7 dias por semana. Construída sobre a IA Claude da Anthropic, ela escuta por menções @claude no seu repositório e entra em ação, impulsionada pelo Github Actions. Veja por que é incrível:

O repositório GitHub possui um fluxo de trabalho elegante, e eu vi ele gerar uma função refatorada em segundos. Vamos fazê-lo funcionar!

claude com github actions

Como a Ação do Github Claude Code Funciona

O Claude Code se conecta ao Github Actions para monitorar seu repositório por menções @claude em issues, pull requests ou comentários de revisão. Quando acionado, ele:

É como ter um amigo de codificação que nunca dorme, tudo impulsionado pelos runners do Github Actions. Pronto para configurar? Veja como!

Configuração Passo a Passo: Ação do Github Claude Code

Vamos fazer o Claude Code rodar no seu repositório. Testei isso em um projeto Node.js, mas funciona para qualquer base de código. Siga estes passos para automatizar seu fluxo de trabalho em ~15 minutos.

1. Instale o Aplicativo Claude para GitHub

Você precisará de direitos de administrador para o seu repositório.

baixar claude

2. Adicione Sua Chave de API da Anthropic

O Claude precisa de uma chave de API para fazer sua mágica.

3. Adicione o Arquivo de Fluxo de Trabalho do Claude

Agora, vamos configurar o fluxo de trabalho do Github Actions.

# .github/workflows/claude.yml
name: Claude PR Assistant

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

jobs:
  claude-code-action:
    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 == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - name: Run Claude PR Action
        uses: grll/claude-code-action@beta
        with:
          use_oauth: true
          claude_access_token: ${{ secrets.CLAUDE_ACCESS_TOKEN }}
          claude_refresh_token: ${{ secrets.CLAUDE_REFRESH_TOKEN }}
          claude_expires_at: ${{ secrets.CLAUDE_EXPIRES_AT }}
          
          timeout_minutes: "60"
          # Opcional: adicione uma frase de gatilho personalizada (padrão: @claude)
          # trigger_phrase: "/claude"
          # Opcional: adicione gatilho de responsável para issues
          # assignee_trigger: "claude"
          # Opcional: adicione variáveis de ambiente personalizadas (formato YAML)
          # claude_env: |
          #   NODE_ENV: test
          #   DEBUG: true
          #   API_URL: https://api.example.com

4. Configure os Segredos do Aplicativo GitHub

Para que o fluxo de trabalho gere tokens de aplicativo:

5. Acione o Claude com @claude

Agora, teste!

@claude Por favor, refatore a lógica de busca de dados em `api.js` para melhor tratamento de erros.
@claude

Personalizando a Ação do Github Claude Code

Quer ajustar o comportamento do Claude? O fluxo de trabalho do Github Actions é super flexível. Veja como personalizá-lo:

Adicionei um CLAUDE.md com “prefira TypeScript”, e os PRs do Claude combinaram perfeitamente com meu estilo!

Casos de Uso Reais: Claude Code em Ação

O Claude Code se destaca em acelerar tarefas de desenvolvimento. Veja o que tentei e o que você pode fazer com o Github Actions:

resultados de correção do github actions

Dicas para Dominar a Ação do Github Claude Code

Para tirar o máximo proveito do Claude Code com o Github Actions:

Descobri que prompts detalhados reduziram o tempo de resposta do Claude pela metade — a precisão compensa!

Por Que a Ação do Github Claude Code se Destaca

A Ação do Github Claude Code é uma fera da produtividade. É mais rápida que a codificação manual, respeita o estilo do seu projeto e executa com segurança nos runners do Github Actions. Comparado a outras ferramentas de IA, a capacidade do Claude de criar PRs completos a partir de um único comentário é incomparável. A configuração é rápida, e a integração com o GitHub parece nativa. Pequeno contratempo: tarefas complexas podem precisar de ajuste nos prompts, mas os exemplos do repositório ajudam.

Seja você um desenvolvedor solo ou parte de uma equipe, o Claude Code faz a codificação parecer mágica. Não deixe de experimentá-lo!

button

Pratique o design de API no Apidog

Descubra uma forma mais fácil de construir e usar APIs

Cadastre-se gratuitamenteBaixar