在使用 Codex CLI 进行代码生成和自动化开发时，许多开发者会面临网络连接不稳定或无法直接访问后端 API 的问题。特别是在国内网络环境下，由于国际通信的限制，直接连接 OpenAI 或其他支持的 AI 服务往往会出现超时、断连或速率限制（Rate Limit）错误。为了解决这一痛点，正确配置网络代理（Proxy）成为确保 Codex CLI 稳定运行的关键步骤。本文将详细介绍如何在不同操作系统下完成这一配置，帮助开发者实现流畅的编码体验。
理解代理配置的核心原理
Codex CLI 本质上是一个命令行工具，它通过 HTTP/HTTPS 协议与远程服务器通信。当默认直连受阻时，我们需要引入中间节点——即代理服务器——来转发请求。配置代理的核心在于告诉 CLI 工具在发起网络请求时，使用指定的代理地址、端口以及认证信息（如果需要）。常见的代理类型包括 HTTP、HTTPS 和 SOCKS5。对于大多数基于 REST API 的服务，HTTP 或 HTTPS 代理足以满足需求。需要注意的是，环境变量是 CLI 工具读取配置的主要方式，因此我们主要通过设置系统环境变量来实现代理的全局生效。
Windows 系统下的配置方法
在 Windows 环境中，配置相对直观。你可以选择临时设置或永久设置两种方式。若希望仅在当前终端会话中生效，可以在启动 Codex CLI 前打开 PowerShell 或 CMD，输入以下命令：
set http_proxy=http://127.0.0.1:7890
set https_proxy=http://127.0.0.1:7890这里假设你的代理监听在本地 7890 端口。如果你使用的是需要认证的代理，格式应为 http://username:password@host:port。若要永久生效，则需进入“系统属性” -> “高级” -> “环境变量”，在“用户变量”或“系统变量”中新建 HTTP_PROXY 和 HTTPS_PROXY 变量并填入对应值。重启终端后，Codex CLI 即可自动识别并使用该代理。
macOS 与 Linux 系统的配置指南
对于 macOS 和 Linux 用户，通常使用 Bash 或 Zsh 作为默认 Shell。配置方法与 Windows 类似，但语法略有不同。你可以在终端中运行以下命令来临时设置：
export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"为了使配置持久化，建议将上述命令添加到你的 shell 配置文件末尾，如 ~/.bashrc、~/.zshrc 或 ~/.profile。修改完成后，执行 source ~/.zshrc（以 Zsh 为例）使配置立即生效。此外，部分代理客户端可能提供全局模式，这会使得所有应用都走代理，虽然方便，但可能会影响其他不需要代理的应用速度，因此推荐仅针对 CLI 工具进行定向配置，以保持系统环境的整洁与高效。
验证配置与故障排除
配置完成后，务必验证代理是否正常工作。你可以尝试运行一个简单的 Codex 命令，观察是否有响应延迟降低或连接成功的提示。如果仍然遇到连接错误，请检查代理地址是否正确、端口是否被防火墙拦截，或者代理服务器本身是否在线。同时，注意区分 http_proxy 和 HTTP_PROXY 的大小写敏感性，虽然大多数现代库对大小写不敏感，但保持一致性是良好的编程习惯。通过正确的代理配置，你将能够绕过网络障碍，充分发挥 Codex CLI 在辅助编程中的强大能力。