# ChatGPT 与 Codex

和 2api 配置有关的报错（401、stream disconnected、反复 Reconnecting 等）见 [Codex 常见问题](https://docs.2api.dev/faq/codex/)。

## 套餐和账号

### 代充后还是显示免费版

1. 确认登录的是代充时提交的那个账号，登录方式也一样。用了 Apple 的「隐藏邮件地址」或者换了登录方式，进的可能是另一个账号。
2. 退出登录再登录。多台设备都登录着的话，每台都重新登录。
3. 等几分钟再刷新。
4. 还不行，带上账号邮箱和代充时间[联系客服](https://docs.2api.dev/support/)。

### 用量用完了

Work 和 Codex 的用量用完后要等重置，重置时间在[用量页面](https://chatgpt.com/codex/settings/usage)能看到。Plus 和 Pro 也可以另买 credits 接着用，详见 [Plus 与 Pro](https://docs.2api.dev/guides/plans/#用量限额)。有 2api 余额的话，也可以[用 magpie 切到 2api](https://docs.2api.dev/magpie/#和-chatgpt-订阅一起用)。

### 收到「可疑活动」提醒，或者被要求重新验证

同时在很多地方登录、频繁切换网络、几个人共用一个账号，都容易触发安全检查。建议：

- 改一次密码，所有设备会陆续退出登录，之后重新登录。
- 在设置的「安全」里打开两步验证。
- 不要和别人共用账号。这违反 OpenAI 的使用条款，也最容易出问题。

### 收不到邮箱验证码

- 重新获取一次，只用最新收到的那个验证码。
- 看看垃圾邮件文件夹。
- 把 openai.com 结尾的发件地址加进邮箱白名单。

### 点了「忘记密码」收不到邮件

用 Google、Microsoft 或 Apple 注册的账号可能没有密码，继续用当初的方式登录。

## 下载安装

### 电脑版找不到 Codex 了

2026 年 7 月起，Codex 并入了新版 ChatGPT 桌面版。打开新版 ChatGPT，在左上角的下拉菜单里选「Codex」。打开的如果是「ChatGPT Classic」，那是旧版，没有 Codex，按[下载与安装](https://docs.2api.dev/guides/install/#桌面版)装新版。

### Microsoft Store 里下载失败

1. 按 `Win+R`，运行 `wsreset` 清掉商店缓存，再下载一次。
2. 还不行，在 PowerShell 里用命令安装：

   ```powershell
   winget install --id 9PLM9XGG6VKS -s msstore
   ```

不要从网盘或第三方网站下载安装包。

### App Store 里搜不到 ChatGPT

ChatGPT 的 iOS App 没有在中国大陆、香港和澳门的 App Store 上架。可以先用网页版：在 Safari 里打开 chatgpt.com，点「分享」→「添加到主屏幕」。只从官方的 App Store 页面下载，开发者是 OpenAI OpCo, LLC，名字相近的 App 很多是仿冒的。

### Android 上装不了或打不开

ChatGPT 的 Android App 只在 Google Play 提供，需要 Android 7.1 或更新的版本，并且要有 Google Play 服务。提示需要更新 Google Play 的，先把 Google Play 服务更新到最新版。不要从第三方网站下载 APK。

### 编辑器插件里找不到 Codex 图标

- 确认装的是发布者为 OpenAI、ID 为 `openai.chatgpt` 的插件。
- 按 `Ctrl+Shift+P`（macOS 是 `Cmd+Shift+P`），运行 **Codex: Open Codex Sidebar**。
- Cursor 的图标可能藏在活动栏的「更多」里，拖出来固定住。

### 编辑器插件一直在登录或转圈

- 完全退出编辑器再打开，重新点「Sign in with ChatGPT」。
- 还不行，备份并删除 `~/.codex/auth.json`，再重新登录。
- Windows 上一直没反应，可能缺 C++ 组件，见[下载与安装](https://docs.2api.dev/guides/install/#编辑器插件vs-codecursor)。

## 登录和网络

### 登录后又跳回登录页

- 允许 chatgpt.com 和 openai.com 使用 Cookie 和 JavaScript，清掉这两个网站的缓存和 Cookie 再试。
- 广告拦截、Cookie 管理类的扩展可能让登录按钮失效，先关掉试试。
- 用无痕窗口，或者换一个浏览器。
- 确认用的是注册时的登录方式。
- 短时间内失败太多次的话，等一会儿（最长约一小时）再试。

### Unsupported country, region, or territory

也可能是 `Country, region, or territory not supported`。这是 OpenAI 的地区限制：OpenAI 判断你当前的网络位置不在它支持的范围内，账号和订阅本身没有问题。OpenAI 只在支持的国家和地区提供服务（[名单](https://help.openai.com/en/articles/7947663-chatgpt-supported-countries)），按它的说明，在其他地区使用可能导致账号被限制或停用。

如果你确实在支持的地区，却看到这个提示，官方建议清掉缓存和 Cookie，换个浏览器或用无痕窗口再试；还不行就联系 [OpenAI 支持](https://help.openai.com)。

### Something went wrong / A network error occurred

1. 刷新页面，或者新开一个对话。
2. 看看 [status.openai.com](https://status.openai.com)，是不是 OpenAI 那边出了故障。
3. 清掉缓存和 Cookie，或者用无痕窗口。
4. 关掉浏览器扩展。代理、VPN 和安全 DNS 设置也可能导致这个错误。
5. 换网络、浏览器或设备试试。

### 一直弹出人机验证

刷新页面、清掉 Cookie、关掉浏览器扩展再试。网络的出口 IP 频繁变化时，更容易反复出现验证。

### 刚登录就被登出，或者提示 refresh token was already used

退出登录再重新登录（命令行版运行 `codex logout`，再运行 `codex login`）。还反复出现的话，先把 App 或 Codex 更新到最新版。再不行，备份并删除 `~/.codex/auth.json`，重新登录。不要删 `~/.codex/sessions`，那里是历史对话。

## 使用中

### 桌面版里聊天记录不见了

- 点侧边栏「Chats」旁边的筛选图标，选「Chronological」，按时间显示全部对话。
- 还找不到，到设置里看「Archived chats」（已归档的对话）。
- 在网页版和手机上发起的对话，要在桌面版的 ChatGPT 里看；切到 Codex 时只显示 Codex 的对话。

### is not supported when using Codex with a ChatGPT account

这个模型在你的套餐里用不了，或者已经下线。用 ChatGPT 登录的 Codex 里，GPT-5.4 和 GPT-5.4 mini 在 2026 年 8 月 31 日下线，GPT-5.5 在 10 月 14 日下线。在模型菜单里（命令行版输入 `/model`）换一个列表里有的模型。

免费版和 Go 只能在桌面版里用 GPT-6 Luna，要在编辑器插件或命令行版里用 Codex，需要 Plus 或更高的套餐。

## 命令行版

只用桌面版、网页版和手机的，不用看这一节。遇到问题先运行一次 `codex doctor`，它会检查安装、配置、登录、Git 和终端，生成一份诊断报告，很多问题看报告就知道。

### command not found: codex

Windows 上是 `'codex' 不是内部或外部命令`，或者 `无法将“codex”项识别为 cmdlet、函数、脚本文件或可运行程序的名称`。

- 装完要新开一个终端，旧终端读不到新安装的程序。
- 确认真的装上了：重新运行一次[安装命令](https://docs.2api.dev/guides/install/#命令行版)，看有没有报错。

### 无法将“irm”项识别为 cmdlet

英文是 `irm : The term 'irm' is not recognized`，或者 `'irm' is not recognized as an internal or external command`。

你在 CMD（命令提示符）里运行了 PowerShell 的安装命令。按 `Win` 键，输入 `PowerShell` 打开它，再运行一次。

### 因为在此系统上禁止运行脚本

英文是 `codex.ps1 cannot be loaded because running scripts is disabled on this system`，也可能是 `npm.ps1`。

PowerShell 默认不允许运行脚本。运行下面这条命令，或者用 `codex.cmd` 代替 `codex`。详见 [Windows 上用 Codex](https://docs.2api.dev/faq/codex-windows/#powershell-禁止运行脚本)。

```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

### npm 安装报错

`npm ERR! code EACCES` 是没有权限写入系统目录，`Missing optional dependency @openai/codex-win32-x64` 是没装上 Windows 版的程序文件。都改用[官方安装命令](https://docs.2api.dev/guides/install/#命令行版)，不要加 `sudo`。

### 浏览器显示登录成功，终端一直在等

浏览器里也可能显示 `localhost 拒绝了我们的连接请求`。

浏览器要把登录结果交回本机的 `localhost:1455`，这一步被代理或端口问题挡住了。按[登录](https://docs.2api.dev/guides/login/#浏览器登录成功了终端还在等)里的顺序排查，实在不行就用设备码登录：`codex login --device-auth`。

### Token exchange failed

也可能显示 `token_exchange_failed`。浏览器那边登录成功了，但 Codex 拿登录结果换取凭证时，连不上 OpenAI 的认证服务。

- 你的电脑通过代理软件上网的话，在运行 `codex login` 的同一个终端里先设置代理，再登录。7890 换成你代理软件里显示的端口：

  ```bash title="macOS / Linux"
  export HTTPS_PROXY=http://127.0.0.1:7890 NO_PROXY=localhost,127.0.0.1
  codex login
  ```

  ```powershell title="Windows PowerShell"
  $env:HTTPS_PROXY = "http://127.0.0.1:7890"; $env:NO_PROXY = "localhost,127.0.0.1"
  codex login
  ```

- 公司网络有 TLS 代理的，设置 `CODEX_CA_CERTIFICATE`，见[公司网络和登录日志](https://docs.2api.dev/guides/login/#公司网络和登录日志)。
- 看 `~/.codex/log` 里的 `codex-login.log`，里面有具体原因。

### Sign-in could not be completed

- 确认用的是正确的账号和登录方式。
- 清掉浏览器里 chatgpt.com 和 openai.com 的 Cookie，或者换个浏览器、用无痕窗口再试。
- 改用设备码登录：`codex login --device-auth`。
- 还不行，把 `codex-login.log` 发给客服。

### 设备码登录提示不可用

先在 ChatGPT 网页版的安全设置里打开设备码登录，再运行 `codex login --device-auth`。工作区账号要请管理员在工作区权限里打开。

### 升级后启动报错，配置里有 `approval_policy = "untrusted"`

`untrusted` 这个值已经废弃，可能让 Codex 启动不了。把 `~/.codex/config.toml` 里的这一行改成 `approval_policy = "on-request"`，或者直接删掉。

### `codex exec` 不认 `--full-auto`

`--full-auto` 已经去掉了。要让 `codex exec` 改文件，改用 `--sandbox workspace-write`。

### Windows 报错 1385

Windows 策略不允许 Codex 的沙箱用户启动命令，见 [Windows 上用 Codex](https://docs.2api.dev/faq/codex-windows/#原生沙箱)。