最近复核 2026-11-18测速批次 2026-08-11收录 71 家 · 实测 17 家

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 模式。

注意:Codex CLI 自带沙箱机制,在某些审批模式下,智能体执行的命令默认可能被限制联网。这是 Codex 自身的安全设置,与代理无关;如果任务里的 npm install 失败,先检查沙箱和审批模式设置。

登录 Codex:ChatGPT 账号还是 API Key

  1. 首次运行 codex 时选择“Sign in with ChatGPT”;
  2. 终端会在本地启动一个回调服务,并打开浏览器授权页面;
  3. 在浏览器中登录 ChatGPT 账号并授权;
  4. 浏览器跳回本地地址(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 教程。

还没选好机场?看 2026 机场推荐总榜,或按需求:便宜 · 稳定 · ChatGPT / Claude · 新手

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,说明请求从不受支持的地区发出,需要让代码也走代理。