システムプロンプト

中級

What you'll learn

4 つすべての実行面でシステムプロンプトを正しく設定する — Anthropic の system パラメータ、OpenAI の developer ロール、Gemini の system_instruction、そして Claude Code の 5 つのフラグ
常設ブリーフに入れるべきものと、そこに残してはいけないものを見分ける
押しすぎをやめる — なぜ「CRITICAL: you MUST」が現行モデルでは逆効果になるのか
プロンプトキャッシュが再利用できる位置にシステムプロンプトを置き、変動する部分を切り出す
Claude Code のデフォルトプロンプトに追記するか置き換えるかを選ぶ — そして置き換えると何が失われるのかを理解する

どのモデルにも、会話全体の枠組みを決める層がひとつある。これは手持ちの中でいちばん安いレバーであり — 一度設定すれば全ターンに効く — そして最も多くの人が間違った材料を詰め込む場所でもある。ロールではなぜそれが重要なのかを扱った。このレッスンはオペレーター向けの版だ。正確なパラメータ名、どこまで強く押すか、そしてキャッシュとどう相互作用するか。

ひとつの概念、4 つの実行面

概念はどこでも通用する。配管はそうではない。

実行面	設定方法	形
Anthropic Messages API	`system` — トップレベルのリクエストパラメータであり、`messages` の要素ではない	文字列、またはコンテンツブロックの配列
OpenAI Responses API	`instructions` パラメータ、または `developer` ロールのメッセージ	現在のリクエストに適用される。`previous_response_id` で連鎖させると `instructions` は引き継がれない
Google Gemini API	リクエスト上の `system_instruction`（Java では `systemInstruction`、Go では `SystemInstruction`）	やり取りごとに設定
Claude Code	5 つの CLI フラグ（下記）、加えて `CLAUDE.md` と出力スタイル	置き換えまたは追記
チャットアプリ	アカウント上のカスタム指示	チャットをまたいで永続

最もよくある移植バグは、Anthropic の system をメッセージとして扱うことだ。これはメッセージではない。messages の中ではなく、その隣に置かれる。逆方向では、OpenAI の階層は明示的だ — developer の指示はユーザーの指示に優先し、ユーザーの指示はアシスタント自身の過去のターンに優先する。 彼ら自身のたとえでは、developer メッセージは関数定義であり、user メッセージはそこに渡す引数である。

Anthropic: system はトップレベルのパラメータ

curl https://api.anthropic.com/v1/messages \
-H "content-type: application/json" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-d '{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "system": "You are a precise financial analyst. Show your assumptions. Never invent numbers.",
  "messages": [{"role": "user", "content": "Summarize this filing."}]
}'

そこに入れるべきもの

プロンプトの各行をどれくらいの頻度で変わるかで並べ替える。会話全体を通して真であるものは常設ブリーフへ上げる。ターンごとに変わるものはユーザーターンに残す。

Guided walkthrough1 of 6

役割は一文あれば口調と焦点を動かすのに十分だ。Anthropic のドキュメントは、たった一文でも違いが出ると明言している。同時に、役割を過剰に制約しないよう警告している。現行モデルは重いペルソナの足場を必要としないからだ。

どこまで強く押すか

ここは、古いモデル向けに書かれたプロンプトが積極的に害になる領域だ。Opus 4.5/4.6 世代以降に対する Anthropic のガイダンスは率直で、これらのモデルは先行世代よりシステムプロンプトに敏感に反応するとされている。だからツールを過少に呼んでいたモデルに対して固めたプロンプトは、今では過剰に呼ばせてしまう。対処は音量を下げること — CRITICAL: you MUST use this tool when… ではなく Use this tool when… と書く。

Watch out

