仕様の整理・2026年11月8日に確認
会話の途中に system メッセージを足せるモデル
長い会話の指示を変えたいとき、先頭の system を書き換えるとキャッシュが全部無効になります。途中に足す方式なら、前の部分を保てます。
このサイトはAnthropicの公式サイトではありません。モデルの提供状況・仕様・料金は変わる可能性があるため、実装や契約の前には公式のドキュメントとご自身のアカウント設定を確認してください。
先に結論
2026年5月28日、Opus 4.8 で、ユーザーのターンの後に role: "system" のメッセージを置けるようになりました(ベータヘッダー不要)。7月15日に Fable 5・Mythos 5・Opus 4.8 に広がりました。プロンプトキャッシュのページでは、この方式が system とメッセージのキャッシュを壊さないモデルとして、Fable 5.1・Mythos 5.1・Fable 5・Mythos 5・Opus 5.5・Opus 4.8・Opus 5・Sonnet 5.5・Haiku 5.5 が挙がっています。Sonnet 5 は対象外です。
書き換えと足す方式の違い
| 方法 | キャッシュ |
|---|---|
| 先頭の system を書き換える | system 以降のキャッシュが無効(階層は tools → system → messages) |
会話の途中に role: "system" を足す | system とメッセージのキャッシュは保たれる(対象モデルのみ) |
Opus 5.5 の移行ガイドも、指示の更新のために会話の履歴を作り直しているなら、途中の system メッセージに替えてキャッシュの命中を保つことを勧めています。
関連するベータ機能
- ターン限りの system:
clear_at: "next_user_message"(ヘッダーmid-conversation-system-clear-at-2026-08-21、2026年9月1日)。次のユーザーのメッセージで消える指示 - 途中のツールの追加:
tool_additionブロック(ヘッダーinline-tools-2026-09-15、9月22日)。toolsを書き換えずに足す - メッセージごとの effort:ヘッダー
mid-conversation-output-config-2026-07-01。キャッシュを保ったまま段階を変える
使う前の点検
- 使うモデルが上の対象に入っているかを確かめる。Sonnet 5 は不可
- 足した system の位置が、直前のユーザーのターンの後であること
- 足したあとの
cache_read_input_tokensが落ちていないかを、応答の usage で見る - 思考ブロックを含む会話では、前の部分の書き換えが前置き検査に当たりうる(結び付きの面)
具体例:途中で口調の指示を変える
顧客対応のボットで、最初は丁寧語、会話の途中から「ここからは簡潔に」と指示を変えたいとします。先頭の system を書き換えると、会話の全体のキャッシュが無効になり、長い履歴の読み出しが書き込みに戻って、その呼び出しだけ入力費が高くなります。途中に role: "system" のメッセージを足す方式なら、前の部分のキャッシュは保たれます。その指示を次の1ターンだけに効かせたいなら、ベータの clear_at: "next_user_message" が使えます。対象でないモデル(Sonnet 5)では、足す方式が使えないので、書き換えの費用を見込んでください。
この面で確かめていないこと
- Bedrock・Google Cloud での対応(リリースノートは Fable 5 などについて Claude API・Bedrock・Google Cloud と書くが、全モデルは確認していない)
- ベータ機能の安定性
よくある質問
先頭の system を直すのは悪いことですか?
悪くはありませんが、キャッシュが無効になり、次の呼び出しは書き込みの割増になります。
Sonnet 5 では代わりに何を?
足す方式が使えないので、先頭の system を書き換えるか、Sonnet 5.5 に移します。
足した system は永続しますか?
通常は会話に残ります。次のユーザーのメッセージで消す指定は、ベータの clear_at です。
出典(2026年11月8日に確認)
- プロンプトキャッシュ(Anthropic の API ドキュメント) https://platform.claude.com/docs/en/build-with-claude/prompt-caching
- Claude Platform のリリースノート(Anthropic) https://platform.claude.com/docs/en/release-notes/overview
- Opus 5.5 の移行ガイド(Anthropic の API ドキュメント) https://platform.claude.com/docs/en/models/opus-5-5/migration-guide
編集:ちんあなご編集部。記事の文は写さず、日付・数字・名前などの事実だけを自分の文で書いています。