Ändern von Systemaufforderungen

• Wie Systemaufforderungen funktionieren, mit einer Entscheidungstabelle zur Wahl zwischen der Voreinstellung, der Voreinstellung mit append und einer benutzerdefinierten Aufforderung
• Passen Sie das Verhalten des Agenten an mit CLAUDE.md-Dateien, Ausgabestilen, append oder einer benutzerdefinierten Zeichenkette
• Vergleichen Sie die vier Ansätze nach Persistenz, Umfang und was sie bewahren
• Kombinieren Sie Ansätze, um Anpassungsmethoden übereinander zu schichten

​

Wie Systemaufforderungen funktionieren

• Minimale Standardeinstellung: Wenn Sie systemPrompt in TypeScript oder system_prompt in Python nicht festlegen, verwendet das SDK eine minimale Aufforderung, die Werkzeugaufrufe abdeckt, aber Claude Code’s Codierungsrichtlinien, Antwortstil und Projektkontext auslässt. Dies unterscheidet sich von claude -p, das standardmäßig die vollständige Claude Code-Aufforderung verwendet. Wenn Sie von der CLI migrieren und ein übereinstimmendes Verhalten wünschen, legen Sie die claude_code-Voreinstellung fest.
• claude_code-Voreinstellung: die vollständige Systemaufforderung, die die Claude Code CLI verwendet, mit Werkzeugnutzungsanweisungen, Code-Stil- und Formatierungsrichtlinien, Antworttone und Ausführlichkeitsregeln, Sicherheits- und Sicherheitsanweisungen sowie Kontext zum Arbeitsverzeichnis und zur Umgebung. Legen Sie systemPrompt: { type: "preset", preset: "claude_code" } in TypeScript oder system_prompt={"type": "preset", "preset": "claude_code"} in Python fest, optional mit append, um Ihre eigenen Anweisungen am Ende hinzuzufügen.
• Benutzerdefinierte Zeichenkette: eine Aufforderung, die Sie selbst schreiben. Das SDK sendet nur das, was Sie bereitstellen.

​

Entscheiden Sie sich für einen Ausgangspunkt

• Andere Oberfläche: Die Ausgabe wird nicht in einem Terminal von der Person gelesen, die sie ausgelöst hat. Chat-UIs, Strukturierte-Ausgabe-Consumer und Nicht-Codierungs-Automatisierung benötigen jeweils eine Aufforderung, die damit übereinstimmt, wie ihre Ausgabe gerendert und überprüft wird. Unbeaufsichtigte Codierungs-Automatisierung, wie ein CI-Job, der Lint-Fehler behebt oder Diffs überprüft, passt immer noch zur Voreinstellung, da die Arbeit selbst das ist, wofür die Voreinstellung geschrieben wurde.
• Andere Identität: Der Agent sollte sich nicht als Claude Code präsentieren. Ein Support-Bot, ein Datenanalyse-Assistent oder ein domänenspezifischer Agent benötigt seinen eigenen Namen, Umfang und eine eigene Persona.
• Anderes Berechtigungsmodell: Der Agent läuft autonom ohne menschliche Genehmigung bei jedem Schritt, oder arbeitet mit einem engen Satz von Ressourcen. Claude Code’s Aufforderung geht davon aus, dass ein Mensch in der Schleife ist und Zugriff auf einen vollständigen Werkzeugsatz hat.
• Nicht-Codierungs-Aufgaben: Der Großteil von Claude Code’s Aufforderung ist Codierungs-Anleitung. Für Forschungs-, Inhalts- oder Operations-Agenten konkurriert diese Anleitung mit den Anweisungen, die Sie tatsächlich benötigen.

​

Verhalten des Agenten anpassen

​

CLAUDE.md-Dateien für projektspezifische Anweisungen

​

CLAUDE.md mit dem SDK laden

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

const messages = [];

for await (const message of query({
  prompt: "Add a new React component for user profiles",
  options: {
    systemPrompt: {
      type: "preset",
      preset: "claude_code" // Use Claude Code's system prompt
    },
    settingSources: ["project"] // Loads CLAUDE.md from project
  }
})) {
  messages.push(message);
}

// Now Claude has access to your project guidelines from CLAUDE.md

​

Ausgabestile für persistente Konfigurationen

​

Einen Ausgabestil erstellen

---
name: Code Reviewer
description: Thorough code review assistant
keep-coding-instructions: true
---

You are an expert code reviewer.

For every code submission:
1. Check for bugs and security issues
2. Evaluate performance
3. Suggest improvements
4. Rate code quality (1-10)

​

