System-Prompt
Ein System-Prompt ist der Anweisungsblock vor dem Gespräch, der einem Modell in einer Anfrage seine Rolle und Regeln vorgibt.
In der Claude-API ist es der Parameter system, der von der Nachrichtenliste getrennt gehalten wird. Bei einem Coding-Agenten wird es von den Erstellern des Agenten und nicht von Ihnen geschrieben: Es deckt ab, wie sich der Agent verhält, wie er seine Tools verwendet und wie er Antworten formatiert, und es ist vorhanden, bevor Sie etwas eingeben. Mit Claude Code können Sie es durch --system-prompt ersetzen oder durch --append-system-prompt erweitern.
Um ihn herum liegen weitere Schichten. Die API von Anthropic fügt eine eigene System-Prompt hinzu, wenn Werkzeuge definiert werden, und eine weitere, wenn das Denken aktiv ist; jede Anfrage enthält die Werkzeugdefinitionen, die der Client verfügbar macht. CLAUDE.md ist nicht Teil davon: Claude Code lädt diese Datei als Benutzermeldung nach der System-Prompt.
Da es von einer Anfrage zur nächsten identisch ist, handelt es sich um den Teil, den das Prompt-Caching am besten bewältigt. Das Lesen aus dem Cache erfolgt zu einem Bruchteil des Eingabepreises nach der ersten Anfrage. Die Konsequenz daraus ist, dass eine Änderung teuer ist. Anthropic speichert Prompt-Präfixe in der Reihenfolge Tools, dem System-Prompt und den Nachrichten, sodass eine bearbeitete System-Prompt alles danach ungültig macht und die nächste Anfrage die gesamte Konversation erneut verarbeitet.
Anweisungen, die für eine einzelne Aufgabe gedacht sind, gehören daher in die Konversation und nicht in der System-Prompt. Der Planmodus und die Skills von Claude Code hängen ihre Anweisungen als Konversationsnachrichten an, wodurch das zwischengespeicherte Präfix intakt bleibt.