在使用 Claude Code 进行本地开发时，许多开发者会遇到网络连接不稳定的问题。这通常是因为默认的网络请求未能正确绕过防火墙或遵循企业内网策略。通过手动配置终端的网络代理，可以显著提升 API 调用的成功率与响应速度。本文将详细介绍如何在不同操作系统环境下，为 Claude Code 终端设置可靠的网络代理。
理解环境变量与代理机制
Claude Code 依赖底层终端环境来获取网络配置。因此，最直接且通用的方法是设置系统级或会话级的环境变量。在 Linux 和 macOS 系统中，HTTP_PROXY 和 HTTPS_PROXY 是标准的代理变量；而在 Windows PowerShell 中，则需使用 $env:HTTP_PROXY 语法。这些变量会被所有基于终端的应用程序自动读取，包括 Claude Code CLI。
除了全局变量，部分高级用户可能会尝试修改配置文件，但这种方式容易因版本更新而失效。推荐的做法是在启动 Claude Code 之前，先在当前终端会话中导出代理地址。例如，在 Bash 或 Zsh 中执行 export HTTPS_PROXY=http://127.0.0.1:7890，即可临时生效。这种方法无需更改系统注册表或全局配置，安全性更高，且便于切换不同的代理节点。
Windows 环境下的具体操作步骤
对于 Windows 用户，PowerShell 是最常用的命令行工具。打开 PowerShell 后，输入以下命令以设置代理：
$env:HTTPS_PROXY = "http://your-proxy-ip:port"
$env:HTTP_PROXY = "http://your-proxy-ip:port"
请注意，如果你的代理服务器需要认证，URL 格式应调整为 http://username:password@ip:port。设置完成后，可以直接运行 claude 命令进行测试。若遇到 SSL 证书验证错误，可能需要额外设置 NODE_TLS_REJECT_UNAUTHORIZED=0，但这会降低安全性，建议仅在测试环境中使用。此外，Windows 用户还可以检查系统的“代理设置”面板，确保“自动检测设置”未干扰手动配置的代理。
macOS 与 Linux 的持久化配置方案
在类 Unix 系统中，每次重启终端都需要重新设置变量较为繁琐。为了实现持久化配置，可以将 export 命令添加到 shell 的配置文件中。对于使用 Bash 的用户，编辑 ~/.bashrc 或 ~/.bash_profile；对于使用 Zsh 的用户，编辑 ~/.zshrc。在文件末尾添加如下行：
export HTTPS_PROXY="http://your-proxy-ip:port"
export HTTP_PROXY="http://your-proxy-ip:port"
保存文件后，执行 source ~/.zshrc（或对应的 bash 文件）使配置立即生效。这样，每当打开新的终端窗口时，Claude Code 就能自动识别并连接至指定的代理服务器。如果使用的是 fish shell，则需使用 set -xg HTTPS_PROXY "http://..." 的命令格式。这种配置方式不仅适用于 Claude Code，还能优化其他开发工具如 git、npm 等的网络表现，提升整体开发效率。
常见问题排查与优化建议
即使配置了代理，偶尔仍可能出现连接超时。首先，请确认代理服务器的端口是否开放，以及防火墙规则是否允许出站连接。其次，检查代理类型是否支持 HTTPS 隧道，因为 Claude API 通信主要基于 HTTPS 协议。如果代理不支持 CONNECT 方法，可以尝试更换为支持全协议的代理服务。最后，若网络依然不稳定，可考虑使用 DNS-over-HTTPS (DoH) 辅助解析，减少域名解析延迟。通过这些细致的调整，绝大多数网络障碍均可被解决，确保 Claude Code 流畅运行。
本文链接：https://bf-jianli.com.cn/jiaochen/claude-codezdwmdlpz-claude-codedlsz/
