Claude Code en mode headless pour la CI
Le mode headless de Claude Code permet d'exécuter des requêtes directement depuis un script ou un pipeline d'intégration continue, sans interface interactive. Cette approche automatise des tâches répétitives comme la génération de rapports de couverture, la correction de bugs simples ou la revue de code automatisée avant la fusion d'une branche.
Configuration et exécution
Pour lancer une commande en arrière-plan sans intervention humaine, on utilise l'option dédiée dans le terminal ou au sein d'un fichier YAML de CI. Voici un exemple d'intégration dans un pipeline GitHub Actions :
name: Claude Code CI Check
on: [pull_request]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run Claude Code Headless
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: claude-code --headless --prompt "Analyse les modifications de cette PR et liste les risques de régression."
Bonnes pratiques d'intégration
- Limiter les permissions du jeton d'API utilisé dans les environnements de CI.
- Stocker les instructions métier dans un fichier de configuration versionné pour éviter les prompts trop longs en ligne de commande.
- Consigner la sortie standard de la commande dans un fichier de log accessible pour le suivi des builds.