Prompt système
Un prompt système est un bloc d'instructions envoyé avant la conversation à chaque requête, qui fixe le rôle du modèle et les règles qu'il suit.
Dans l'API Claude, il correspond au paramètre system, distinct des messages. Dans un agent de code, ses concepteurs le rédigent avant que vous tapiez quoi que ce soit : il encadre le comportement de l'agent, l'usage de ses outils et la forme des réponses. Claude Code permet de le remplacer avec --system-prompt ou de le compléter avec --append-system-prompt.
D'autres couches l'entourent. L'API Anthropic ajoute ses propres instructions système quand des outils sont définis et quand la réflexion est active ; chaque requête inclut les définitions d'outils que le client rend disponibles. CLAUDE.md n'appartient pas au prompt système : Claude Code le charge comme message utilisateur après celui-ci.
Puisqu'il reste identique d'une requête à l'autre, le prompt système se prête bien au cache. Après le premier appel, il est relu à une fraction du prix d'entrée. La conséquence inverse est qu'une modification coûte cher. Anthropic met en cache dans l'ordre outils, prompt système, messages : retoucher le prompt système invalide tous les messages qui le suivent et oblige à retraiter la conversation.
Les instructions propres à une tâche ont donc leur place dans la conversation. Le mode plan et les skills de Claude Code ajoutent leurs instructions sous forme de messages, ce qui laisse intact le préfixe déjà mis en cache.