Les invites système définissent le comportement, les capacités et le style de réponse de Claude. Le SDK Claude Agent fournit trois façons de personnaliser les invites système : utiliser des styles de sortie (configurations persistantes basées sur des fichiers), ajouter à l’invite de Claude Code, ou utiliser une invite entièrement personnalisée.

​
Comprendre les invites système

Une invite système est l’ensemble d’instructions initial qui façonne le comportement de Claude tout au long d’une conversation.
Comportement par défaut : Le SDK Agent utilise une invite système vide par défaut pour une flexibilité maximale. Pour utiliser l’invite système de Claude Code (instructions d’outils, directives de code, etc.), spécifiez systemPrompt: { preset: "claude_code" } en TypeScript ou system_prompt="claude_code" en Python.
L’invite système de Claude Code inclut :
  • Instructions d’utilisation des outils et outils disponibles
  • Directives de style et de formatage du code
  • Paramètres de ton et de verbosité des réponses
  • Instructions de sécurité et de sûreté
  • Contexte sur le répertoire de travail actuel et l’environnement

​
Méthodes de modification

​
Méthode 1 : Styles de sortie (configurations persistantes)

Les styles de sortie sont des configurations sauvegardées qui modifient l’invite système de Claude. Ils sont stockés sous forme de fichiers markdown et peuvent être réutilisés à travers les sessions et les projets.

​
Créer un style de sortie

import { writeFile, mkdir } from 'fs/promises'
import { join } from 'path'
import { homedir } from 'os'

async function createOutputStyle(name: string, description: string, prompt: string) {
  // Niveau utilisateur : ~/.claude/output-styles
  // Niveau projet : .claude/output-styles
  const outputStylesDir = join(homedir(), '.claude', 'output-styles')
  
  await mkdir(outputStylesDir, { recursive: true })
  
  const content = `---
name: ${name}
description: ${description}
---

${prompt}`
  
  const filePath = join(outputStylesDir, `${name.toLowerCase().replace(/\s+/g, '-')}.md`)
  await writeFile(filePath, content, 'utf-8')
}

// Exemple : Créer un spécialiste de révision de code
await createOutputStyle(
  'Code Reviewer',
  'Assistant de révision de code approfondie',
  `Vous êtes un expert en révision de code.

Pour chaque soumission de code :
1. Vérifiez les bugs et les problèmes de sécurité
2. Évaluez les performances
3. Suggérez des améliorations
4. Notez la qualité du code (1-10)`
)

​
Utiliser les styles de sortie

Une fois créés, activez les styles de sortie via :
  • CLI : /output-style [nom-du-style]
  • Paramètres : .claude/settings.local.json
  • Créer nouveau : /output-style:new [description]

​
Méthode 2 : Utiliser systemPrompt avec append

Vous pouvez utiliser le preset Claude Code avec une propriété append pour ajouter vos instructions personnalisées tout en préservant toutes les fonctionnalités intégrées. 
import { query } from "@anthropic-ai/claude-agent-sdk"

const messages = []

for await (const message of query({
  prompt: "Aidez-moi à écrire une fonction Python pour calculer les nombres de fibonacci",
  options: {
    systemPrompt: {
      type: "preset",
      preset: "claude_code",
      append: "Incluez toujours des docstrings détaillées et des annotations de type dans le code Python."
    }
  }
})) {
  messages.push(message)
  if (message.type === 'assistant') {
    console.log(message.message.content)
  }
}

​
Méthode 3 : Invites système personnalisées

Vous pouvez fournir une chaîne personnalisée comme systemPrompt pour remplacer entièrement le défaut par vos propres instructions. 
import { query } from "@anthropic-ai/claude-agent-sdk"

const customPrompt = `Vous êtes un spécialiste du codage Python.
Suivez ces directives :
- Écrivez du code propre et bien documenté
- Utilisez des annotations de type pour toutes les fonctions
- Incluez des docstrings complètes
- Préférez les modèles de programmation fonctionnelle quand c'est approprié
- Expliquez toujours vos choix de code`

const messages = []

for await (const message of query({
  prompt: "Créez un pipeline de traitement de données",
  options: {
    systemPrompt: customPrompt
  }
})) {
  messages.push(message)
  if (message.type === 'assistant') {
    console.log(message.message.content)
  }
}

​
Comparaison des trois approches

FonctionnalitéStyles de sortiesystemPrompt avec appendsystemPrompt personnalisé
Persistance✅ Sauvegardé comme fichiers❌ Session uniquement❌ Session uniquement
Réutilisabilité✅ À travers les projets❌ Duplication de code❌ Duplication de code
Gestion✅ CLI + fichiers⚠️ Dans le code⚠️ Dans le code
Outils par défaut✅ Préservés✅ Préservés❌ Perdus (sauf si inclus)
Sécurité intégrée✅ Maintenue✅ Maintenue❌ Doit être ajoutée
Contexte d’environnement✅ Automatique✅ Automatique❌ Doit être fourni
Niveau de personnalisation⚠️ Remplace le défaut⚠️ Ajouts uniquement✅ Contrôle complet
Contrôle de version✅ Oui✅ Avec le code✅ Avec le code
Découverte✅ /output-style❌ Non découvrable❌ Non découvrable
Note : “Avec append” signifie utiliser systemPrompt: { type: "preset", preset: "claude_code", append: "..." } en TypeScript ou system_prompt={"type": "preset", "preset": "claude_code", "append": "..."} en Python.

​
Cas d’usage et meilleures pratiques

​
Quand utiliser les styles de sortie

Idéal pour :
  • Changements de comportement persistants à travers les sessions
  • Configurations partagées en équipe
  • Assistants spécialisés (réviseur de code, data scientist, DevOps)
  • Modifications d’invites complexes qui nécessitent un versioning
Exemples :
  • Créer un assistant d’optimisation SQL dédié
  • Construire un réviseur de code axé sur la sécurité
  • Développer un assistant d’enseignement avec une pédagogie spécifique

​
Quand utiliser systemPrompt avec append

Idéal pour :
  • Ajouter des standards ou préférences de codage spécifiques
  • Personnaliser le formatage de sortie
  • Ajouter des connaissances spécifiques au domaine
  • Modifier la verbosité des réponses
  • Améliorer le comportement par défaut de Claude Code sans perdre les instructions d’outils

​
Quand utiliser systemPrompt personnalisé

Idéal pour :
  • Contrôle complet sur le comportement de Claude
  • Tâches spécialisées à session unique
  • Tester de nouvelles stratégies d’invites
  • Situations où les outils par défaut ne sont pas nécessaires
  • Construire des agents spécialisés avec un comportement unique

​
Combiner les approches

Vous pouvez combiner ces méthodes pour une flexibilité maximale :

​
Exemple : Style de sortie avec ajouts spécifiques à la session

import { query } from "@anthropic-ai/claude-agent-sdk"

// En supposant que le style de sortie "Code Reviewer" est actif (via /output-style)
// Ajouter des domaines de focus spécifiques à la session
const messages = []

for await (const message of query({
  prompt: "Révisez ce module d'authentification",
  options: {
    systemPrompt: {
      type: "preset",
      preset: "claude_code",
      append: `
        Pour cette révision, priorisez :
        - Conformité OAuth 2.0
        - Sécurité du stockage des tokens
        - Gestion des sessions
      `
    }
  }
})) {
  messages.push(message)
}

​
Voir aussi