ChatGPT（Codex）接入常见问题

接入或使用过程中遇到报错，可先对照以下情况排查。客户端升级后界面可能显示为 ChatGPT，配置仍走 `~/.codex/config.toml` 自定义 Provider。

找不到 / 打不开 config.toml

**Desktop**：设置 → 配置 → 打开 config.toml。按钮无反应时，改用手动路径，并确认 `.toml` 已关联记事本 / VS Code / Cursor。 | 系统 | 路径 | |------|------| | macOS | `~/.codex/config.toml` | | Windows | `%USERPROFILE%\.codex\config.toml` | | Linux | `~/.codex/config.toml` |

显示「正在重新连接 N/5」

通常是用了 `openai_base_url`。Desktop 会尝试连接 chatgpt.com，在无法访问时反复重连。请改为自定义 Provider：根级写 `model_provider = "ca_gateway"`，Token 写在 `experimental_bearer_token`，不要用 `openai_base_url`。

一直 Thinking / 无响应，网关没有请求

通常是把 `model_provider` 写在了 `[desktop]` 等表头**后面**。TOML 会把它解析成 `desktop.model_provider`，根级无效，客户端回落到默认 `openai`。 请把 `model` / `model_provider` 等键挪到文件**最前面**（`notify` 之后、任何 `[table]` 之前），保存后完全退出再开，并新建对话。

Missing environment variable

通常是用了 `env_key`。Desktop 进程通常没有该环境变量。请改用 `experimental_bearer_token`，把 Token 直接写进 `config.toml`。

提示 401 / Token 无效

通常是用户 Token 错了。回到 CodePass 用户中心重新复制 128 位 Token，粘贴到 `experimental_bearer_token`。不要手打。

提示 404

通常是 `base_url` 填错了。正确格式（末尾**必须**带 `/v1`，与 Claude 不同）： 且 `wire_api` 必须为 `responses`。

提示 provider 不存在

检查根级 `model_provider = "ca_gateway"` 是否与段名 `[model_providers.ca_gateway]` 一致。

改完配置不生效

1. 先确认 `model_provider` 在文件**根级**（不在 `[desktop]` 里） 2. 再**完全退出**客户端重开：macOS 用 `Cmd + Q`；Windows 右键托盘图标退出 3. 仅关窗口不够；建议新建对话再验证

长推理时显示「正在重新连接」但实际未断

多为客户端流空闲超时过短。确认 `config.toml` 中： 保存后完全退出再打开。

提示额度不足

Codex 会消耗 CodePass 的共用 API 额度池。额度不足时，需续费 Pass 或购买加油包。

529 或提示并发已满

同时进行的会话数超过上限。等待当前会话完成后重试；通常几秒内自动恢复。

503 上游暂时不可用

资源排队超时或上游繁忙。稍后重试；如持续出现请联系管理员。

模型响应慢或超时

先检查本机网络，再稍后重试。也可先用 curl 验证网关可达： 预期：`HTTP 200` + 正常响应内容。