# --system-prompt-snapshot Flag

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude --system-prompt-snapshot, --system-prompt-snapshot off

## Think of it like

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

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

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.

## Example code

```bash
claude --continue --append-system-prompt "New draft rules" --system-prompt-snapshot off
```

Try new prompt text in an old chat.

## Why it matters

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

## Common mistake

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

## Three principles

- **Saved on first request.** Then reused.
- **off.** Rebuild every time.
- **Until compaction.** Then rebuilt.

## Related terms

- [--append-system-prompt Flag](https://learn.benibix.com/term/ai/append-system-prompt-flag)
- [--resume Flag](https://learn.benibix.com/term/ai/resume-flag)
- [Auto-Compact](https://learn.benibix.com/term/ai/auto-compact)

## Taught in

- [System Prompt Flags](https://learn.benibix.com/learn/ai-claude-code-commands/system-prompt-flags): Claude Code Commands, 16/17

---

Source: https://learn.benibix.com/term/ai/system-prompt-snapshot-flag
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
