{"name":"--fork-session","slug":"fork-session","family":"cli","title":"CLI flags","noun":"CLI flag","description":"When resuming, create a new session ID instead of reusing the original (use with `--resume` or `--continue`)","description_source":"docs","described_by":{"doc":"claude-code\/cli-reference","title":"CLI reference"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.308","builds":149,"mined_builds":149,"first_cited":{"version":"2.1.232","released_at":"2026-08-13 21:30:53","spans":3}},"aliases":[],"entries":[{"version":"2.1.304","anchor":"await-claim-now-rejected-with-sdk-url","heading":"--await-claim can no longer be combined with --sdk-url","line":"Claude Code now refuses to start when `--await-claim` and `--sdk-url` are used together","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text"},{"version":"2.1.299","anchor":"await-claim-error-message-names-the-subprocess-sandbox","heading":"No visible change to the --await-claim error message","line":"The error shown when `--await-claim` is combined with `--continue`, `--resume` or `--fork-session` is worded the same as before","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text, named in this entry"},{"version":"2.1.290","anchor":"background-job-respawn-can-fork-a-resume","heading":"Restarting a background session can now continue as a copy","line":"A restarted background session can now resume as a fresh copy with `--fork-session`, and a saved reply starting with \/ or ! gets a warning","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text, named in this entry"},{"version":"2.1.285","anchor":"resume-picker-now-offers-to-open-a-live-background-session","heading":"Resuming a running background session now opens it","line":"Picking a still-running background session in `\/resume` now tries to open it, and falls back to a screen explaining why when it cannot","released_at":"2026-09-29 17:32:09","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"new-sdk-pre-warmed-spare-process-await-claim-plus-claim-s","heading":"New SDK pre-warmed spare process: --await-claim plus claim_session control request","line":"A hidden `--await-claim` option lets an SDK host start a spare Claude Code process early and bind it to a session later","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.260","anchor":"worktree-resume-distinguishing-whether-binding-could-actual","heading":"Worktree resume: distinguishing whether binding could actually be cleared","line":"Resume now explains clearly when a worktree binding can't be cleared because transcripts are off.","released_at":"2026-09-03 22:32:02","reason":"found in this entry's text, named in this entry"},{"version":"2.1.232","anchor":"session-id-now-works-with-continue-resume-under-an-sdk-url","heading":"--session-id now works with --continue\/--resume under an SDK URL","line":"--session-id now works with --continue or --resume when an SDK URL is supplied.","released_at":"2026-08-13 21:30:53","reason":"named in this entry, found in this entry's text"}],"entries_total":7,"docs":[{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":true},{"source":"claude-code","path":"agent-view","title":"Manage multiple agents with agent view","documented":false},{"source":"claude-code","path":"checkpointing","title":"Checkpointing","documented":false},{"source":"claude-code","path":"desktop","title":"Desktop application","documented":false},{"source":"claude-code","path":"glossary","title":"Glossary","documented":false},{"source":"claude-code","path":"hooks","title":"Hooks reference","documented":false},{"source":"claude-code","path":"how-claude-code-works","title":"How Claude Code works","documented":false},{"source":"claude-code","path":"sessions","title":"Manage sessions","documented":false},{"source":"claude-code","path":"worktrees","title":"Run parallel sessions with worktrees","documented":false}],"docs_total":9,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/fork-session","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}