OpenAI Codex 使用教程:CLI、IDE 插件与云端任务
AI 工具 · 发布 2026-10-08 · 更新 2026-11-18 · 约 7 分钟读完
快速答案
Codex 是 OpenAI 的编程智能体,有命令行(Codex CLI)、IDE 插件和 ChatGPT 网页里的云端版本。国内使用需先让终端走代理(设置 HTTPS_PROXY 或开 TUN 模式),出口固定在美国、日本等受支持地区,然后用 ChatGPT Plus 及以上账号或 API Key 登录。
目录
Codex 国内怎么用:快速答案安装 Codex CLI让 Codex 走代理:环境变量与 TUN登录 Codex:ChatGPT 账号还是 API KeyIDE 插件与云端 Codex常见错误与解决方法节点与流量建议适合 Codex 用户的机场小结常见问题Codex 国内怎么用:快速答案
OpenAI Codex 目前有三种使用形态:
| 形态 | 入口 | 网络要求 |
|---|---|---|
| Codex CLI | 终端里运行 codex | 终端必须走代理 |
| IDE 插件 | VS Code、Cursor 等编辑器的 Codex 扩展 | 编辑器进程必须走代理 |
| Codex 云端 | ChatGPT 网页侧边栏的 Codex,连接 GitHub 仓库 | 浏览器走代理即可,任务在 OpenAI 云端运行 |
三种形态都要求账号所在的网络出口位于 OpenAI 受支持地区(中国大陆和香港不在其中),并使用 ChatGPT 付费账号(Plus、Pro、Business 等)登录,或使用 OpenAI API Key 按量计费。对国内用户来说,最常卡住的是 CLI 和 IDE 插件,因为它们默认不读取系统代理。下文重点讲这两部分。ChatGPT 账号本身的网络准备请先看 ChatGPT 国内怎么用。
安装 Codex CLI
Codex CLI 是开源的命令行工具,截至 2026 年常用的安装方式:
npm install -g @openai/codex
macOS 用户也可以通过 Homebrew 安装。安装完成后运行 codex --version 确认安装成功。Windows 用户官方更推荐在 WSL 中使用,原生 Windows 的支持程度以官方文档为准。
国内网络下 npm 安装本身可能很慢,可以先给 npm 设置代理,或在开启 TUN 模式后再安装:
npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890
端口请替换为你自己客户端的本地端口。更多终端代理设置见 终端 / git / npm 代理。
让 Codex 走代理:环境变量与 TUN
方式一:HTTPS_PROXY 环境变量
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1
codex
把这几行写进 ~/.zshrc 可以永久生效。NO_PROXY 里一定要保留 localhost,否则登录时的本地回调请求也会被发往代理,导致登录卡住。
方式二:TUN 模式
在 Clash Verge Rev、Mihomo Party 等客户端中开启 TUN 模式后,终端、IDE、浏览器都会自动走代理,无需单独配置。对于 Codex 这种会调用子进程(git、包管理器、测试命令)的工具,TUN 模式更省心。两种方式的对比见 规则 / 全局 / TUN 模式。
npm install 失败,先检查沙箱和审批模式设置。登录 Codex:ChatGPT 账号还是 API Key
- 首次运行
codex时选择“Sign in with ChatGPT”; - 终端会在本地启动一个回调服务,并打开浏览器授权页面;
- 在浏览器中登录 ChatGPT 账号并授权;
- 浏览器跳回本地地址(localhost),终端显示登录成功。
也可以选择用 API Key 登录,此时按 OpenAI API 的价格计费,适合已经有 API 额度的团队。
如果你在远程服务器(SSH)上运行 Codex,浏览器回调到的是你本机的 localhost,而不是服务器,会导致登录失败。常见的解决办法是用 SSH 端口转发把回调端口映射回本机,或者使用设备码 / API Key 方式登录,具体以官方文档为准。
IDE 插件与云端 Codex
IDE 插件:在 VS Code 扩展市场搜索 Codex 安装,登录方式与 CLI 相同。编辑器进程需要能访问 OpenAI:可以在 VS Code 设置里填写 http.proxy 为 http://127.0.0.1:7890,或者直接开 TUN。Cursor 用户的设置略有不同,见 Cursor 代理设置。
云端 Codex:在 ChatGPT 网页中打开 Codex,连接 GitHub 账号并授权仓库后,可以直接下达任务,Codex 会在云端容器里修改代码并生成 Pull Request。因为任务在 OpenAI 服务器运行,你本地只需要浏览器能稳定访问 chatgpt.com 和 github.com。GitHub 相关的网络设置可以参考 GitHub Copilot 网络设置。
常见错误与解决方法
| 现象 | 原因 | 处理 |
|---|---|---|
| 运行后一直显示连接中 / stream disconnected | 终端未走代理或节点不稳定 | 设置 HTTPS_PROXY 或开启 TUN,换一个稳定节点 |
| 浏览器授权后终端没反应 | localhost 回调被代理拦截 | 在 NO_PROXY 中加入 localhost 和 127.0.0.1 |
| unsupported_country_region_territory | 出口在香港或其他不受支持地区 | 切换到美国、日本、新加坡、台湾节点 |
| 429 / usage limit reached | 账号额度用完 | 等待额度重置或升级方案,与网络无关 |
| Too many requests | 共享 IP 请求过多 | 换节点,见 Too many requests 处理 |
| 证书错误 | 代理启用了 HTTPS 解密 | 对 openai.com 关闭 MITM |
节点与流量建议
Codex 任务常常持续较长时间,并且会上传项目上下文,所以比普通聊天更依赖线路稳定性:
- AI 相关域名(openai.com、chatgpt.com)放在一个手动选择的策略组里,固定一个美国或日本节点;
- 避免使用自动测速切换,任务中途换 IP 可能导致连接中断;
- 重度使用时,每月流量会比纯聊天高不少,建议选择 100GB 以上的套餐;
- 选专线机场,晚高峰更稳定,原理见 IEPL 与 IPLC 的区别。
节点地区的选择逻辑与 ChatGPT 完全一致,可参考 AI 工具该选哪个节点。
适合 Codex 用户的机场
写代码的用户一般同时用 Codex、Claude Code、Cursor 等多款工具,选机场时看三点:美国 / 日本节点是否充足、是否为专线、流量是否够用。本站收录的 速界 在品牌资料中明确面向 ChatGPT / Claude / Codex 用户,月付 25 元 150GB;一翻云 月付 20 元 150GB、IEPL 专线,品牌资料显示兼顾 AI 工具使用场景。AI 可用性均为品牌资料描述,实际受节点 IP、地区和平台策略影响。更多选择见 AI 专用机场推荐。
小结
Codex 国内使用的要点:CLI 和 IDE 插件需要单独让进程走代理(HTTPS_PROXY 或 TUN),NO_PROXY 留出 localhost 以免登录回调失败,出口固定在受支持地区并避免自动切换。云端 Codex 只需要浏览器能稳定访问 ChatGPT 和 GitHub。线路选择可以从 机场推荐总榜 入手。
常见问题
Codex 免费吗?
Codex 包含在 ChatGPT Plus、Pro、Business 等付费方案中,也可以使用 API Key 按量计费,具体额度以 OpenAI 官方页面为准。
Codex CLI 登录一直卡住怎么办?
多数是 localhost 回调被代理拦截,在 NO_PROXY 中加入 localhost 和 127.0.0.1,或改用 TUN 模式,详见 终端代理设置。
Codex 用哪个地区的节点?
与 ChatGPT 相同,使用美国、日本、新加坡、台湾等受支持地区,不能用香港,并固定一个节点,参考 AI 节点选择。
Codex 和 Claude Code 有什么区别?
两者都是终端里的编程智能体,Codex 使用 OpenAI 模型并可用 ChatGPT 账号登录,Claude Code 使用 Anthropic 模型,代理设置方法基本相同,见 Claude Code 教程。
AI 工具 · 继续阅读
ChatGPT 国内怎么用:从网络环境、节点选择到账号注册
中国大陆不在 OpenAI 的服务地区内,需要先通过代理把出口切到受支持的地区(美国、日本、新加坡、台湾等,避开香港),再用邮箱或 Google / 微软 / Apple 账号注册登录;日常使用尽量固定一个节点,配合规则模式或 TUN 模式,即可稳定访问网页版、App 和 API。
ChatGPT Plus 怎么开通:官方付款渠道、费用与注意事项
ChatGPT Plus 只能通过官方渠道开通:网页端绑定 OpenAI 支持的银行卡付款,或在受支持地区的 App Store / Google Play 应用内订阅。开通前先固定一个受支持地区的节点,账单地址与节点地区尽量一致;第三方代充和共享账号存在封号、退款和隐私风险,不建议使用。
Claude 国内怎么用:网络环境、注册验证与账号防封
Claude 不向中国大陆和香港提供服务,国内使用需要把网络出口固定在美国、日本、英国等受支持地区;注册时可能需要受支持地区的手机号验证。Claude 对 IP 变动和共享 IP 比 ChatGPT 更敏感,建议使用干净的固定节点、开启 TUN 模式防 DNS 泄漏,并且不要多人共用账号。
Claude Code 安装与代理配置:从安装到 HTTPS_PROXY 设置
Claude Code 可通过官方安装脚本或 npm 安装,登录需要 Claude Pro / Max 账号或 Anthropic API Key。国内使用的关键是让终端走代理:设置 HTTPS_PROXY / HTTP_PROXY 环境变量,或直接开启客户端 TUN 模式,并把出口固定在美国、日本等受支持地区。
Gemini 国内怎么用:Google 账号、节点地区与常见问题
国内使用 Gemini 需要一个 Google 账号和受支持地区的网络出口(美国、日本、新加坡、台湾等,香港不行)。如果节点没问题仍提示地区不支持,往往是 Google 账号的“关联国家”被判定为中国或香港,需要检查账号的国家/地区设置。
Google AI Studio 使用教程:创建 API Key 与解决地区限制
Google AI Studio(aistudio.google.com)是 Google 面向开发者的 Gemini 模型调试平台,可免费试用并创建 Gemini API Key。国内访问需要代理,出口须在受支持地区;调用 API 时如果报 User location is not supported,说明请求从不受支持的地区发出,需要让代码也走代理。