Skip to content
BENIBIX Learn

--system-prompt-snapshot Flag

Also known as claude --system-prompt-snapshot, --system-prompt-snapshot off

It says if a chat keeps the system prompt it started with.

Think of it like

It is like you keep the first copy of a note. Or you write a new one each time.

Example

Lucy is tuning the text she adds to the prompt. With --system-prompt-snapshot off, each --continue run uses her newest words, not the first ones.

Why it matters

Without it, changing the prompt flags on a resumed chat seems to do nothing.

Definition

--system-prompt-snapshot says if a chat keeps the system prompt it started with. Claude Code builds the prompt on the first request and saves it. Later requests reuse it, even after --resume, until the chat is compacted. Pass off to rebuild it on every request. It needs Claude Code 2.1.257 or later.

Example code

bash
claude --continue --append-system-prompt "New draft rules" --system-prompt-snapshot off
Try new prompt text in an old chat.

Common mistake

Editing the append text and wondering why nothing changed. The saved prompt is still in use. Pass off.

Key takeaways

  1. 1
    Saved on first request. Then reused.
  2. 2
    off. Rebuild every time.
  3. 3
    Until compaction. Then rebuilt.

Learn it properly