Mode headless et intégration CI avec Claude Code

Mode headless et intégration CI avec Claude Code

L'utilisation de Claude Code en mode non interactif permet d'automatiser des tâches d'ingénierie directement au sein d'une pipeline d'intégration continue. Ce mode headless s'exécute sans intervention humaine en acceptant des instructions textuelles transmises en argument, ce qui convient aux scripts de validation et aux serveurs d'intégration.

Pour lancer une session automatisée depuis un script bash dans un pipeline CI, on utilise l'option dédiée permettant de passer un prompt directement en ligne de commande :

claude --non-interactive -p "Vérifie la conformité des types TypeScript sur les derniers commits et corrige les erreurs simples."

Les points de configuration essentiels pour cette intégration incluent :

• La transmission des identifiants : La variable d'environnement ANTHROPIC_API_KEY doit être injectée de manière sécurisée dans le contexte d'exécution du job CI.
• La gestion des codes de sortie : Le processus renvoie un code non nul en cas d'échec technique, permettant d'interrompre immédiatement la pipeline.
• La limitation des permissions : L'utilisation du paramètre --dangerously-skip-permissions est requise en environnement isolé pour éviter les blocages liés aux invites de validation interactive.

Cette approche permet d'intégrer des vérifications sémantiques complexes ou des refactorisations ciblées directement avant la fusion d'une branche, en s'appuyant sur le moteur de Claude Code exécuté par le runner de la CI.