CLAUDE_CODE_REMOTE_SDK_URL

Updated October 14, 2026 by Alex Sorokoletov

CLAUDE_CODE_REMOTE_SDK_URL is a Claude Code environment variable. Added in v2.1.290 and still present in v2.1.295. It is not in the official reference.

Status	Present in v2.1.295
Added	Added in v2.1.290
Category	Network and proxy
Official docs	Not listed

How to set it

For one session, export it in the shell that starts Claude Code:

export CLAUDE_CODE_REMOTE_SDK_URL=<value>
claude

To apply it to every session, add it to the env object of a settings file:

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_REMOTE_SDK_URL": "<value>"
  }
}

Related variables

CLAUDE_REMOTE_TOOLS_BRIDGE_URL
ANTHROPIC_BASE_URL: Custom endpoint for Anthropic services.
CLAUDE_CODE_API_BASE_URL: Custom Claude Code API base URL for proxies.
CLAUDE_CODE_GB_BASE_URL: An internal base URL override, possibly for a "gradebook" or grading service used during internal testing.
CLAUDE_CODE_MCP_SERVER_URL: The companion to MCP_SERVER_NAME, providing the server endpoint URL.
CLAUDE_CODE_PROXY_URL: Full proxy URL, injected into the helper subprocess's environment.
DATABASE_URL
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE: Remote MCP connection batch size.

Frequently asked questions

Which Claude Code version has CLAUDE_CODE_REMOTE_SDK_URL?

Added in v2.1.290 and still present in v2.1.295.

How do I set CLAUDE_CODE_REMOTE_SDK_URL?

Export it before starting Claude Code (export CLAUDE_CODE_REMOTE_SDK_URL=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.

All variables, searchable: Claude Code environment variables.