Modifica dei system prompt

• Come funzionano i system prompt, con una tabella decisionale per scegliere tra il preset, il preset con append, e un prompt personalizzato
• Personalizza il comportamento dell’agente con file CLAUDE.md, stili di output, append, o una stringa personalizzata
• Confronta i quattro approcci per persistenza, ambito, e cosa preservano
• Combina gli approcci per stratificare i metodi di personalizzazione insieme

​

Come funzionano i system prompt

• Default minimalista: quando non impostate systemPrompt in TypeScript o system_prompt in Python, l’SDK utilizza un prompt minimalista che copre la chiamata degli strumenti ma omette le linee guida di codifica di Claude Code, lo stile di risposta e il contesto del progetto. Questo differisce da claude -p, che utilizza il prompt completo di Claude Code per impostazione predefinita. Se state migrando dalla CLI e desiderate un comportamento corrispondente, impostate il preset claude_code.
• Preset claude_code: il system prompt completo che utilizza la CLI di Claude Code, con istruzioni di utilizzo degli strumenti, linee guida di stile e formattazione del codice, regole di tono e verbosità della risposta, istruzioni di sicurezza e protezione, e contesto sulla directory di lavoro e sull’ambiente. Impostate systemPrompt: { type: "preset", preset: "claude_code" } in TypeScript o system_prompt={"type": "preset", "preset": "claude_code"} in Python, facoltativamente con append per aggiungere le vostre istruzioni alla fine.
• Stringa personalizzata: un prompt che scrivete voi stessi. L’SDK invia solo ciò che fornite.

​

Decidere un punto di partenza

• Superficie diversa: l’output non viene letto in un terminale dalla persona che lo ha attivato. Le interfacce chat, i consumatori di output strutturato e l’automazione non di codifica hanno ciascuno bisogno di un prompt che corrisponda a come il loro output viene renderizzato e revisionato. L’automazione di codifica incustodita, come un lavoro CI che corregge gli errori di lint o esamina i diff, si adatta comunque al preset perché il lavoro stesso è quello per cui il preset è scritto.
• Identità diversa: l’agente non dovrebbe presentarsi come Claude Code. Un bot di supporto, un assistente di analisi dei dati, o qualsiasi agente specifico del dominio ha bisogno del suo proprio nome, ambito e persona.
• Modello di permessi diverso: l’agente viene eseguito autonomamente senza che un umano approvi ogni passaggio, o opera su un insieme ristretto di risorse. Il prompt di Claude Code presuppone che un umano sia nel ciclo con accesso a un set di strumenti completo.
• Attività non di codifica: la maggior parte del prompt di Claude Code è guida di codifica. Per agenti di ricerca, contenuto o operazioni, quella guida compete con le istruzioni di cui avete effettivamente bisogno.

​

Personalizzare il comportamento dell’agente

​

File CLAUDE.md per istruzioni a livello di progetto

​

Caricare CLAUDE.md con l’SDK

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

​

Stili di output per configurazioni persistenti

​

Creare uno stile di output

---
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)

​

Attivare uno stile di output

• CLI: eseguite /config e selezionate uno stile di output
• Impostazioni: impostate outputStyle in .claude/settings.local.json
• TypeScript SDK: impostate outputStyle all’interno dell’oggetto settings inline passato a query(), oppure puntate settings a un file di impostazioni che lo imposta. outputStyle non è un campo Options di livello superiore

​

Aggiungere al preset claude_code

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);
  }
}

​

Migliorare il prompt caching tra utenti e macchine

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
    }
  }
})) {
  // ...
}

​

System prompt personalizzati

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);
  }
}

​

Confronto dei quattro approcci

​

Casi d’uso e best practice

​

Quando utilizzare CLAUDE.md

​

Quando utilizzare gli stili di output

• Modifiche di comportamento persistenti tra sessioni
• Configurazioni condivise dal team
• Assistenti specializzati come un revisore del codice, un data scientist o un assistente DevOps
• Modifiche di prompt complesse che necessitano di versionamento

• Creazione di un assistente dedicato per l’ottimizzazione SQL
• Creazione di un revisore del codice incentrato sulla sicurezza
• Sviluppo di un assistente didattico con una pedagogia specifica

​

Quando utilizzare systemPrompt con append

• Aggiunta di standard di codifica o preferenze specifiche
• Personalizzazione della formattazione dell’output
• Aggiunta di conoscenze specifiche del dominio
• Modifica della verbosità della risposta
• Miglioramento del comportamento predefinito di Claude Code senza perdere le istruzioni degli strumenti

​

Quando utilizzare systemPrompt personalizzato

• Controllo completo sul comportamento di Claude
• Attività specializzate a sessione singola
• Test di nuove strategie di prompt
• Situazioni in cui gli strumenti predefiniti non sono necessari
• Creazione di agenti specializzati con comportamento unico

​

Combinazione di approcci

​

Combinare uno stile di output con aggiunte specifiche della sessione

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);
}

​

Vedi anche

• Stili di output: crea, gestisci e condividi stili di output per la CLI, inclusi il formato del file e i percorsi di archiviazione
• Come Claude ricorda il tuo progetto: cosa inserire in CLAUDE.md, dove posizionarlo e come scrivere istruzioni di progetto efficaci
• Riferimento TypeScript SDK: il tipo Options completo, inclusi systemPrompt, settingSources e settings
• Riferimento Python SDK: il tipo ClaudeAgentOptions completo, inclusi system_prompt e setting_sources
• Impostazioni: il riferimento settings.json, incluso dove sono archiviati gli stili di output e altre configurazioni