システムプロンプトの変更

• システムプロンプトの仕組み。プリセット、プリセットと append の組み合わせ、カスタムプロンプトの間で選択するための決定テーブル付き
• エージェントの動作をカスタマイズする方法。CLAUDE.md ファイル、出力スタイル、append、またはカスタム文字列を使用
• 4 つのアプローチを比較する方法。永続性、スコープ、および保持される内容による比較
• アプローチを組み合わせてカスタマイズ方法を重ねる方法

​

システムプロンプトの仕組み

• 最小限のデフォルト：TypeScript で systemPrompt を設定しない、または Python で system_prompt を設定しない場合、SDK はツール呼び出しをカバーする最小限のプロンプトを使用しますが、Claude Code のコーディングガイドライン、応答スタイル、プロジェクトコンテキストは省略されています。これは、デフォルトで完全な Claude Code プロンプトを使用する claude -p とは異なります。CLI から移行していて、一致する動作を望む場合は、claude_code プリセットを設定してください。
• claude_code プリセット：Claude Code CLI が使用する完全なシステムプロンプト。ツール使用命令、コードスタイルとフォーマットガイドライン、応答トーンと詳細度ルール、セキュリティと安全性の命令、および作業ディレクトリと環境に関するコンテキストが含まれています。TypeScript で systemPrompt: { type: "preset", preset: "claude_code" } を設定するか、Python で system_prompt={"type": "preset", "preset": "claude_code"} を設定してください。オプションで append を使用して、最後に独自の命令を追加できます。
• カスタム文字列：自分で作成したプロンプト。SDK は提供したものだけを送信します。

​

開始点を決定する

• 異なるサーフェス：出力は、それをトリガーした人によってターミナルで読まれません。チャット UI、構造化出力コンシューマー、およびコーディング以外の自動化は、それぞれ、出力がどのようにレンダリングおよびレビューされるかに一致するプロンプトが必要です。CI ジョブがリントエラーを修正したり、diff をレビューしたりするような無人コーディング自動化は、作業自体がプリセットが書かれているものであるため、プリセットに適合します。
• 異なるアイデンティティ：エージェントは Claude Code として自分自身を提示すべきではありません。サポートボット、データ分析アシスタント、またはドメイン固有のエージェントは、独自の名前、スコープ、およびペルソナが必要です。
• 異なるアクセス許可モデル：エージェントは人間が各ステップを承認することなく自律的に実行されるか、リソースの限定されたセットで動作します。Claude Code のプロンプトは、人間がループ内にいて、完全なツールセットにアクセスできることを前提としています。
• コーディング以外のタスク：Claude Code のプロンプトのほとんどはコーディングガイダンスです。研究、コンテンツ、または運用エージェントの場合、そのガイダンスは実際に必要な命令と競合します。

​

エージェントの動作をカスタマイズする

​

プロジェクトレベルの命令用の CLAUDE.md ファイル

​

SDK で CLAUDE.md を読み込む

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

​

永続的な設定のための出力スタイル

​

出力スタイルを作成する

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

​

出力スタイルをアクティブ化する

• CLI：/config を実行し、出力スタイルを選択
• 設定：.claude/settings.local.json で outputStyle を設定
• TypeScript SDK：query() に渡されるインラインの settings オブジェクト内で outputStyle を設定するか、settings を outputStyle を設定する設定ファイルに指定します。outputStyle はトップレベルの Options フィールドではありません

​

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

​

ユーザーとマシン全体でプロンプトキャッシングを改善する

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

​

カスタムシステムプロンプト

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

​

4 つのアプローチすべての比較

​

ユースケースとベストプラクティス

​

CLAUDE.md を使用する場合

​

出力スタイルを使用する場合

• セッション全体での永続的な動作変更
• チーム共有設定
• コードレビュアー、データサイエンティスト、DevOps アシスタントなどの特殊なアシスタント
• バージョン管理が必要な複雑なプロンプト変更

• 専用 SQL 最適化アシスタントの作成
• セキュリティ重視のコードレビュアーの構築
• 特定の教育学を持つティーチングアシスタントの開発

​

systemPrompt を追加で使用する場合

• 特定のコーディング標準または設定の追加
• 出力フォーマットのカスタマイズ
• ドメイン固有の知識の追加
• 応答詳細度の変更
• ツール命令を失わずに Claude Code のデフォルト動作を強化する

​

カスタム systemPrompt を使用する場合

• Claude の動作を完全に制御
• 特殊なシングルセッションタスク
• 新しいプロンプト戦略のテスト
• デフォルトツールが不要な状況
• ユニークな動作を持つ特殊なエージェントの構築

​

アプローチの組み合わせ

​

出力スタイルとセッション固有の追加を組み合わせる

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

​

関連項目

• 出力スタイル：CLI の出力スタイルを作成、管理、共有します。ファイル形式とストレージの場所を含みます
• Claude がプロジェクトを記憶する方法：CLAUDE.md に何を入れるか、どこに配置するか、効果的なプロジェクト指示の書き方
• TypeScript SDK リファレンス：systemPrompt、settingSources、settings を含む完全な Options 型
• Python SDK リファレンス：system_prompt と setting_sources を含む完全な ClaudeAgentOptions 型
• 設定：出力スタイルおよび他の設定が保存される場所を含む settings.json リファレンス