# OpenAI Codex CLI 使用教程（2026）：国内安装、登录与代理设置

> OpenAI Codex CLI 使用教程：Codex 怎么用、国内怎么安装、登录失败怎么办、代理怎么设置。给出安装脚本、npm、Homebrew 三种官方命令，讲 ChatGPT 账号与 API 密钥登录、1455 回调端口、终端代理、常用命令、和 Claude Code 的区别与连接失败排查。

来源：11号登机口（https://jichanggege.mom/ai/codex/）｜更新于 2026-11-19｜引用请注明来源与核对日期

OpenAI Codex CLI 使用教程：Codex 怎么用、国内怎么安装、登录失败怎么办、代理怎么设置。给出安装脚本、npm、Homebrew 三种官方命令，讲 ChatGPT 账号与 API 密钥登录、1455 回调端口、终端代理、常用命令、和 Claude Code 的区别与连接失败排查。

更新于 2026 年 11 月 19 日 · 约 6431 字 · 14 分钟读完 · 11号登机口编辑

快速结论

这篇 OpenAI Codex CLI 使用教程先说结论：Codex CLI 的官方安装方式有四种：安装脚本、Windows 的 PowerShell 脚本、npm 和 Homebrew，命令见下文。登录首选用 ChatGPT 账号，浏览器授权后会回调本机的 1455 端口。它是命令行程序，不读系统代理，最稳妥的办法是打开代理客户端的 TUN 模式；只想让终端走代理，就在启动前设置 HTTP 代理环境变量。节点要落在 OpenAI 支持的地区，并且固定不变。下文的命令都来自官方仓库和文档，命令会更新，以官方页面为准。

## OpenAI Codex CLI 使用教程：它是什么，需要什么账号

Codex CLI 是 OpenAI 开源的命令行编程助手，在终端里读代码、改文件、运行命令。代码仓库在 https://github.com/openai/codex，官方文档从 https://developers.openai.com/codex 进入，目前会跳转到 OpenAI 的新文档站。

账号有两种用法，官方仓库的说明是：

| 登录方式 | 计费 | 说明 |
| --- | --- | --- |
| ChatGPT 账号 | 走订阅额度 | 官方推荐，说明里列出的套餐是 Plus、Pro、Business、Edu、Enterprise |
| API 密钥 | 按用量计费 | 需要 OpenAI 平台账号和额外设置 |

