English 中文 العربية 日本語 Português

Claude Code: Fluxo de Trabalho Git e GitHub Actions

Última atualização: 2026-08-31

O Claude Code não apenas escreve código — ele se integra ao seu fluxo de trabalho Git, desde convenções de commit até reviews de PR, desde integração CI até correções automatizadas.

💡 Dica: O núcleo da integração com fluxo Git é "humano-no-loop" — Claude Code assiste, humanos decidem. Automação (CI/CD) usa modo headless; dev diário usa modo interativo.

📋 Pré-requisitos: Capítulo 22 - Variáveis de Ambiente e Configuração de Dev

1. O Que Você Vai Aprender

2. Integração com Fluxo de Trabalho Git

(1) Comandos Comuns de Integração Git

Operação Comando Descrição
Commit mudanças /commit Auto-gerar mensagem de commit
Ver mudanças /diff Ver modificações da sessão atual
Desfazer operação /undo Desfazer última operação

▶ Exemplo 1: Fluxo Git Assistido pelo Claude Code

TEXT 📖 Somente leitura 
> Complete user registration feature development

Claude Code: Created files, tests pass ✅

> /commit

Claude Code auto-generates:
  feat: add user registration service

  - Create registration.service.ts with email/password signup
  - Add POST /api/register endpoint
  - Add input validation
  - Write 6 unit tests (all passing)

  Allow commit? [y/n] y
  ✅ Committed: feat: add user registration service

3. Automação de Convenções de Commit

(1) Integração com Conventional Commits

Tipo de Mudança Prefixo Exemplo
Nova funcionalidade feat: feat: add user registration
Correção fix: fix: token refresh on expiry
Refatoração refactor: refactor: extract validation logic
Teste test: test: add registration tests
Documentação docs: docs: update API documentation
Estilo style: style: fix indentation
Config chore: chore: update dependencies

4. Integração com GitHub Actions

(1) Auto-Review de PR

YAML 
# .github/workflows/ai_review.yml
name: AI Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  ai-review:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      - name: AI Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude --headless --output json \
            "Review this PR: security, performance, style, test coverage" > review.json
      - name: Post Review
        run: |
          COMMENT=$(jq -r '.result.summary' review.json)
          gh pr comment ${{ github.event.pull_request.number }} --body "$COMMENT"
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

(2) Auto-Corrigir Problemas de Lint

YAML 
# .github/workflows/auto-fix.yml
name: Auto Fix Lint
on:
  push:
    branches: [main]

jobs:
  auto-fix:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      - name: Fix Lint
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude --headless --allowed-tools Read,Write \
            "Run npm run lint, fix all auto-fixable issues"
      - name: Commit Fixes
        run: |
          git config user.name "Claude Code Bot"
          git add -A
          git diff --staged --quiet || git commit -m "style: auto-fix lint issues"
          git push

5. Prática de Review de PR

(1) Review Duplo Humano + IA

Dimensão Review IA Review Humano
Vulnerabilidades de segurança ✅ Bom em Suplementar
Estilo de código ✅ Bom em Não necessário
Desempenho ✅ Geral Cenários críticos
Lógica de negócios ❌ Fraco ✅ Central
Design de arquitetura ❌ Fraco ✅ Central

❓ Perguntas Frequentes

P: O Claude Code pode auto-mergear PRs? R: Tecnicamente sim mas não recomendado. CI Claude Code apenas revisa e sugere; decisão de merge é humana.

P: Quem paga os custos de API do GitHub Actions? R: Usa a API Key nos Secrets do repositório; custos arcados pelo dono da Key. Recomenda-se CI Key separada com limites de cota.

P: Como evitar loop infinito no CI? R: Commits de auto-fix não devem acionar novos workflows. Adicione if: github.actor != 'claude-code-bot' no YAML.

P: Funciona com GitLab CI? R: Sim. O Claude Code é uma ferramenta CLI; qualquer ambiente CI que possa rodar npm pode usá-lo.

📖 Resumo

📝 Exercícios

  1. Básico (⭐): Use /commit para commitar mudanças, verifique qualidade da mensagem auto-gerada.
  2. Intermediário (⭐⭐): Configure GitHub Actions para auto-review de segurança em PRs.
  3. Avançado (⭐⭐⭐): Construa pipeline completo de review IA (segurança+qualidade+cobertura) com auto comentários em PR.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%