Exécution non interactive en intégration continue
Le mode headless de Claude Code permet d'exécuter des requêtes directement depuis un script ou un pipeline CI/CD, sans intervention humaine. Cette approche s'avère utile pour automatiser des tâches répétitives comme la génération de rapports d'analyse de code, la correction de bugs simples détectés par des tests unitaires ou la mise à jour de documentation technique.
Configuration de la commande headless
Pour lancer Claude Code en arrière-plan sans interface interactive, on utilise l'option --print combinée avec l'indicateur --non-interactive. Cela force l'outil à traiter la consigne fournie en argument, à afficher le résultat brut dans la sortie standard, puis à s'arrêter immédiatement.
claude --non-interactive --print "Analyse les erreurs du fichier log et propose un patch correctif"Intégration dans un workflow GitHub Actions
L'utilisation dans un pipeline nécessite de transmettre la clé d'API via les secrets du dépôt et d'installer l'outil dans l'environnement d'exécution. Voici un exemple minimaliste de tâche automatisée :
- Installation globale du paquet npm de Claude Code
- Injection de la variable d'environnement
ANTHROPIC_API_KEY - Exécution de la commande d'audit sur une branche spécifique
- Création automatique d'une pull request contenant les modifications générées
Cette méthode garantit que le traitement s'exécute de manière déterministe dans un environnement isolé, facilitant ainsi la traçabilité des modifications apportées au code source par l'assistant.