CLAUDE_CODE_PROXY_URL

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_CODE_PROXY_URL is a Claude Code environment variable: Full proxy URL, injected into the helper subprocess's environment. Claude-namespaced because the helper protocol is Claude-specific and must not collide with standard HTTPS_PROXY. Added between v2.1.108 and v2.1.114 and still present in v2.1.294. It is not in the official reference.

How to set it

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

export CLAUDE_CODE_PROXY_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_PROXY_URL": "<value>"
  }
}

Release notes that mention it

• Claude Code v2.1.114 — Native Binary Launcher, /fewer-permission-prompts, and 20 New Environment Variables

Related variables

• 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_HOST_HTTP_PROXY_PORT: HTTP proxy port for host.
• CLAUDE_CODE_HOST_SOCKS_PROXY_PORT: SOCKS proxy port for host.
• CLAUDE_CODE_HTTP_PROXY: Claude-namespaced HTTP proxy URL.
• CLAUDE_CODE_HTTPS_PROXY: Claude-namespaced HTTPS proxy URL.
• CLAUDE_CODE_MCP_SERVER_URL: The companion to MCP_SERVER_NAME, providing the server endpoint URL.

Frequently asked questions

All variables, searchable: Claude Code environment variables.