{"name":"--append-system-prompt","slug":"append-system-prompt","family":"cli","title":"CLI flags","noun":"CLI flag","description":"Append custom text to the end of the default system prompt","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.309","builds":0,"mined_builds":150,"first_cited":{"version":"2.1.234","released_at":"2026-08-17 18:19:13","spans":3}},"aliases":[],"entries":[{"version":"2.1.284","anchor":"new-claude-code-append-prompt-head-env-var-moves-a-verified","heading":"Cloud sessions can keep a verified start of the appended prompt in the cached part","line":"In cloud sessions, `CLAUDE_CODE_APPEND_PROMPT_HEAD` can move a verified opening of `--append-system-prompt` text into the cacheable system prompt","released_at":"2026-09-28 17:11:59","reason":"found in this entry's text"},{"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.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.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.234","anchor":"early-flag-scan-no-longer-mistakes-tool-lists-and-directorie","heading":"Early flag scan no longer mistakes tool lists and directories for flags","line":"Tool lists and directories passed to flags are no longer misread as flags themselves at startup.","released_at":"2026-08-17 18:19:13","reason":"named in this entry, found in this entry's text"},{"version":"2.1.234","anchor":"spawned-processes-get-flag-value-when-the-value-looks-like-a","heading":"Spawned processes get --flag=value when the value looks like a flag","line":"Prompts and model names starting with a dash are no longer swallowed as options by subagents and background tasks.","released_at":"2026-08-17 18:19:13","reason":"found in this entry's text"},{"version":"2.1.232","anchor":"cloud-gateway-sign-in-explains-its-restart-and-refuses-when-","heading":"Cloud gateway sign-in explains its restart, and refuses when it cannot","line":"Cloud gateway sign-in explains its restart, and ends the session when a restart can't carry state.","released_at":"2026-08-13 21:30:53","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":9,"docs":[{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":true},{"source":"claude-code","path":"context-window","title":"Explore the context window","documented":false},{"source":"claude-code","path":"fullscreen","title":"Fullscreen rendering","documented":false},{"source":"claude-code","path":"github-actions","title":"Claude Code GitHub Actions","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":"memory","title":"How Claude remembers your project","documented":false},{"source":"claude-code","path":"monitoring-usage","title":"Monitoring","documented":false},{"source":"claude-code","path":"output-styles","title":"Output styles","documented":false},{"source":"claude-code","path":"prompt-caching","title":"How Claude Code uses prompt caching","documented":false}],"docs_total":13,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/append-system-prompt","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}