Rode Claude Code no GitHub Actions e Pipelines CI/CD
Claude Code roda em modo headless para CI/CD. Use-o no GitHub Actions para auto-revisar PRs, triar issues, gerar correções e manter qualidade de código em escala.
O modo headless do Claude Code (flag -p) permite que ele rode sem interação humana, o que o torna perfeito para pipelines CI/CD. Você pode automatizar code reviews, gerar correções para testes falhando, triar issues e impor padrões de código em cada push.
Como rodar o Claude Code em modo headless?
A flag -p roda o Claude Code com um prompt e encerra quando terminar. Ele lê o projeto, executa a tarefa e retorna o resultado. Sem necessidade de terminal interativo.
# Uso básico headless
claude -p "Revise as alterações no último commit e reporte problemas"
# Com formato de saída
claude -p "Liste todos os comentários TODO na codebase" --output-format json
# Com limite de orçamento
claude -p "Corrija os testes falhando" --max-budget-usd 1.00Como configurar o Claude Code no GitHub Actions?
name: AI Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Install Claude Code
run: npm install -g @anthropic-ai/claude-code
- name: Review PR
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
claude -p "Revise as alterações deste PR. \
Verifique bugs, problemas de segurança e violações de estilo. \
Poste sua revisão como comentário no PR." \
--max-budget-usd 2.00 \
--dangerously-skip-permissionsA flag --dangerously-skip-permissions é necessária em CI/CD porque não há humano para aprovar uso de ferramentas. Use apenas em ambientes controlados com código confiável. Nunca use em repositórios públicos sem controles de acesso cuidadosos.
Quais tarefas CI/CD o Claude Code pode automatizar?
| Tarefa | Trigger | O que o Claude Code faz |
|---|---|---|
| Code review de PR | pull_request opened | Revisa diff, posta comentários sobre problemas encontrados |
| Corrigir testes falhando | push (após falha de teste) | Lê saída do teste, corrige código, faz push de commit |
| Triagem de issues | issues opened | Lê issue, adiciona labels, atribui prioridade |
| Geração de changelog | release published | Lê commits desde última tag, gera changelog |
| Atualização de docs | push para main | Atualiza docs da API baseado em mudanças no código |
| Auditoria de segurança | schedule (semanal) | Escaneia vulnerabilidades comuns, abre issues |
Como lidar com chaves de API e custos?
- +Armazene ANTHROPIC_API_KEY nos GitHub Secrets (nunca no código)
- +Use --max-budget-usd para limitar gasto por execução (ex: $2 por review de PR)
- +Use modelo Sonnet para tarefas sensíveis a custo: claude -p "..." --model sonnet
- +Monitore uso no seu dashboard Anthropic
Como usar o Claude Code com GitLab CI?
# .gitlab-ci.yml
ai-review:
stage: review
image: node:20
script:
- npm install -g @anthropic-ai/claude-code
- claude -p "Revise as alterações do MR e reporte problemas" --max-budget-usd 2.00 --dangerously-skip-permissions
rules:
- if: $CI_PIPELINE_SOURCE == "merge_request_event"