全部大文字、「CRITICAL」、「you MUST」、脅しの枠組みは、ソフトな指示を無視していたモデルの遺産だ。現行モデルでは過剰発火と前のめりなツール呼び出しを引き起こす。
過剰に制約されたペルソナ（「あなたは決してミスをしない世界最高の 10x エキスパートだ」）はトークンを増やすだけで何も買えない。代わりに、実際に欲しい観点を求めること。
矛盾した層は、薄いブリーフより悪い。システムプロンプトが「簡潔に」と言い、スキルが「常に推論を説明せよ」と言えば、モデルは推測するしかない。
あらゆるテクニックを一度に積み上げること — 役割、XML、few-shot、思考の連鎖、出力スキーマ — は最もよくある過剰設計の形だ。ひとつ足して測り、効いたときだけ残す。

積極性は固定された性質ではなくダイヤルであり、それを設定する場所がシステムプロンプトだ。後から見つけて編集できるように、ポリシーを名前付きタグで包んでおく。

行動する方向に押す

<default_to_action>
Implement changes rather than only proposing them. If intent is ambiguous, infer the
most useful action and proceed, using tools to find the details you are missing instead
of guessing.
</default_to_action>

まず尋ねる方向に押す

<do_not_act_before_instructions>
Do not modify files or start an implementation unless you are clearly asked to. When
intent is ambiguous, research and recommend instead of acting. Make changes only on an
explicit request.
</do_not_act_before_instructions>

システムプロンプトはあなたのキャッシュ接頭辞

これは請求書に現れる部分だ。Anthropic はキャッシュ可能な接頭辞を固定の順序で組み立てる — tools、次に system、次に messages — そしてキャッシュはマークしたブロックまでを含めて覆う。つまりシステムプロンプトは、リクエスト全体の中で最も価値の高いキャッシュ位置に座っている。安定していて、呼び出しごとに再利用され、会話の前に置かれている。

帰結は 2 つ。

システムプロンプトをバイト単位で安定させること。 タイムスタンプ、ユーザー名、セッション ID を差し込むと接頭辞が変わり、リクエストごとに必ずキャッシュを外す。
一部が必ず変わるなら、安定した部分を先に置き、その後でキャッシュを区切る。そうすれば変動する末尾だけが読み直される。

キャッシュ可能な最小長はモデルごとに異なり — 現行モデルの一部は 512 トークンからキャッシュし、古いものは最大 4,096 必要 — しきい値を下回るプロンプトはエラーも出さず黙ってキャッシュなしで処理される。頼る前に現在の表を確認すること。

Claude Code はその分割の専用版を備えている。置き換え用のプロンプトが固定の指示と実行ごとのコンテキストを混ぜているなら、その間に __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ だけを含む行を置く。Claude Code は最初のそうした行で分割してその行を落とし、上側をキャッシュしたまま下側だけが変わるようにする（v2.1.275 以降）。スクリプト化されたマルチユーザー実行では、--exclude-dynamic-system-prompt-sections がユーザーごとのコンテキストをプロンプトから最初のユーザーメッセージへ移し、複数のマシンがひとつのキャッシュ済み接頭辞を共有できるようにする。

Claude Code: 追記か置き換えか

プロンプトを設定するフラグは 5 つ。うち 4 つはテキストを設定し、5 つ目は会話が開始時のテキストを保持し続けるかを制御する。

フラグ	何をするか
`--system-prompt`	デフォルトプロンプト全体をあなたのテキストで置き換える
`--system-prompt-file`	ファイルの内容で置き換える
`--append-system-prompt`	あなたのテキストをデフォルトプロンプトに追記する
`--append-system-prompt-file`	ファイルの内容をデフォルトプロンプトに追記する
`--system-prompt-snapshot`	`off` にすると、最初のリクエストで記録したものを再利用せず、リクエストごとにプロンプトを再構築する

--system-prompt と --system-prompt-file は排他だが、どちらの追記フラグもどちらの置き換えフラグとも組み合わせられる。

判断基準はあなたが何を引き受ける気があるかだ。

Guided walkthrough1 of 3

追記はデフォルトのツールガイダンス、安全性の指示、コーディング規約を保つので、違う部分だけを供給すればよい — 呼び出しごとのルール、出力形式、-p スクリプト用のドメインコンテキスト。

ヘッドレス実行 1 回にルールを追記する

claude -p --append-system-prompt "Cite file:line for every claim." "audit the auth flow"

