在使用 Claude Code 这一强大的 AI 编程助手时，许多开发者尤其是身处网络环境复杂地区的用户，经常会遇到连接超时、请求被拒或速度极慢的问题。这通常并非软件本身的 Bug，而是由于默认的网络请求路径未能正确路由至 Anthropic 的服务器所致。本文将手把手教你如何在命令行界面（CLI）中配置网络代理，确保你的代码生成工作流顺畅无阻。
理解为什么需要配置代理
Claude Code 本质上是一个通过 API 调用大语言模型的工具。在本地终端运行 claude 命令时，它需要实时向云端发送上下文并接收回复。如果你的网络出口无法直接稳定访问海外服务，或者公司内网有严格的防火墙策略，直连往往会失败。此时，引入一个支持 HTTPS 的 HTTP/HTTPS 代理服务器就成了关键。这不仅能解决连通性问题，还能在一定程度上优化数据传输效率，减少因丢包导致的重试延迟。
临时生效：通过环境变量快速启动
对于大多数新手用户，最简单且风险最低的方法是设置环境变量。这种方法不需要修改任何全局配置文件，仅对当前终端会话有效。如果你使用的是 Linux 或 macOS 系统，可以在启动 Claude Code 之前，先执行以下命令：
export https_proxy=http://127.0.0.1:端口号
export http_proxy=http://127.0.0.1:端口号
这里的 127.0.0.1 代表本地回环地址，端口号 需替换为你实际使用的代理软件监听端口（如 Clash 通常是 7890 或 7897）。Windows 用户则可以使用 set 命令或在 PowerShell 中使用 $env 变量赋值。设置完成后，直接运行 claude，工具会自动读取这些环境变量并通过代理发起请求。这是排查问题最快的方式，建议优先尝试。
永久生效：修改全局配置文件
如果你希望每次打开终端都能自动使用代理，而不必重复输入命令，可以配置全局环境变量。在 Unix-like 系统中，你可以将 export 语句添加到 ~/.bashrc、~/.zshrc 或 ~/.profile 文件中。保存并执行 source ~/.bashrc 使配置立即生效。这样，所有后续启动的 Claude Code 实例都将继承该网络设置。
值得注意的是，部分代理工具可能需要区分 HTTP 和 HTTPS 流量，因此建议同时设置 http_proxy 和 https_proxy。此外，如果代理服务器需要认证（用户名和密码），格式应为 http://user:password@host:port。请务必妥善保管密码信息，避免在公共场合泄露配置文件内容。
验证配置与故障排除
配置完成后，如何确认代理是否真正生效？你可以在终端中运行一个简单的测试命令，例如 curl -I https://www.anthropic.com。如果返回了正常的 HTTP 状态码（如 200 OK），说明网络通道已打通。接着再启动 Claude Code，观察首次加载时的日志输出。如果发现仍然报错，请检查代理服务器的稳定性，或尝试切换不同的端口。有时，系统自带的 DNS 解析也会影响连接速度，此时可以考虑配合设置 NO_PROXY 环境变量，将本地局域网地址排除在代理之外，以提升整体响应性能。
通过以上步骤，你应该能够顺利解决 Claude Code 的连接难题。记住，保持代理工具的更新以及合理配置环境变量，是享受高效 AI 编程体验的基础。如有其他网络相关疑问，欢迎查阅官方文档或社区讨论区获取更多技术支持。
本文链接：https://ai-claudecode.cn/%E6%9C%AA%E5%91%BD%E5%90%8D/claude-code-cli-wmdlpzzn-jjljsxyjsfw/