套餐范围会调整，以官方页面为准。ChatGPT 账号本身的注册、支持地区和报错处理见 [ChatGPT 使用教程](https://jichanggege.mom/ai/chatgpt/)。

除了命令行版本，Codex 还以桌面应用和 IDE 扩展的形式提供，入口都在官方文档里，本文以命令行为主，其他形态的网络差异放在下一节。

## Codex 国内怎么用：准备和顺序

Codex 走的是 OpenAI 的账号和地区体系，所以国内使用的前提和 ChatGPT 一样：账号能正常登录，出口在 OpenAI 支持的地区。多出来的是终端这一层，命令行程序不读系统代理，这是国内用户最常卡住的地方。按这个顺序准备：

1. **先在浏览器里把 ChatGPT 用顺。** 账号注册、节点挑选都在 [ChatGPT 使用教程](https://jichanggege.mom/ai/chatgpt/) 里，浏览器能稳定对话，说明账号和节点没有问题。
2. **决定终端怎么走代理。** 想省事就开 TUN 模式；只想影响终端，就用环境变量。两种办法见下文「代理设置」。
3. **在终端里确认出口。** curl 查一次出口 IP，地区和浏览器一致。
4. **运行官方安装命令。** 安装脚本从境外服务器下载，必须在终端走代理之后再运行。
5. **登录。** 运行 codex，选 ChatGPT 账号登录，留意 1455 端口的回调不能被代理扩展转发。
6. **先小任务后长任务。** 确认节点在长连接下也稳定，再固定下来。

安装到一半没反应、浏览器授权成功但终端报错，这两种情况在国内最常见，几乎都是终端没走代理或出口不一致造成的，下文都有对应的处理。

## Codex 的几种形态与各自的网络要求

同叫 Codex，运行的位置不同，对你本机网络的要求也不同。弄清楚自己用的是哪一种，排查时才不会找错方向。

| 形态 | 在哪里运行 | 你这边的网络要做什么 |
| --- | --- | --- |
| 命令行 CLI | 本机终端 | 终端必须走代理，见下文的 TUN 或环境变量 |
| IDE 扩展 | 本机编辑器 | 跟随编辑器的代理设置；从图形界面启动的编辑器不继承终端变量，TUN 最省事 |
| 桌面应用 | 本机 | 和 ChatGPT 桌面应用相同，连不上就开 TUN |
| 网页上的云端任务 | OpenAI 的服务器 | 只需要浏览器能正常打开页面；任务运行环境的联网方式由官方设置决定，以官方说明为准 |

云端任务需要先连接代码仓库，具体流程以官方页面当时的说明为准。它和本机的 CLI 共用 ChatGPT 账号，所以网页和终端最好走同一个地区的出口，避免同一账号同时出现在两个国家。

## Codex CLI 安装：官方命令与各平台差异

下面四条命令来自官方仓库的说明文件，动手前建议到仓库首页再核对一次。

macOS 与 Linux：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

npm：

npm install -g @openai/codex

Homebrew：

brew install --cask codex

装完后在项目目录里运行：

codex

官方文档写的升级方式是重新运行一次安装脚本。用 npm 或 Homebrew 安装的，按各自包管理器的升级方式处理。

**Windows 与 WSL。** 除了上面的 PowerShell 脚本，官方文档还有一页专门讲 WSL：在管理员权限的 PowerShell 里运行 wsl --install 装好 WSL2，然后进入 WSL 的终端，用 Linux 的安装脚本安装并运行 codex。文档建议把代码仓库放在 Linux 的主目录下，而不是 /mnt/c/ 里，那样读写更快，权限问题也更少。文档同时说明 WSL1 已经不再支持。原生 Windows 和 WSL 两种方式的沙箱机制不同，怎么选以官方文档当前的建议为准。

**各平台的差异。** 下面这张表把几种系统上容易出问题的地方放在一起：

| 平台 | 推荐安装方式 | 代理变量写法 | 需要留意 |
| --- | --- | --- | --- |
| macOS | 安装脚本或 Homebrew | export，可写进 ~/.zshrc | 从程序坞启动的编辑器不继承终端变量 |
| Linux | 安装脚本或 npm | export，可写进 ~/.bashrc | 服务器上没有浏览器，登录用设备码或端口转发 |
| 原生 Windows | PowerShell 安装脚本 | $env:，只对当前窗口有效 | 沙箱机制和类 Unix 系统不同，以官方文档为准 |
| WSL2 | 在 WSL 里用 Linux 安装脚本 | export，地址不能写 127.0.0.1 | 在 Windows 侧开 TUN，或用 Windows 主机地址并允许局域网连接 |

Codex 的个人配置放在用户目录下的 .codex 文件夹里，登录凭据也在这里。换电脑时不要把整个文件夹打包发到聊天软件里，里面有访问令牌。

**安装时的网络。** 安装脚本从 chatgpt.com 获取，官方说明程序本体默认从 releases.openai.com 下载，失败时回退到 GitHub Releases。所以安装这一步，终端就必须能访问这些域名。没走代理时的典型表现是命令长时间没有输出，或者报连接超时。先让终端走代理再安装，做法见下文。

## Codex 怎么登录：浏览器授权、回调端口与登录失败

第一次运行 codex 时，选择用 ChatGPT 登录，浏览器会打开授权页面，完成后自动回到终端。相关命令来自官方的认证文档：

codex login # 浏览器登录，默认方式 codex login status # 查看当前登录方式 codex logout # 退出登录

用 API 密钥登录：

printenv OPENAI_API_KEY | codex login --with-api-key

这个登录流程有几个和网络相关的细节，值得单独说。

**回调端口 1455。** 浏览器授权完成后，会跳转到本机的 localhost:1455，把结果交还给终端里的 Codex。这一跳是本机内部的访问，不应该经过代理。如果你的浏览器代理扩展把所有地址都转发给代理，包括 localhost，这一步就会失败，表现为网页显示无法连接，终端一直等待。解决办法是在代理扩展里把 localhost 和 127.0.0.1 设为直连，或者登录时临时改用系统代理加规则模式。

**浏览器和终端要走同一个出口。** 网页授权走浏览器的代理，令牌交换走终端的代理。两边出口地区不一致，或者终端根本没走代理，会出现网页显示成功、终端却报错的情况。

**在远程机器或没有浏览器的环境登录。** 官方文档给了三种办法：

1. 设备码登录：codex login --device-auth。文档标注为测试功能，并且需要先在 ChatGPT 的安全设置或工作区权限里启用设备码登录。
2. 在有浏览器的电脑上登录好，把凭据文件复制到远程机器的相同路径。
3. 用 SSH 转发回调端口，再在这个会话里运行 codex login，把打印出来的地址放到本地浏览器打开：

ssh -L 1455:localhost:1455 user@remote

**凭据存放位置。** 登录信息缓存在 ~/.codex/auth.json，或者操作系统的凭据存储里。官方文档的原话是把这个文件当作密码对待，因为里面是访问令牌。

## 用 API 密钥登录时要注意什么

不用 ChatGPT 账号、改用 API 密钥的人，多出几件事要留意：

- **密钥在 OpenAI 平台账号里创建，按用量计费。** 充值、账单和用量上限都在平台页面设置，以官方当前说明为准。
- **请求发往 OpenAI 的 API 域名。** 它在 openai.com 后缀下，下文分流规则里的那一条已经覆盖。
- **API 同样有支持地区的要求。** 出口不在支持地区时，请求会直接被拒绝，和网页版的道理一样。
- **两种方式都配置过时，先确认当前用的是哪一种。** 运行 codex login status 查看，避免以为在用订阅额度，实际在按量扣费。
- **密钥只放在环境变量或系统凭据里。** 不写进项目文件，怀疑泄露就在平台上删除并重建。

## Codex 代理设置：TUN 模式或环境变量

Codex CLI 和所有命令行程序一样，默认不读系统代理。本文更新时，官方文档里没有专门的代理配置页面，所以下面两种办法里，第一种更有保证。

**办法一：TUN 模式。** 打开代理客户端的 TUN 模式，由虚拟网卡在网络层接管全部流量，Codex 不需要任何配置，它在执行任务时调用的 git、包管理器等工具也一并走代理。这是对程序自身代理支持没有任何依赖的做法，原理见 [规则、全局与 TUN 模式](https://jichanggege.mom/jiaocheng/fenliu-tun/)。在 Clash Verge Rev 里的开启位置见 [Clash Verge Rev 使用教程](https://jichanggege.mom/jiaocheng/clash-verge-rev/)，TUN 打不开见 [TUN 模式开不了](https://jichanggege.mom/paicha/tun-kaibuqi/)。

**办法二：环境变量。** 多数命令行程序会读取标准的代理环境变量，在启动 codex 之前设置。端口换成你客户端显示的混合端口，7890 只是示例：

export HTTP_PROXY=http://127.0.0.1:7890 export HTTPS_PROXY=http://127.0.0.1:7890 export NO_PROXY=localhost,127.0.0.1 codex $env:HTTP_PROXY = "http://127.0.0.1:7890" $env:HTTPS_PROXY = "http://127.0.0.1:7890" $env:NO_PROXY = "localhost,127.0.0.1" codex

三点说明：

- 优先用 http:// 开头的 HTTP 代理地址，而不是 SOCKS 地址。Clash 系客户端的混合端口同时提供两种协议，填 HTTP 即可。
- NO_PROXY 那一行是为了让登录回调的本机访问不走代理。
- 环境变量方式是否对 Codex 的所有连接都生效，取决于具体版本，官方没有书面承诺。设置之后仍然连不上，不要反复折腾变量，直接换成 TUN。

更完整的终端代理写法，包括 Git、npm、Docker 各自的配置，见 [终端、Git、npm、Docker 走代理](https://jichanggege.mom/jiaocheng/zhongduan-daili/)。在 WSL 里使用时，127.0.0.1 指向的是 WSL 自己，需要在 Windows 侧开 TUN，或者把代理地址换成 Windows 主机的地址并允许局域网连接，见 [局域网共享代理](https://jichanggege.mom/jiaocheng/juyuwang-gongxiang/)。

## Codex 用什么节点：地区、IP 类型与分流规则

Codex 用的是 OpenAI 的账号体系，网络要求和 ChatGPT 一致：

- **地区。** 出口 IP 要在 OpenAI 支持的国家和地区内，名单以官方帮助中心为准。香港节点通常不可用，原因见 [香港节点适合做什么](https://jichanggege.mom/zhishi/xianggang-jiedian/)。
- **IP 类型。** 共享的机房 IP 更容易被限流或要求验证，标注原生 IP 或家宽 IP 的节点一般更稳，但倍率更高。这些都是机场的官方标注，本站未验证。概念见 [机房 IP 与 AI 风控](https://jichanggege.mom/zhishi/jifang-ip/)。
- **固定节点。** Codex 的任务是长连接，一次可能跑很久。策略组用手动选择，不要用自动测速或负载均衡。

分流规则把 OpenAI 相关域名放进同一个手动选择的策略组。如果订阅已经自带 AI 或 OpenAI 策略组，直接给它选节点即可；否则参考下面的示意，节点名换成订阅里真实存在的名称：

proxy-groups: - name: AI type: select proxies: [美国节点甲, 日本节点乙] rules: - DOMAIN-SUFFIX,openai.com,AI - DOMAIN-SUFFIX,chatgpt.com,AI - DOMAIN-SUFFIX,oaistatic.com,AI - DOMAIN-SUFFIX,oaiusercontent.com,AI

Codex 执行任务时还会访问 GitHub、npm 源、PyPI 等开发常用站点。这些不必和 AI 走同一个节点，但要保证它们能连上，否则会出现模型正常回复、安装依赖却卡住的情况。网页版 ChatGPT 和 Codex 最好共用同一个出口，避免同一账号同时出现在两个国家。整体思路见 [AI 工具的网络环境怎么配](https://jichanggege.mom/ai/wangluo-huanjing/)。

## Codex 怎么用：第一次任务与常用命令

网络和登录都通了以后，进入项目目录运行 codex，用自然语言描述任务即可。它会读文件、给出修改方案，按你设置的批准方式改文件和运行命令。常用的入口如下，会话里输入 / 会列出当前版本支持的命令，不同版本略有差异，以实际显示为准：

| 用法 | 作用 |
| --- | --- |
| codex | 在当前目录启动交互式会话 |
| codex "任务描述" | 启动时直接带上第一条任务 |
| codex exec "任务描述" | 非交互方式运行一次，适合放进脚本 |
| codex resume | 继续之前的会话 |
| /model | 切换模型，可选范围取决于账号套餐 |
| /init | 生成一份给 Codex 看的项目说明文件 |
| /status | 查看当前账号、模型和会话状态 |
| /diff | 查看本次会话改动了哪些文件 |
| /new、/compact | 开新会话、压缩过长的上下文 |

上手建议：

- **在 git 仓库里用。** 每次让它动手之前先提交一次，改坏了能回退。
- **写一份项目说明。** 用 /init 生成后，补上构建命令、测试命令和代码风格约定，它之后会照着执行。
- **批准方式从严到松。** 刚开始让它每次运行命令都先问你，熟悉之后再按官方文档放宽。
- **任务描述具体。** 写清楚要改什么、不能动什么、改完怎么验证，比笼统地说「优化一下」有效得多。

## Codex 和 Claude Code 有什么区别

两者都是终端里的编程助手，用法相近，差别主要在账号和网络：

| 对比 | Codex CLI | Claude Code |
| --- | --- | --- |
| 账号 | ChatGPT 账号或 OpenAI API 密钥 | Claude 付费套餐或 Console 账号 |
| 地区名单 | OpenAI 支持名单 | Anthropic 支持名单，另有手机号验证门槛 |
| 登录回调 | 本机 1455 端口 | 浏览器授权后回到终端，或粘贴代码 |
| 代理 | 环境变量或 TUN，官方没有专门的代理文档 | 官方写明支持 HTTPS_PROXY，不支持 SOCKS |

已经有 ChatGPT 订阅的，用 Codex 不需要另外注册账号；已经在用 Claude 的，看 [Claude Code 使用教程](https://jichanggege.mom/ai/claude-code/)。更习惯在编辑器里写代码的，也可以看 [GitHub Copilot 使用教程](https://jichanggege.mom/ai/copilot/)。各家的套餐和功能更新很快，以官方说明为准。

## 节点地区怎么判断合不合适

浏览器里能用 ChatGPT，只能说明浏览器那条路是通的。给 Codex 挑节点要在终端里验证：

1. **终端出口和浏览器一致。** 在终端里用 curl 访问任意查询出口 IP 的服务，地区要在 OpenAI 支持名单内，并且和浏览器查到的相同。
2. **能连上服务。** 运行 curl -I https://chatgpt.com，能返回响应头即可。
3. **登录状态正常。** codex login status 显示已登录。
4. **跑一个小任务。** 让它解释一个函数或补一段注释，确认往返正常。
5. **跑一个长任务。** 让它做一件需要读多个文件、运行几次命令的事，观察中途有没有断开重连。
6. **晚高峰复测。** 长任务在晚上也能稳定跑完，这个节点才值得固定。

| 现象 | 判断 | 处理 |
| --- | --- | --- |
| 终端查到的地区和浏览器不同 | 终端没走代理，或走了另一个策略组 | 开 TUN，或检查环境变量 |
| 小任务正常，长任务中途断开 | 节点或线路不稳，或策略组在自动切换 | 固定节点，换线路对比 |
| 频繁要求重新登录 | 出口地区在变，或凭据文件被清理 | 固定节点，检查 .codex 目录 |
| 白天晚上都稳定 | 合适 | 固定使用，同地区备一个 |

## 连接失败的排查顺序

按从外到内的顺序排查，每一步都能明确排除一类原因。

1. **代理客户端是否正常。** 浏览器打开 chatgpt.com，能正常进入对话页面，说明节点和账号没有问题，问题在终端这一侧。
2. **终端是否走了代理。** 运行下面的命令。能返回 HTTP 响应头就说明终端到 OpenAI 是通的，状态码是多少不重要；超时或连接被重置，说明终端的流量没有进入代理。

curl -I https://chatgpt.com

1. **出口地区是否正确。** 在同一个终端里用任意查询出口 IP 的服务确认地区。浏览器和终端查到的结果应该一致。
2. **规则是否命中。** 到代理客户端的连接页面，看来自 codex 进程的请求走了哪个策略组、哪个节点。
3. **登录状态。** 运行 codex login status。凭据失效就先 codex logout 再重新登录。
4. **节点稳定性。** 能连上但任务中途频繁断开，是节点质量问题，换一个同地区节点对比，见 [节点超时怎么办](https://jichanggege.mom/paicha/jiedian-chaoshi/)。

| 现象 | 多半的原因 | 处理 |
| --- | --- | --- |
| 安装脚本没反应或超时 | 终端没有走代理 | 先设置环境变量或开 TUN 再安装 |
| 浏览器授权后页面显示无法连接 localhost | 回调被代理扩展转发，或在远程机器上登录 | localhost 设为直连，或用端口转发、设备码登录 |
| 网页授权成功，终端报错 | 终端没走代理，或出口地区与浏览器不同 | 统一出口，优先用 TUN |
| 提示所在国家或地区不支持 | 出口 IP 不在支持地区 | 换节点 |
| 请求过多或被限流 | IP 被共用过度，或账号额度用尽 | 换同地区节点；额度问题只能等待，见 [ChatGPT 提示请求过多](https://jichanggege.mom/paicha/chatgpt-too-many-requests/) |
| 任务跑到一半反复重连 | 节点抖动，或策略组在自动切换 | 固定节点，避开晚高峰不稳的线路 |
| 模型正常，安装依赖失败 | GitHub、npm 等站点没走代理 | 开 TUN，或为对应工具单独配置代理 |
| 报错里带有 stream disconnected 一类字样 | 流式连接在回答完成前断开 | 多见于节点抖动或出口切换，固定节点后重试 |
| 提示未授权或令牌无效 | 登录凭据过期或被撤销 | codex logout 后重新登录 |
| 提示用量达到上限 | 套餐额度用完 | 与网络无关，等待重置或按官方页面处理 |

## 账号安全注意事项

- **保护 auth.json。** 不要发给别人，不要提交进仓库，不要放进公开的网盘或聊天记录。换电脑或怀疑泄露时，先 codex logout，再到账号的安全设置里检查登录设备。
- **API 密钥不落盘到项目里。** 用环境变量传入，并确认 .env 之类的文件在 .gitignore 里。
- **不要共享账号。** 一个 ChatGPT 账号在多个国家的机器上同时跑 Codex，是典型的风控场景。
- **只用官方安装渠道。** 第三方打包的"中转版""免登录版"会经手你的代码和令牌。
- **看清权限提示。** Codex 会在本机执行命令，批准模式和沙箱设置按官方文档理解清楚再放宽，重要仓库先提交一次再让它动手。

不同国家和地区的规定不同，请遵守当地法律和服务条款。

## Codex 配置文件与 AGENTS.md：让它按项目规矩干活

结论：Codex 的行为由两类文件决定，一类是用户目录下的配置文件，管模型、批准方式、沙箱和外部工具；另一类是项目里的 AGENTS.md，管这个项目怎么构建、怎么测试、有哪些约定。

**配置文件。** 官方文档里的位置是用户目录下 .codex 文件夹中的 config.toml，登录凭据也在这个文件夹里。常改的项有默认模型、批准方式、沙箱模式，以及接入外部工具的设置。字段名称会随版本调整，写之前对照官方配置文档，不要照抄网上的旧配置。需要在不同场景切换整套设置的，可以按官方文档定义多个配置档，启动时指定使用哪一个。

**AGENTS.md。** 这是写给 Codex 看的项目说明，放在仓库根目录，/init 生成的就是它。官方说明它可以分层：用户级的一份写个人通用习惯，仓库根目录写项目约定，子目录里还能再放一份写局部规则，越靠近当前目录的越具体。建议写进去的内容：

| 写什么 | 举例 |
| --- | --- |
| 构建和测试命令 | 安装依赖、运行测试、代码检查分别用哪条命令 |
| 代码风格 | 命名习惯、格式化工具、注释语言 |
| 不能动的地方 | 自动生成的目录、数据库迁移文件、第三方代码 |
| 提交习惯 | 提交说明的格式，改完是否必须跑测试 |
| 环境说明 | 需要走代理才能拉取依赖的，写明代理已由 TUN 接管，不要在命令里另加代理参数 |

AGENTS.md 会被提交进仓库，团队成员都能看到，所以不要在里面写密钥、内网地址和个人信息。

## Codex 沙箱与批准方式：权限怎么放

结论：新手用「工作区可写加按需批准」的组合，Codex 能改项目里的文件，但运行命令和访问网络前会问你；完全放开的模式只在一次性的隔离环境里用。

官方把权限拆成两部分：沙箱决定它在技术上能碰到什么，批准方式决定什么时候停下来问你。下表是常见组合的含义，具体的模式名称和默认值以官方文档和 /status 的显示为准。

| 沙箱 | 能做什么 | 适合 |
| --- | --- | --- |
| 只读 | 只能读文件，不能改 | 先让它熟悉一个陌生项目、只想要分析报告 |
| 工作区可写 | 能改当前项目目录里的文件，项目外和网络受限 | 日常写代码，推荐的默认选择 |
| 完全访问 | 不做限制 | 只在容器、虚拟机等用完即弃的环境里用 |

和代理相关的一点：沙箱可能限制命令访问网络，这时它运行 npm install、pip install 一类命令会失败，看起来像代理坏了，其实是权限没放开。遇到依赖安装失败，先看它是不是在请求联网权限，再查代理。

## 在脚本和 CI 里用 codex exec

结论：codex exec 适合把固定的检查或修改任务放进脚本，但在 CI 里要用 API 密钥而不是个人 ChatGPT 账号，并且权限收到最小。

1. **密钥放进 CI 的密钥管理。** 在流水线的加密变量里存 OpenAI API 密钥，以环境变量传给 Codex，不要写进仓库或日志。
2. **不要把个人账号凭据复制到服务器。** 把 auth.json 拷到共享的构建机上，等于把账号交给所有能登录那台机器的人。
3. **CI 机器的出口也要在支持地区。** 构建机在不支持的地区时，它自己要走代理，和你本机开没开代理无关。
4. **限定权限。** CI 里一般只需要读代码、输出建议或生成补丁，用只读或工作区可写，不要用完全访问。
5. **输出给人看。** 让它的结果以评论或补丁的形式交给人审核，不要直接推送到主分支。

## 常见问题

### Codex CLI 怎么安装？

macOS 和 Linux 运行 curl -fsSL https://chatgpt.com/codex/install.sh | sh，也可以用 npm install -g @openai/codex 或 brew install --cask codex。Windows 有官方的 PowerShell 安装脚本，也可以装在 WSL2 里。命令以官方仓库为准。

### Codex 免费吗，需要 ChatGPT Plus 吗？

Codex CLI 本身开源免费，但调用模型要消耗账号额度。官方说明推荐用 ChatGPT 账号登录，列出的套餐包括 Plus、Pro、Business、Edu、Enterprise；也可以改用 API 密钥按量计费。免费账号是否可用、各套餐额度多少，以官方页面的当前说明为准。

### Codex 登录时浏览器显示无法访问 localhost 1455，怎么办？

这是授权完成后回调本机端口失败。检查浏览器代理扩展是否把 localhost 也转发给了代理，把它设为直连。如果是在远程服务器上登录，用 SSH 转发 1455 端口，或者使用设备码登录。

### 浏览器能用 ChatGPT，Codex 却连不上，为什么？

浏览器读取系统代理，命令行程序不读。打开代理客户端的 TUN 模式，或者在启动 codex 之前设置 HTTP 代理环境变量。

### Codex CLI 怎么设置代理？

官方文档目前没有专门的代理配置说明。通用做法是设置 HTTP_PROXY 和 HTTPS_PROXY 环境变量，地址用 http:// 开头；不生效时改用 TUN 模式，它不依赖程序自身的代理支持。

### Codex 用哪个地区的节点？

和 ChatGPT 一样，选 OpenAI 支持地区内的节点，机场里常见的是美国、日本、新加坡、台湾。选定之后固定使用，网页版和命令行共用同一个出口。

### 用 Codex 一个月要多少流量？

很少，主要是文本传输，再加上任务里拉取依赖的流量。一般每月几个 GB 以内。选机场时更应该关心节点的地区和稳定性，候选见 [AI 用机场怎么选](https://jichanggege.mom/tuijian/ai/)。

### 用 Codex 网页上的云端任务，也要配终端代理吗？

不需要。云端任务在 OpenAI 的服务器上运行，你这边只要浏览器能正常打开页面。终端代理只和本机运行的 CLI、IDE 扩展有关。两者共用一个账号，网页和终端的出口地区保持一致即可。

### Codex 的配置文件在哪里？

官方文档写的是用户目录下的 .codex 文件夹，配置文件名为 config.toml，登录凭据 auth.json 也在同一个文件夹里。配置项的名称以官方配置文档的当前版本为准。

### AGENTS.md 是什么，必须写吗？

它是写给 Codex 的项目说明文件，不是必须的，但写了之后它会按你的构建命令、测试命令和代码约定工作，返工明显减少。可以先用 /init 生成，再手动补充，写法见上文配置一节。

### Codex 安装依赖总是失败，是代理的问题吗？

不一定。先确认终端能连上 npm、PyPI 等站点；如果能连上，再看是不是沙箱限制了命令联网，它会请求联网权限，批准后再试。两者都排除了，才去换节点。

## 接着读

Gemini

### Gemini 使用教程（2026）：国内怎么用、AI Studio 与地区限制

Gemini 使用教程：Gemini 怎么用、国内怎么用、Google AI Studio 怎么用、提示地区不支持怎么办。Gemini 应用和 AI Studio 是两份不同的官方地区名单，判断依据除了出口 IP 还有账号地区。本文讲官方入口、API 密钥申请、节点验证与报错处理。

阅读 → Cursor

### Cursor 使用教程（2026）：国内下载安装、代理设置与模型不可用

Cursor 使用教程：Cursor 怎么用、国内怎么下载安装、代理怎么设置、模型不可用怎么办、怎么设置中文。只从官网 cursor.com/download 下载，讲系统代理与 TUN、Network 页的 HTTP 兼容模式与诊断、节点地区验证，以及模型列表缺模型的原因。

阅读 → Copilot

### GitHub Copilot 使用教程（2026）：免费版、国内代理设置与连不上排查

GitHub Copilot 使用教程：Copilot 怎么用、免费版和学生认证怎么开、国内怎么设置代理、连不上怎么办。讲 GitHub 官网订阅入口、VS Code 与 JetBrains 的安装登录和代理路径、节点延迟怎么判断、和 Cursor 的区别，以及官方测试命令排查法。

阅读 →
