Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial
Home / Reference / CLI flags

--ref

cli never mined documented JSON

A Claude Code CLI flag, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.

With --environment, base the new session's checkout on a named ref instead of local HEAD

Anthropic's own wording. Read off CLI reference, captured 2026-09-26.

First seen — never in a mined build
Last seen — never in a mined build
Builds0 / 149on this box, as of v2.1.308
Written about v2.1.224 first named in a changelog, 7 Aug 2026

In the changelogs

7

Releases whose published page names --ref.

  1. v2.1.304
    Task launches can take their starting branch from --on-branch or --ref

    A launch path now uses the branch from --on-branch first, then the ref from --ref, and records which flag supplied it

    found in this entry's text

  2. v2.1.301
    Cloud session launch records which ref you chose and how

    Creating a cloud session now notes the ref you named and whether it came from --on-branch or --ref, plus a new file sync state

    found in this entry's text

  3. v2.1.290
    Clearer errors when creating a cloud session goes wrong

    If the server returns a session id Claude Code cannot use, it now warns a session may exist and points you to claude.ai/code

    found in this entry's text

  4. v2.1.248
    Cloud and pool flags no longer confuse prompt detection

    Cloud flags like --pool and --ref no longer swallow their values as your prompt.

    named in this entry, found in this entry's text

  5. v2.1.238
    claude --cloud explains when your local changes cannot be uploaded

    claude --cloud now says why your local changes could not be uploaded and points you at --ref.

    named in this entry, found in this entry's text

  6. v2.1.232
    --project no longer starts a cloud session

    Passing --project alone won't start a cloud session; --ref and --on-branch now need --cloud or --environment.

    named in this entry, found in this entry's text

  7. v2.1.224
    Start a cloud session on a self-hosted environment with --environment

    Start a cloud session on your own environment with claude --environment, plus hidden --ref and --on-branch companions.

    named in this entry, found in this entry's text

First cited

0

No release's published evidence quotes this name. The ledger indexes the Evidence lines of every changelog on this site, so this says nobody here has ever quoted it; it says nothing about how old the name is.

Presence across releases

0

The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.

Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the CLI flag does. All CLI flags.

Feedback