{"name":"--system-prompt","slug":"system-prompt","family":"cli","title":"CLI flags","noun":"CLI flag","description":"Replace the entire system prompt with custom text","description_source":"docs","described_by":{"doc":"claude-code\/cli-reference","title":"CLI reference"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.308","builds":0,"mined_builds":149,"first_cited":{"version":"2.1.248","released_at":"2026-08-27 20:35:36","spans":1}},"aliases":[],"entries":[{"version":"2.1.283","anchor":"system-prompt-and-system-prompt-file-can-now-be-given-to","heading":"--system-prompt and --system-prompt-file can now be used together","line":"Passing both `--system-prompt` and `--system-prompt-file` no longer stops Claude Code from starting; the two are combined","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"system-prompt-snapshot-now-defaults-on-universally-not-ju","heading":"--system-prompt-snapshot now defaults on universally, not just for the built-in prompt","line":"--system-prompt-snapshot's documented default is now described as always-on, not just for the built-in prompt","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"cli-option-class-renamed-q-y-and-error-class-renamed-h","heading":"CLI option class renamed (q -> Y) and error class renamed (Ht -> It); no behavior change","line":"Internal CLI option and error classes were renamed with no change in behavior","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"},{"version":"2.1.257","anchor":"new-system-prompt-snapshot-cliagent-option","heading":"New --system-prompt-snapshot CLI\/agent option","line":"A new --system-prompt-snapshot option makes a session record its system prompt once and reuse it on resume.","released_at":"2026-09-01 17:15:33","reason":"found in this entry's text"},{"version":"2.1.248","anchor":"switching-model-over-the-sdk-can-also-swap-the-system-prompt","heading":"Switching model over the SDK can also swap the system prompt","line":"Over the SDK, set_model can also swap your custom system prompt from the next turn.","released_at":"2026-08-27 20:35:36","reason":"named in this entry, found in this entry's text"},{"version":"2.1.242","anchor":"command-line-system-prompts-kept-separate-from-resolved-ones","heading":"Command-line system prompts kept separate from resolved ones","line":"Your typed --system-prompt values are kept apart from the resolved ones for cloud and remote setup.","released_at":"2026-08-24 19:16:14","reason":"named in this entry, found in this entry's text"},{"version":"2.1.98","anchor":"exclude-dynamic-system-prompt-sections-cli-flag","heading":"--exclude-dynamic-system-prompt-sections CLI Flag","line":null,"released_at":"2026-04-09 18:08:49","reason":"found in this entry's text"},{"version":"0.2.117","anchor":"enhanced-print-mode-print","heading":"Enhanced Print Mode ( --print ) \ud83d\udcc4","line":null,"released_at":"2025-05-17 23:51:27","reason":"found in this entry's text"}],"entries_total":8,"docs":[{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":true},{"source":"claude-code","path":"agent-sdk\/modifying-system-prompts","title":"Modifying system prompts","documented":false},{"source":"claude-code","path":"agent-sdk\/python","title":"Agent SDK reference - Python","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"fullscreen","title":"Fullscreen rendering","documented":false},{"source":"claude-code","path":"glossary","title":"Glossary","documented":false},{"source":"claude-code","path":"headless","title":"Run Claude Code programmatically","documented":false},{"source":"claude-code","path":"monitoring-usage","title":"Monitoring","documented":false},{"source":"claude-code","path":"self-hosted-environments-configuration","title":"Customize sessions in self-hosted environments","documented":false},{"source":"claude-code","path":"sessions","title":"Manage sessions","documented":false}],"docs_total":12,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/system-prompt","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}