Mode headless et intégration CI avec Claude Code
L'utilisation de Claude Code ne se limite pas aux sessions interactives en ligne de commande. Il est possible de l'exécuter de manière automatisée au sein de pipelines d'intégration continue grâce au mode headless.
Configuration et exécution non interactive
Pour lancer une tâche de refactorisation ou de génération de code sans intervention humaine, on utilise l'option dédiée à l'exécution directe en transmettant l'instruction en paramètre. Cette approche convient aux scripts de maintenance et aux vérifications programmées.
claude --non-interactive --print "Vérifie la conformité des types TypeScript dans src/ et corrige les erreurs évidentes"Intégration dans un pipeline d'intégration continue
Dans un fichier de configuration de pipeline, par exemple avec GitHub Actions, l'outil s'installe via npm et s'exécute en injectant les clés d'API nécessaires sous forme de secrets sécurisés. Voici un exemple d'étape de validation automatisée :
- name: Audit de code par Claude Code
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
npx @anthropic-ai/claude-code --non-interactive --dangerously-skip-permissions "Exécute les tests unitaires et analyse les échecs"L'indicateur --dangerously-skip-permissions s'avère indispensable en environnement conteneurisé headless pour éviter les blocages liés aux demandes de validation utilisateur. Il autorise l'outil à modifier les fichiers et à exécuter les commandes système définies dans l'instruction.
Gestion des retours et des statuts de sortie
Le mode headless transmet les codes de sortie standards du système d'exploitation. Un échec d'exécution ou une erreur critique renvoyée par le modèle interrompt le pipeline, permettant ainsi d'annuler une fusion ou un déploiement en cas de non-conformité détectée par l'assistant.