# Claude Agent SDKの便利で実践的な使い方
📝 プリセット・追記・完全置換の3段階でシステムプロンプトを柔軟にカスタマイズできます。
システムプロンプトの変更は、`systemPrompt` で Claude Code プリセット・追記(append)・カスタム文字列の3段階のカスタマイズを提供する機能です。
📌 タイトル:システムプロンプトの変更
🔗 URL:
🧩 概要
`preset: "claude_code"` で Claude Code 完全版プロンプト、`append` で既存プリセットへの追記、カスタム文字列で完全置換が可能です。出力スタイルファイルで CLI/SDK 横断のペルソナ再利用もできます。
🛠 使い方
`system_prompt` に3つの形式を指定できます。プリセット使用は `{"type": "preset", "preset": "claude_code"}`、追記は `"append": "追加指示"` を加え、完全置換は文字列を直接渡します。`excludeDynamicSections: true` でプロンプトキャッシュのクロスセッション共有が可能です。
🏗 実践的な使い方
・コーディングエージェントには `preset: "claude_code"` で完全版プロンプト(ツールガイダンス・安全ルール)を利用します。
・`append` で「Python には必ず docstring と型ヒントを付ける」等のチーム規約を追記します。何も削らない最もリスクの低いカスタマイズです。
・サポートボット・データ分析アシスタントなど独自ペルソナにはカスタム文字列で完全置換します。
・`excludeDynamicSections: true` でプロンプトキャッシュをユーザー/マシン横断で共有し、フリートのコストを削減します。
💡 ユースケース
🤖 Claude Code 互換のコーディングエージェント
📋 チーム規約の自動適用
🎭 独自ペルソナのカスタムエージェント
⚠️ 注意点
カスタム文字列で完全置換する場合は、ツールガイダンスと安全命令を自前で用意する必要があります。`excludeDynamicSections` は TS v0.2.98+ / Python v0.1.58+ で利用可能です。
#
ClaudeAgentSDK# #
AI#