在使用 Claude Code 进行高效代码辅助时，许多开发者尤其是国内用户，常常会遇到网络连接不稳定的情况。这通常是因为默认配置未能正确识别或应用系统级的网络代理设置。对于不熟悉底层网络配置的新手来说，理解如何为 Claude Code 配置网络代理是确保其流畅运行的关键一步。本文将手把手教你完成这一过程，无需复杂的命令行操作，只需简单的几步即可让 AI 助手重新“在线”。
为什么需要单独配置网络代理？
Claude Code 作为一个基于终端的 AI 编程助手，它通过 API 与 Anthropic 的服务端进行通信。如果你的开发环境处于一个需要通过 HTTP/HTTPS 代理才能访问外网的环境中（例如某些企业内网或特定的网络限制区域），直接运行命令往往会因为连接超时而失败。虽然操作系统本身可能已经设置了全局代理，但许多 CLI（命令行界面）工具并不会自动继承这些系统级设置。因此，显式地为 Claude Code 指定代理地址，是打通数据通道的最直接方法。
快速配置步骤：使用环境变量
最通用且推荐的方法是通过设置环境变量来告知 Claude Code 使用哪个代理。这种方法不需要修改配置文件，重启终端后依然生效，非常适合日常开发使用。
首先，你需要知道你的代理服务器地址和端口。通常格式为 http://127.0.0.1:port 或 socks5://127.0.0.1:port。假设你的代理地址是 http://127.0.0.1:7890，你可以按照以下方式进行临时配置：
在 macOS 或 Linux 系统中，你可以在启动 Claude Code 之前，在终端中运行以下命令：
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
claude这样，当前终端会话中的所有请求都会经过指定的代理。如果你使用的是 Windows 系统（CMD 或 PowerShell），命令略有不同：
set http_proxy=http://127.0.0.1:7890
set https_proxy=http://127.0.0.1:7890
claude这种方式的优势在于灵活性。你可以根据不同的项目需求切换代理，或者在不使用代理时直接关闭终端窗口，不会影响其他应用程序。
永久配置与环境变量持久化
如果你希望每次打开终端都能自动使用代理，而不必每次都手动输入命令，可以将上述导出语句添加到你的 shell 配置文件中。对于大多数使用 Zsh 的用户（如 macOS 默认终端），编辑 ~/.zshrc 文件；对于 Bash 用户，则编辑 ~/.bash_profile 或 ~/.bashrc。
在文件末尾添加以下内容：
export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"保存文件后，运行 source ~/.zshrc（或对应的 bash 文件）使配置立即生效。此后，无论你是否主动启动 Claude Code，只要在该终端环境中，网络请求都会自动走代理通道。这种方法极大地提升了开发体验，避免了因网络波动导致的重复调试时间。
常见问题排查
如果配置后仍然无法连接，请检查以下几点：首先确认代理服务是否正在运行，可以尝试在其他浏览器或工具中测试该代理地址是否可用。其次，注意区分 HTTP 和 SOCKS5 协议，确保你在环境变量中使用的协议前缀与代理实际支持的协议一致。最后，部分高级代理可能需要认证信息，此时地址格式应为 http://username:password@host:port。通过遵循以上步骤，绝大多数联网问题都能得到解决，让你专注于代码本身而非网络障碍。
掌握正确的网络代理配置，是让 Claude Code 这类现代开发工具发挥最大效能的基础。希望本文能帮助你顺利跨越网络门槛，享受更流畅的智能编码体验。
本文链接：https://ai-claudecode.cn/gpt/claude-code-skills-wmdlpzzn-xsqsjjlwwt/