Einen Ausgabestil aktivieren

• CLI: Führen Sie /config aus und wählen Sie einen Ausgabestil
• Einstellungen: Setzen Sie outputStyle in .claude/settings.local.json
• TypeScript SDK: Setzen Sie outputStyle innerhalb des Inline-settings-Objekts, das an query() übergeben wird, oder verweisen Sie settings auf eine Einstellungsdatei, die es setzt. outputStyle ist kein Feld auf oberster Ebene von Options

​

An die claude_code-Voreinstellung anhängen

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

const messages = [];

for await (const message of query({
  prompt: "Help me write a Python function to calculate fibonacci numbers",
  options: {
    systemPrompt: {
      type: "preset",
      preset: "claude_code",
      append: "Always include detailed docstrings and type hints in Python code."
    }
  }
})) {
  messages.push(message);
  if (message.type === "assistant") {
    console.log(message.message.content);
  }
}

​

Prompt-Caching über Benutzer und Maschinen verbessern

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

for await (const message of query({
  prompt: "Triage the open issues in this repo",
  options: {
    systemPrompt: {
      type: "preset",
      preset: "claude_code",
      append: "You operate Acme's internal triage workflow. Label issues by component and severity.",
      excludeDynamicSections: true
    }
  }
})) {
  // ...
}

​

Benutzerdefinierte Systemaufforderungen

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

const customPrompt = `You are a Python coding specialist.
Follow these guidelines:
- Write clean, well-documented code
- Use type hints for all functions
- Include comprehensive docstrings
- Prefer functional programming patterns when appropriate
- Always explain your code choices`;

const messages = [];

for await (const message of query({
  prompt: "Create a data processing pipeline",
  options: {
    systemPrompt: customPrompt
  }
})) {
  messages.push(message);
  if (message.type === "assistant") {
    console.log(message.message.content);
  }
}

​

Vergleich der vier Ansätze

​

Anwendungsfälle und Best Practices

​

Wann CLAUDE.md verwenden

​

Wann Ausgabestile verwenden

• Persistente Verhaltensänderungen über Sitzungen hinweg
• Team-gemeinsame Konfigurationen
• Spezialisierte Assistenten wie ein Code-Reviewer, Datenwissenschaftler oder DevOps-Assistent
• Komplexe Aufforderungsänderungen, die Versionierung benötigen

• Erstellen eines dedizierten SQL-Optimierungsassistenten
• Aufbau eines sicherheitsorientierten Code-Reviewers
• Entwicklung eines Lehrers mit spezifischer Pädagogik

​

Wann systemPrompt mit Append verwenden

• Hinzufügen spezifischer Codierungsstandards oder Vorlieben
• Anpassung der Ausgabeformatierung
• Hinzufügen domänenspezifischen Wissens
• Änderung der Antwortausführlichkeit
• Verbesserung des Standardverhaltens von Claude Code ohne Verlust von Werkzeuganweisungen

​

Wann benutzerdefinierte systemPrompt verwenden

• Vollständige Kontrolle über Claudes Verhalten
• Spezialisierte Aufgaben mit einer Sitzung
• Testen neuer Aufforderungsstrategien
• Situationen, in denen Standard-Werkzeuge nicht benötigt werden
• Aufbau spezialisierter Agenten mit einzigartigem Verhalten

​

Ansätze kombinieren

​

Einen Ausgabestil mit sitzungsspezifischen Ergänzungen kombinieren

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

// Assuming "Code Reviewer" output style is active (via /config or settings)
// Add session-specific focus areas
const messages = [];

for await (const message of query({
  prompt: "Review this authentication module",
  options: {
    systemPrompt: {
      type: "preset",
      preset: "claude_code",
      append: `
        For this review, prioritize:
        - OAuth 2.0 compliance
        - Token storage security
        - Session management
      `
    }
  }
})) {
  messages.push(message);
}

​

Siehe auch

• Ausgabestile: Erstellen, verwalten und teilen Sie Ausgabestile für die CLI, einschließlich des Dateiformats und der Speicherorte
• Wie Claude sich Ihr Projekt merkt: Was in CLAUDE.md gehört, wo Sie es platzieren, und wie Sie effektive Projektanweisungen schreiben
• TypeScript SDK-Referenz: Der vollständige Options-Typ, einschließlich systemPrompt, settingSources und settings
• Python SDK-Referenz: Der vollständige ClaudeAgentOptions-Typ, einschließlich system_prompt und setting_sources
• Einstellungen: Die settings.json-Referenz, einschließlich des Speicherorts von Ausgabestilen und anderen Konfigurationen