在使用 Claude Code 进行本地代码辅助开发时，许多开发者会遭遇“连接超时”或“403 Forbidden”等网络错误。这通常不是因为账号欠费，而是由于当前网络环境无法直接连通 Anthropic 的服务器。此时，正确配置工作区的网络代理（Proxy）成为打通 API 调用的关键步骤。本文将结合具体场景，指导如何在不同操作系统下完成这一配置。
理解代理配置的核心逻辑
Claude Code 底层依赖 HTTP/HTTPS 协议与云端大模型通信。当你的开发环境处于内网、学校局域网或受限制的网络区域时，必须通过中间代理服务器转发请求。这里的“工作区网络代理配置”并非指 IDE 的全局设置，而是特指传递给 Claude CLI 进程的环境变量。一旦配置成功，所有由 Claude Code 发起的对话、代码生成及文件读取后的分析请求，都将自动经过你指定的代理出口，从而绕过地域限制或网络封锁。
Windows 系统下的配置方法
对于使用 Windows 环境的用户，配置过程相对直观但需注意命令行的差异。如果你使用的是 PowerShell 或 CMD，可以通过临时设置环境变量的方式启动 Claude Code。例如，在终端中执行以下命令：
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
claude
这里假设你的本地代理端口为 7890，请根据实际使用的代理软件（如 Clash、V2Ray 等）调整 IP 和端口。若需永久生效，可在系统环境变量中添加 HTTP_PROXY 和 HTTPS_PROXY。需要注意的是，部分 Windows 版本对大小写敏感，建议统一使用大写命名以兼容大多数 shell 环境。
macOS 与 Linux 系统的配置策略
在类 Unix 系统中，配置更为灵活。最推荐的方式是修改 Shell 的配置文件（如 .bashrc 或 .zshrc），添加如下行：
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
保存后运行 source ~/.zshrc 使配置立即生效。这样，每次打开终端启动 Claude Code 时，代理都会自动加载。此外，如果你的代理需要认证，URL 格式应为 http://username:password@host:port。务必确保密码中的特殊字符已进行 URL 编码，以避免解析错误。
验证与故障排查
配置完成后，不要急于开始复杂任务，先进行一次简单的测试。在 Claude Code 中输入 “Hello”，观察是否返回正常响应。如果依然报错，请检查以下几点：首先确认代理服务本身是否在后台正常运行；其次，尝试在终端直接使用 curl 命令测试代理连通性，如 curl -x http://127.0.0.1:7890 https://api.anthropic.com；最后，检查是否有防火墙规则拦截了出站流量。通过这种场景化的逐步排查，绝大多数网络代理配置问题都能得到解决，让你重新享受流畅的代码辅助体验。
本文链接：https://jianli-bf.com.cn/gpt/claude-code-gzqwmdlpzzn-jjmxfwsxwt/