実際のデバッグ時間を食うひっかかりがひとつ。デフォルトでは Claude Code はシステムプロンプトを会話の最初のリクエストで一度だけ組み立て、それを記録する。同じ会話の以降のリクエストは記録されたプロンプトを再利用する — --resume や --continue の後も含めて。後の起動でフラグのテキストを変えても、会話がコンパクトされるか新しい会話を始めるまで何も起きない。文面を反復している間は --system-prompt-snapshot off（v2.1.257 以降）を渡して、毎リクエスト再構築させること。

実際のビフォー/アフター

ビフォー — すべてが最大音量、変動する事実が焼き込まれ、出力の契約がない。

押しすぎでキャッシュに敵対的

You are THE BEST code reviewer in the world. You are a 10x engineer.
CRITICAL: You MUST ALWAYS use the search tool before answering. NEVER skip this.
IT IS EXTREMELY IMPORTANT that you are thorough.
The current date is 2026-09-30 and the user is reviewing PR #4412 on branch fix/auth-race.

問題は 4 つ別々にある。最上級表現は何も買えていない。大声はモデルにツールを過剰に呼ばせる。妥当な回答の定義がない。そして最後の行は実行ごとに変わるので接頭辞が決してキャッシュされない。

アフター — 役割は一文、本物の出力契約、不確実性の逃げ道、変動する事実はユーザーターンへ移動。

落ち着いて、契約優先、キャッシュ可能

You are a code reviewer for a TypeScript monorepo.

Rules:
- Search the codebase before claiming a symbol is unused.
- If you cannot verify a claim from the diff or the code, say so instead of guessing.

Output: a Summary section, then Risks, then Suggested changes. No preamble.

日付、PR 番号、ブランチは本来の居場所であるユーザーターンに入る。振る舞いは同じ、キャッシュ接頭辞は安定し、トークンは約 3 分の 1 になる。

もう手を伸ばすべきでないもの

プリフィル — アシスタントのターンを自分で書き始めて、モデルにあなたの形式で続けさせる手法 — はかつて JSON を強制したり前置きを飛ばしたりする定番だった。Claude 4.6 以降では、最終アシスタントターンをプリフィルすると 400 エラーが返る。 代替はすべてシステムプロンプトの中か隣にある。「前置きなしで答えること」という直接的な指示、構造化出力、または分類用の enum フィールドを持つツールだ。会話の他の位置にあるアシスタントメッセージは影響を受けないので、few-shot の例は以前とまったく同じに機能する。

システムプロンプト早見表

Enter キーまたはスペースキーでカードを裏返します。左右の矢印キーでカードを移動できます。用語を表示しました。

1 / 8

Key takeaways

概念は同じ、配管は違う: Anthropic の `system` パラメータ、OpenAI の `developer` ロール / `instructions`、Gemini の `system_instruction`、Claude Code の 5 つのフラグ。
変化の速さで並べ替える — 長持ちするルールは常設ブリーフへ、変動する事実はユーザーターンへ。
音量を下げる。現行モデルは、過少発火していたモデル向けに固めたプロンプトに対して過剰発火する。
システムプロンプトはキャッシュ接頭辞（tools → system → messages）に座る: バイト単位で安定させ、変動する末尾を切り離すこと。
Claude Code では、追記はデフォルトの安全性とツールのガイダンスを保ち、置き換えは責任のすべてをあなたに渡す。
最終アシスタントターンのプリフィルは Claude 4.6 以降で 400 — 出力契約、構造化出力、またはツールを使うこと。

理解度チェック

0/4

Anthropic Messages API では、システムプロンプトはどこに置かれるか？
プロンプトに「CRITICAL: You MUST ALWAYS call the search tool.」と書いた。現行の Claude モデルで起きやすい効果は？
現在のタイムスタンプをシステムプロンプトに差し込むと、なぜコストがかかるのか？
Claude Code で `--append-system-prompt` ではなく `--system-prompt` を渡した。何を手放したことになるか？

このページを共有

ひとつの概念、4 つの実行面​