9 pages for --fork-session.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
Manage multiple agents with agent view
Claude Code CLI · in the page
agent-view
…with a name or file path, Claude Code always starts such a copy. Add `--fork-session` to start a copy on purpose, without the note. Pass `--name` to set the session's display name in agent view inste…
Checkpointing
Claude Code CLI · in the page
checkpointing
…[`/branch`](/docs/en/sessions#branch-a-session) or `claude --continue --fork-session` instead. ## Common use cases Checkpoints are particularly useful when: * **Exploring alternatives**: try differ…
CLI reference
Claude Code CLI · in the page
cli-reference
…ku` | | `--fork-session` | When resuming, create a new session ID instead of reusing the original (use with…
Desktop application
Claude Code CLI · in the page
desktop
…ocesses then write to the same conversation. If you aren't sure, add `--fork-session`, which continues in a copy of the conversation, but both processes still work on the same files. #### Choose wher…
Glossary
Claude Code CLI · in the page
glossary
…ntext-window). Sessions can be resumed with `claude -c`, forked with `--fork-session` to preserve history under a new session ID, or run in parallel across terminals. Running `/clear` starts a new ses…
Hooks reference
Claude Code CLI · in the page
hooks
…on resume with `source` set to `"resume"`, or `"fork"` if you added `--fork-session`, so they can refresh their context. #### Decision control Not every event supports blocking or controlling behav…
How Claude Code works
Claude Code CLI · in the page
how-claude-code-works
…and appends new messages to the existing conversation. Forking with `--fork-session` or `/branch` copies the history into a new session ID, leaving the original unchanged. ![Diagram of session conti…
Manage sessions
Claude Code CLI · in the page
sessions
…ou to find it in `claude agents` when it can't determine the ID. Add `--fork-session` to resume a copy of the conversation instead. To continue the conversation itself in a session of your own, with y…
Run parallel sessions with worktrees
Claude Code CLI · in the page
worktrees
…worktree add` declines, so launch those from the main checkout. * **`--fork-session`**: the forked session starts in the directory you launched Claude from, and Claude Code leaves the original sessio…