Appearance
Codex 国内使用指南
OpenAI Codex 的服务器在海外，中国大陆用户需要通过代理才能正常访问。本文覆盖 Codex App、CLI 和 IDE 扩展三种场景下的代理配置方法。
⚠️ 注意：本文仅介绍技术配置方法，请确保你的访问方式符合所在地区的相关法律法规。
Codex CLI 代理配置
Codex CLI 遵循标准环境变量代理设置：
bash
# 设置代理（临时，当前终端有效）
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"
# 然后正常使用 Codex
codex "帮我修复这个 bug"永久配置（加入 ~/.bashrc 或 ~/.zshrc）：
bash
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"API 中转配置（使用国内中转服务）
如果你使用国内 OpenAI API 中转服务，可以在 Codex CLI 的配置中覆盖 base URL：
toml
# ~/.config/codex/config.toml 或项目根目录 codex.toml
[providers.openai]
base_url = "https://your-proxy.example.com/v1"
api_key = "your-api-key"或通过环境变量：
bash
export OPENAI_API_BASE="https://your-proxy.example.com/v1"
export OPENAI_API_KEY="your-api-key"注意：中转服务的稳定性和安全性由提供商负责。推荐使用 API Key 有效期短、限制 IP 的中转服务以降低风险。
Codex App 代理配置
Codex App（桌面客户端）使用系统代理，需要在操作系统层面设置：
macOS：
- 系统偏好设置 → 网络 → 高级 → 代理 → 配置 HTTPS 代理
Windows：
- 设置 → 网络和 Internet → 代理 → 手动代理设置
设置系统代理后重启 Codex App 即可生效。
常见网络问题
Q：Codex CLI 提示 connection refused / timeout？
检查代理是否正在运行，确认端口号正确：
bash
curl -x http://127.0.0.1:7890 https://api.openai.com/v1/modelsQ：可以使用 API Key 直连吗？
如果你的服务器/VPS 在海外，可以把 Codex CLI 部署在服务器上，用 SSH 隧道转发：
bash
# 本地转发，通过 SSH 隧道使用远端 Codex
ssh -L 7890:127.0.0.1:7890 user@your-serverQ：有推荐的中转服务吗？
本站不推荐或背书任何具体中转服务商。请在独立开发者社区（如 V2EX、掘金）寻找近期评价，注意辨别风险。