codex在国内无法连接openai api是因网络限制导致请求失败,需通过本地代理解决:先确认代理端口(如7897)已监听,再为cli配置http_proxy/https_proxy环境变量,桌面版需修改config.toml启用proxy,远程服务器则用ssh反向隧道复用本地代理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

国内网络环境下 Codex 无法连接 OpenAI API(https://api.openai.com),导致“正在思考”卡住、CLI 报 ETIMEDOUT 错误或登录失败,本质是请求发不出去或 TLS 握手超时,必须通过本地代理服务中转流量。
确认本地代理端口是否就绪
Codex 不会读取系统代理设置,只认明确指定的 HTTP 代理地址,因此第一步必须验证你的代理工具(如 Clash、V2RayN、Stash)是否真正监听了可被 Codex 访问的端口。
在 Windows PowerShell 中执行:netstat -ano | findstr :7897
若输出中含 TCP 127.0.0.1:7897 或 TCP 0.0.0.0:7897 且状态为 LISTENING,说明端口已就绪;若无任何输出,需回到代理工具设置中开启「允许来自局域网的连接」并确认 HTTP 代理端口设为 7897(或其他你打算使用的端口)。
这一步跳过会导致后续所有配置无效——Codex 会持续超时,因为根本连不到代理入口。
给 Codex CLI 配置环境变量代理
CLI 命令行工具依赖系统级环境变量识别代理,Windows 和 macOS/Linux 的写法不同,不可混用。
方法一(Windows):在 PowerShell 中逐条执行
$env:HTTP_PROXY="http://127.0.0.1:7897"
$env:HTTPS_PROXY="http://127.0.0.1:7897"
⚠️ 注意:该设置仅对当前 PowerShell 窗口生效,关闭即失效。如需永久生效,改用 setx HTTP_PROXY "http://127.0.0.1:7897",但需重启终端才加载。
方法二(macOS / Linux):编辑 shell 配置文件
运行 echo 'export HTTP_PROXY=http://127.0.0.1:7897' >> ~/.zshrc → 再运行 echo 'export HTTPS_PROXY=http://127.0.0.1:7897' >> ~/.zshrc → 最后执行 source ~/.zshrc
这一步做完后,直接在终端输入 codex --help 应能秒出结果,不再卡在“正在思考”。
为 Codex Desktop App 配置代理
桌面版 Codex(Electron 构建)不继承系统代理,也不读取 shell 环境变量,必须通过其内部配置文件强制注入代理地址。
第一步:定位配置文件路径
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
Windows 路径为 C:\Users\用户名\.codex\config.toml;macOS 路径为 ~/Library/Application Support/codex/config.toml;Linux 路径为 ~/.codex/config.toml。
第二步:用文本编辑器打开 config.toml,在文件末尾新增以下三行(注意缩进与大小写):
network = { proxy = { enabled = true, http = "http://127.0.0.1:7897", https = "http://127.0.0.1:7897" } }
【必须确保 config.toml 文件中没有其他 network.proxy 相关字段重复定义,否则会覆盖或冲突】
第三步:保存文件,彻底退出 Codex 桌面应用(右键托盘图标→退出,不要仅关闭窗口),再重新启动。
远程服务器上让 Codex 复用本地代理
当 Codex 运行在无外网权限的远程服务器(如阿里云 ECS、内网开发机)时,不能在服务器上装代理,而应把本地电脑的代理能力“转发过去”。
① 在本地电脑确认代理监听的是 0.0.0.0:7897(不是仅 127.0.0.1:7897),并在防火墙放行该端口;
② 在本地终端执行 SSH 反向端口映射命令:
ssh -R 7897:localhost:7897 user@remote-server-ip
③ 登录远程服务器后,立即执行:
export HTTP_PROXY=http://127.0.0.1:7897
export HTTPS_PROXY=http://127.0.0.1:7897
④ 将这两行追加到 ~/.bashrc 末尾,再执行 source ~/.bashrc 永久生效。
此时 codex list 或 codex suggest 命令发出的请求,会经由 SSH 隧道抵达你本地电脑的代理端口,再转发至 OpenAI。










