{"name":"--sdk-url","slug":"sdk-url","family":"cli","title":"CLI flags","noun":"CLI flag","description":"Startup stats now note the input format, whether --sdk-url was passed, and an experiment flag.","description_source":"entry","described_by":{"version":"2.1.232","anchor":"more-detail-in-startup-analytics"},"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.304","released_at":"2026-10-19 19:47:15","spans":1}},"aliases":[],"entries":[{"version":"2.1.309","anchor":"stream-json-result-carries-per-call-usage-delta-field","heading":"Results in stream-json and --sdk-url runs now report usage since the last result","line":"Result messages in stream-json and --sdk-url runs now include usage and cost per model since the previous result","released_at":"2026-10-22 20:34:13","reason":"found in this entry's text"},{"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.290","anchor":"claude-code-remote-sdk-url-fallback-for-the-sdk-url-host","heading":"Remote sessions can read the SDK address from CLAUDE_CODE_REMOTE_SDK_URL","line":"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","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"early-remote-connect-for-resumed-sdkccr-sessions-behind-a","heading":"Early remote connect for resumed SDK\/CCR sessions, behind a new env var","line":"Setting CLAUDE_CODE_CCR_EARLY_REMOTE_CONNECT makes a resumed --sdk-url session open its remote connection early, before the rest of startup finishes","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"sdk-mcp-servers-bounded-wait-at-first-message-and-servers","heading":"SDK MCP servers: bounded wait at first message, and servers started later are awaited","line":"With --sdk-url, waiting for SDK MCP servers is now time-limited, and servers started later are waited for","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.277","anchor":"new-wall-clock-latency-telemetry-fields-for-turn-timing-over","heading":"New wall-clock latency telemetry fields for turn timing over --sdk-url","line":"New wall-clock latency telemetry fields break down turn timing when using --sdk-url","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text"},{"version":"2.1.271","anchor":"new-sdk-url-resolution-path-via-rxn-bypassing-argv-p","heading":"New --sdk-url resolution path via RXn() bypassing argv parsing","line":"The --sdk-url value can now be supplied through a new internal path that bypasses normal argument parsing","released_at":"2026-09-14 19:45:19","reason":"found in this entry's text"},{"version":"2.1.261","anchor":"new-sdk-launch-flag-await-initialize","heading":"New SDK launch flag: --await-initialize","line":"A new SDK CLI flag makes the process wait for an initialize request over stdin before starting.","released_at":"2026-09-04 17:49:34","reason":"found in this entry's text"},{"version":"2.1.259","anchor":"early-hydrate-prefetch-for-sdkremote-control-resume-session","heading":"Early hydrate prefetch for SDK\/remote-control resume sessions","line":"Starting with --sdk-url and --resume now warms session and history state in parallel with the rest of startup.","released_at":"2026-09-02 21:21:42","reason":"found in this entry's text"},{"version":"2.1.257","anchor":"clearer-error-message-for-org-policy-blocking-remote-control","heading":"Clearer error message for org policy blocking Remote Control via --sdk-url","line":"The rejection message when org settings block Remote Control via --sdk-url is now clearer.","released_at":"2026-09-01 17:15:33","reason":"found in this entry's text"}],"entries_total":20,"docs":[],"docs_total":0,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/sdk-url","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}