{"version":"2.1.283","anchor":"new-client-data-url-flag-claude-code-client-data-url-loa","canonical_anchor":"new-client-data-url-flag-claude-code-client-data-url-loa","heading":"New --client-data-url flag loads a signed configuration for your model","tier":"use","area":"Configuration","url":"https:\/\/changelogs.core-directive.com\/v\/2.1.283\/e\/new-client-data-url-flag-claude-code-client-data-url-loa","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.283","markdown":"### New `--client-data-url` flag loads a signed configuration for your model\n\n`--client-data-url` or `CLAUDE_CODE_CLIENT_DATA_URL` loads a signed per-model configuration from Anthropic, and Claude Code will not start if it fails\n\n**Unclear.** Which behaviours the configuration can change is not stated.\n\n**What**\n\nThere is a new command-line flag, `--client-data-url <url>`, and a matching environment variable, `CLAUDE_CODE_CLIENT_DATA_URL`. Setting the variable instead of the flag keeps the URL out of the process list. The URL points to a signed configuration document on downloads.claude.ai. At startup Claude Code downloads the document, checks its signature, and applies the part that matches the model the session uses.\n\nClaude Code will not start when:\n\n- the document cannot be loaded\n\n- the document is older than one already accepted on this machine\n\n- the document covers no models, or not the model the session runs\n\nThe URL must be the https downloads.claude.ai address exactly as given, with no query, fragment, port or credentials. The download is refused in remote, cloud or ssh sessions, with third-party providers such as Bedrock, Vertex or Foundry, and when the `allow_model_catalog` policy is denied, as it is under HIPAA. To start without the configuration, remove the flag or the environment variable.\n\n**Why**\n\nThis gives Anthropic a way to hand you a signed configuration that changes how Claude Code behaves for a particular model. It does nothing unless you are given a URL. A bad or unsuitable one stops Claude Code from starting.\n\n- Area: Configuration\n- Names: `--client-data-url`, `CLAUDE_CODE_CLIENT_DATA_URL`\n- Tier: Use it now\n- Useful: 5\/5\n- Signal: 5\/5"}