Corporate proxy configuration
This page covers how to configure Claude Code to work with corporate proxy servers, including environment variable configuration, authentication, and SSL/TLS certificate handling.
Overview
Claude Code supports standard HTTP/HTTPS proxy configurations through environment variables. This allows you to route all Claude Code traffic through your organization’s proxy servers for security, compliance, and monitoring purposes.
Basic proxy configuration
Environment variables
Claude Code respects standard proxy environment variables:
Claude Code currently does not support the NO_PROXY
environment variable. All traffic will be routed through the configured proxy.
Claude Code does not support SOCKS proxies.
Authentication
Basic authentication
If your proxy requires basic authentication, include credentials in the proxy URL:
Avoid hardcoding passwords in scripts. Use environment variables or secure credential storage instead.
For proxies requiring advanced authentication (NTLM, Kerberos, etc.), consider using an LLM Gateway service that supports your authentication method.
SSL certificate issues
If your proxy uses custom SSL certificates, you may encounter certificate errors.
Ensure that you set the correct certificate bundle path: