Ejecuta Claude Code en GitHub Actions y Pipelines CI/CD
Claude Code se ejecuta en modo headless para CI/CD. Úsalo en GitHub Actions para auto-revisar PRs, clasificar issues, generar correcciones y mantener la calidad del código a escala.
El modo headless de Claude Code (flag -p) le permite ejecutarse sin interacción humana, lo que lo hace perfecto para pipelines CI/CD. Puedes automatizar revisiones de código, generar correcciones para pruebas que fallan, clasificar issues e imponer estándares de código en cada push.
Cómo ejecutar Claude Code en modo headless
El flag -p ejecuta Claude Code con un prompt y sale cuando termina. Lee el proyecto, ejecuta la tarea y produce el resultado. No se necesita terminal interactiva.
# Uso básico en modo headless
claude -p "Revisa los cambios del último commit y reporta cualquier problema"
# Con formato de salida
claude -p "Lista todos los comentarios TODO en la base de código" --output-format json
# Con límite de presupuesto
claude -p "Corrige las pruebas que fallan" --max-budget-usd 1.00Cómo configurar Claude Code en 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 "Revisa los cambios de este PR. \
Busca bugs, problemas de seguridad y violaciones de estilo. \
Publica tu revisión como comentario del PR." \
--max-budget-usd 2.00 \
--dangerously-skip-permissionsEl flag --dangerously-skip-permissions es necesario en CI/CD porque no hay un humano para aprobar el uso de herramientas. Solo úsalo en entornos controlados con código de confianza. Nunca lo uses en repositorios públicos sin controles de acceso cuidadosos.
Qué tareas de CI/CD puede automatizar Claude Code
| Tarea | Trigger | Qué hace Claude Code |
|---|---|---|
| Revisión de código del PR | pull_request abierto | Revisa el diff, publica comentarios sobre problemas encontrados |
| Corregir pruebas que fallan | push (después de fallo en pruebas) | Lee la salida de pruebas, corrige el código, pushea un commit |
| Triaje de issues | issue abierto | Lee el issue, añade etiquetas, asigna prioridad |
| Generación de changelog | release publicada | Lee commits desde el último tag, genera changelog |
| Actualización de documentación | push a main | Actualiza documentación de API basándose en cambios de código |
| Auditoría de seguridad | schedule (semanal) | Escanea vulnerabilidades comunes, abre issues |
Cómo manejar claves API y costos
- +Almacena ANTHROPIC_API_KEY en GitHub Secrets (nunca en código)
- +Usa --max-budget-usd para limitar el gasto por ejecución (ej. $2 por revisión de PR)
- +Usa el modelo Sonnet para tareas sensibles al costo: claude -p "..." --model sonnet
- +Monitorea el uso en tu dashboard de Anthropic
Cómo usar Claude Code con GitLab CI
# .gitlab-ci.yml
ai-review:
stage: review
image: node:20
script:
- npm install -g @anthropic-ai/claude-code
- claude -p "Revisa los cambios del MR y reporta problemas" --max-budget-usd 2.00 --dangerously-skip-permissions
rules:
- if: $CI_PIPELINE_SOURCE == "merge_request_event"