CLAUDE_CODE_HTTPS_PROXY
Updated by Alex Sorokoletov
CLAUDE_CODE_HTTPS_PROXY is a Claude Code environment variable: Claude-namespaced HTTPS proxy URL. See CLAUDE_CODE_HTTP_PROXY above. Added between v2.1.114 and v2.1.117 and still present in v2.1.318. It is not in the official reference.
| Status | Present in v2.1.318 |
|---|---|
| Added | Added between v2.1.114 and v2.1.117 |
| 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_HTTPS_PROXY=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_HTTPS_PROXY": "<value>"
}
}Release notes that mention it
- Claude Code v2.1.123 — Background Daemons, Agent Fleets, and CoWork Memory
- Claude Code v2.1.118 — 10 New Environment Variables: Forked Subagents Ship, Subscription Tiering Takes Shape
- Claude Code Version Tracker: Undocumented Env Vars, Feature Gates & Models
Related variables
HTTPS_PROXY: HTTPS proxy server URL.CLAUDE_CODE_AGENT_PROXY_GH_SHIM: When set, installs a gh CLI shim so GitHub CLI calls route through the agent proxy's governed git.CLAUDE_CODE_AGENT_PROXY_GIT_CONFIG: When set, appends a governed git config so git operations route through the agent proxy.CLAUDE_CODE_AGENT_PROXY_GIT_HOSTS: Comma-separated list of git hosts routed through the agent proxy's governed git; invalid entries are dropped and an empty value falls back to the default host.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_PROXY_HOST: Proxy hostname, passed alongside the URL so helpers that route credentials by hostname don't need to re-parse.
Frequently asked questions
What does CLAUDE_CODE_HTTPS_PROXY do?
Claude-namespaced HTTPS proxy URL. See CLAUDE_CODE_HTTP_PROXY above.
Which Claude Code version has CLAUDE_CODE_HTTPS_PROXY?
Added between v2.1.114 and v2.1.117 and still present in v2.1.318.
How do I set CLAUDE_CODE_HTTPS_PROXY?
Export it before starting Claude Code (export CLAUDE_CODE_HTTPS_PROXY=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.