在使用 Claude Code 进行代码辅助开发时，许多国内开发者可能会遇到网络连接不稳定或 API 请求超时的情况。这通常是因为默认的网络环境无法直接访问 Anthropic 的服务器。通过正确配置命令行网络代理，可以显著改善开发体验，确保代码补全、对话生成等功能流畅运行。本文将针对新手用户，详细讲解如何在不同操作系统下设置环境变量，以解决这一常见痛点。
理解代理配置的核心逻辑
Claude Code 作为一个基于命令行的 AI 编程助手，其底层依赖 HTTP/HTTPS 协议与云端服务通信。当本地网络存在防火墙限制或路由不畅时，配置代理（Proxy）成为必经之路。这里的“代理”并非指游戏加速器，而是指在终端环境中设置 `HTTP_PROXY` 和 `HTTPS_PROXY` 环境变量。这些变量告诉系统在处理特定类型的网络请求时，先经过指定的代理服务器中转，从而绕过直接连接的障碍。对于 Claude Code 而言，只要终端能够识别并应用这些代理设置，它就能正常发起 API 调用。
需要注意的是，代理地址的格式通常为 `http://127.0.0.1:端口号` 或 `socks5://127.0.0.1:端口号`。你需要确保你的本地代理软件正在运行，并且端口号正确无误。此外，部分高级场景可能需要配置 `NO_PROXY` 变量，以避免对本地局域网资源也进行代理转发，但这在大多数个人开发场景中并非必需。
Windows 系统下的配置方法
对于使用 Windows 系统的开发者，配置过程相对直观但需要区分临时生效和永久生效两种方式。最简单的方法是直接在当前命令行窗口中设置环境变量。打开 PowerShell 或 CMD，输入以下命令：
`$env:HTTP_PROXY="http://127.0.0.1:7890"`
`$env:HTTPS_PROXY="http://127.0.0.1:7890"`
请将 `7890` 替换为你实际使用的代理端口。执行这两条命令后，当前窗口启动的 Claude Code 实例将自动使用该代理。如果需要长期生效，建议修改系统环境变量或在 `.bashrc` / `.profile` 等配置文件中添加导出语句。对于使用 Git Bash 的用户，可以直接在 Shell 配置文件中添加 `export http_proxy=http://127.0.0.1:7890` 和 `export https_proxy=http://127.0.0.1:7890`，这样每次打开终端都会自动加载代理设置。
macOS 与 Linux 系统的配置技巧
在 macOS 和主流 Linux 发行版中，配置文件的位置取决于你使用的 Shell 类型。如果你使用的是默认的 Zsh，请编辑 `~/.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` 或 `source ~/.bash_profile` 使配置立即生效。验证配置是否成功的最简单方法是重新打开一个终端窗口，输入 `echo $https_proxy`，如果输出与你设置的地址一致，说明配置已生效。此时再运行 `claude` 命令，即可看到网络连接状态的改善。如果遇到 SSL 证书验证错误，可能还需要检查代理服务器的证书信任链，但在大多数标准代理场景下，上述配置足以解决绝大多数连接问题。
本文链接：https://bf-jianli.com.cn/gpt/claude-code-mlxwmdlpzzn-jj-api-ljcswt/
