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

--sdk-url

cli never mined 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.

Startup stats now note the input format, whether --sdk-url was passed, and an experiment flag.

Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.232.

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.204 first named in a changelog, 8 Jul 2026

In the changelogs

19

Releases whose published page names --sdk-url.

  1. v2.1.304
    --await-claim can no longer be combined with --sdk-url

    Claude Code now refuses to start when --await-claim and --sdk-url are used together

    found in this entry's text

  2. v2.1.290
    Remote sessions can read the SDK address from CLAUDE_CODE_REMOTE_SDK_URL

    When --sdk-url is not given in a remote session, Claude Code now reads the address from the CLAUDE_CODE_REMOTE_SDK_URL environment variable

    found in this entry's text

  3. v2.1.281
    Early remote connect for resumed SDK/CCR sessions, behind a new env var

    Setting CLAUDE_CODE_CCR_EARLY_REMOTE_CONNECT makes a resumed --sdk-url session open its remote connection early, before the rest of startup finishes

    found in this entry's text

  4. v2.1.281
    SDK MCP servers: bounded wait at first message, and servers started later are awaited

    With --sdk-url, waiting for SDK MCP servers is now time-limited, and servers started later are waited for

    found in this entry's text

  5. v2.1.277
    New wall-clock latency telemetry fields for turn timing over --sdk-url

    New wall-clock latency telemetry fields break down turn timing when using --sdk-url

    found in this entry's text

  6. v2.1.271
    New --sdk-url resolution path via RXn() bypassing argv parsing

    The --sdk-url value can now be supplied through a new internal path that bypasses normal argument parsing

    found in this entry's text

  7. v2.1.261
    New SDK launch flag: --await-initialize

    A new SDK CLI flag makes the process wait for an initialize request over stdin before starting.

    found in this entry's text

  8. v2.1.259
    Early hydrate prefetch for SDK/remote-control resume sessions

    Starting with --sdk-url and --resume now warms session and history state in parallel with the rest of startup.

    found in this entry's text

  9. v2.1.257
    Clearer error message for org policy blocking Remote Control via --sdk-url

    The rejection message when org settings block Remote Control via --sdk-url is now clearer.

    found in this entry's text

  10. v2.1.248
    Bridge-mode redaction now also requires a transport that persists output

    Bridge-mode redaction now only kicks in when your transport actually persists sent output.

    found in this entry's text

  11. v2.1.248
    Remote startup waits for its credentials file instead of failing fast

    Remote sessions now wait and retry for their credentials file instead of failing immediately.

    found in this entry's text

  12. v2.1.246
    Plan mode can be restored by reading the transcript

    Resuming a session can now re-enter plan mode by reading your transcript, and this is on by default.

    found in this entry's text

  13. v2.1.239
    One shared test for whether a run is headless

    One shared check now decides whether a run is non-interactive, covering print mode and piped output.

    found in this entry's text

  14. v2.1.233
    New hidden flag --watch-artifact

    A hidden flag lets a session watch an artifact for new versions and comments, with an option to disarm auto-reply.

    found in this entry's text

  15. v2.1.233
    Gateway can forward user identity headers, plus a new ccr-gateway host mode

    Gateway upstreams can pass your sanitised identity headers along, and a new ccr-gateway host mode takes its origin from --sdk-url.

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

  16. v2.1.232
    More detail in startup analytics

    Startup stats now note the input format, whether --sdk-url was passed, and an experiment flag.

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

  17. v2.1.232
    Bridge worker processes are launched with a resume argument

    Remote bridge worker processes now start with a resume argument derived from the session URL.

    found in this entry's text

  18. v2.1.210
  19. v2.1.204

    found in this entry's text

First cited

1

The earliest release whose published evidence quoted --sdk-url was v2.1.304, 19 Oct 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.

ReleaseDateThe span that was quoted
v2.1.30419 Oct 2026Error: --await-claim cannot be used with --sdk-url.

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