Codex常见问题 on 逍遥笔记

Codex 卡住、提交消息失败或一直无响应，先按这 5 步排查

Fri, 18 Sep 2026 12:50:00 +0800

联系逍遥

扫码添加微信，或点击下方按钮复制联系方式。

先区分三种“卡住”

等待审批/工具结果：界面有等待确认、运行命令或写文件的提示。它不是网络断线，先完成或拒绝审批。
正在重连或服务端等待：能看到 Reconnecting、429、503 等字样。按重连排查和错误码表处理。
本地界面/会话状态异常：按钮无反应、提交失败、窗口卡白，但新会话可以工作。先保留输入和工作目录，不要直接清空配置。

五步快速排查

先看是不是在等审批：工具调用、文件写入或网络访问可能停在等待确认；完成或拒绝后，回到会话观察是否继续。若没有任何审批提示，再继续下一步。
验证本地终端和磁盘：开一个新的终端窗口，运行 pwd、git status，并确认磁盘没有满。如果命令本身都卡住，先处理终端、磁盘、权限或网络，不要重复发送同一条消息。
用短请求和新会话做对照：先发一句不涉及代码的短问题。短请求能返回，通常是原任务上下文过大、某个工具调用或项目文件导致；短请求也失败，才更像连接、登录或服务端问题。新会话正常不代表旧任务已完成，先保存原任务内容。
更新并完全重启：保存未发送的文字，升级到稳定版本，退出应用（不是只关窗口）后再打开。仍无响应时切换到新会话测试。不要因为界面暂时空白就删除 .codex 目录，也不要先删 auth.json。
最后再看日志并做最小复现：macOS 日志通常在 ~/Library/Logs/com.openai.codex/YYYY/MM/DD，会话记录在 $CODEX_HOME/sessions。记录“打开应用 → 进入项目 → 发送短请求 → 卡住”的时间线，能帮助判断是界面、项目还是网络问题。

什么时候可以重试，什么时候应停止

只有一次短暂超时：等待后重试一次即可。
连续出现相同的 429/503：停止连点，按 Retry-After 或逐步退避等待；继续狂点只会延长限流。
官方会话和中转都失败：先检查网络、系统时间、代理和状态页，再考虑登录/配置问题。
只有一个项目卡住：用空目录或新会话做对照，检查项目是否有巨大的日志、递归目录或异常 MCP/脚本；不要先删除项目文件。

如果错误是反复 Reconnecting，可先看这篇连接排查。如果是 capacity、429 或 503，按常见报错表处理。持续失败时，向 OpenAI 帮助中心提供完整错误、客户端版本、模型、时间和请求 ID；分享日志前删掉代码、路径、邮箱、token、API Key、代理密钥和 auth.json 内容。

参考：Codex 故障排除。

Codex 常见报错怎么处理：capacity、429、503、usage_limit 一次看懂

Fri, 18 Sep 2026 12:40:00 +0800

联系逍遥

扫码添加微信，或点击下方按钮复制联系方式。

同样是“发不出去”，原因可能完全不同。先看完整报错、HTTP 状态和 error.code，再决定怎么处理；不要看到一个 429 就一律等，也不要看到 capacity 就马上换账号。

提示	常见原因	建议
提示/状态	常见原因	先做什么
—	—	—
`Selected model is at capacity`	目标模型当前没有足够容量；常见于模型瞬时拥堵	等几分钟，换一个可用模型，查看状态页。如果所有模型长期失败，再检查账号/工作区并联系支持；不能仅凭这句话断言账号没问题或一定被标记。
`server_is_overloaded`（通常为 `503`）	模型或服务端暂时过载	有 `Retry-After` 就按它等待；没有时逐步拉长间隔，并查看状态页。
`429 Too Many Requests`、`rate_limit_error`	请求太密、并发过高、Token 突然增长，或同一组织的其他程序也在用额度	降低并发，停止重复点击；按 `Retry-After` 等待，没有时用逐渐加长的退避，只重试有限次数。
`429` + `slow_down`	流量增长过快，即使还没达到每分钟上限也可能触发	让请求速率稳定下来，等一段时间后再逐步恢复，不要短时间内把并发重新拉满。
`429` + `credit_balance_exhausted`	API 预付余额耗尽	补充余额；单纯等待不会恢复。
`429` + `project_spend_limit_exceeded` / `organization_spend_limit_exceeded`	项目或组织支出上限	让管理员调整对应限额，或等账期恢复；先确认是哪个项目在发请求。
`429` + `organization_usage_limit_exceeded`	组织用量上限达到	联系组织管理员或 OpenAI 支持申请更高的用量上限。
`usage_limit_reached`	ChatGPT/Codex 计划周期内的使用量达到上限	查看 Codex 用量页面或提示中的 reset 时间，按页面提供的等待、加额度或升级选项处理；支持团队通常不会人工提前重置周期额度。
`server_unavailable`、`503 Service Unavailable`	服务暂时不可用、网络出口异常，或客户端重试已耗尽	先确认状态页、网络和代理，再按退避规则重试；不要无限循环。
`exceeded retry limit`	客户端已经用完本次请求的重试次数	它不是新的根因，回看它前面的最后一个 `429`、`503`、超时或连接错误。

另外，401/403 更像是登录、权限、组织/项目或地区设置问题：官方登录先运行 codex login status，API 则检查 Key、组织和项目；不要先反复换网络。400 往往是参数、模型名或接口格式不对；500 是服务端内部错误，短暂等待并查状态页即可。

一个简单的判断流程

看 HTTP 状态和 error.code，不要只看界面上一行摘要。
401/403 先查登录和权限；429 先区分限流、余额和组织/项目上限。
503、server_is_overloaded 或 capacity 先等、换模型、查状态页；不要因为一次过载就重装客户端。
只有在等待和退避后仍失败，才做网络/代理对照，并尝试新会话。

向支持反馈时记录模型、客户端版本、请求时间和时区、完整错误、HTTP 状态、error.code、请求 ID（如有）、是否换模型/网络后恢复。反馈时删掉 API Key、auth.json、OAuth/access token、代码和代理密钥。官方建议对于限流遵守 Retry-After，并限制重试次数；账单、余额和用量错误不能靠继续重试解决。

官方说明：错误代码｜速率限制｜Codex 用量。

Codex 官方订阅和中转怎么切换？手改配置与 CC-Switch 说明

Fri, 18 Sep 2026 12:30:00 +0800

联系逍遥

扫码添加微信，或点击下方按钮复制联系方式。

先分清三件事：订阅、API、真正的中转

方式	凭据/计费	失败时先看什么
ChatGPT 官方登录	浏览器登录的账号或工作区；受计划、用量和重置时间影响	`codex login status`、账号/工作区用量
OpenAI API	API Key；按组织/项目的余额、限额和速率计费	Key、项目、余额、`429`/`usage` 错误
第三方中转	服务商自己的 Key、模型、限流和日志	中转文档、接口兼容性、服务商状态

API Key 或中转不是“把 ChatGPT 订阅搬到另一个地址”。三者的会话、历史、权限和账单彼此独立。CLI 中可用 codex login status 查看当前官方登录，用 codex logout 清除本机保存的官方登录；不要为了切到 API 就把 auth.json 发给别人。

CC-Switch 能不能用

CC-Switch 是第三方工具，不是 OpenAI 官方产品。只从其官方仓库或 Releases 下载。一般流程是：备份 ~/.codex 配置 → 添加提供商 → 填写服务商要求的地址、模型和 Key → 激活 → 完全重启 Codex → 发短请求验证。工具只是帮你改配置，不会替你解决服务商不兼容、额度或封禁问题；激活后仍要检查实际请求地址和模型。

中转服务通常能看到你发送的代码、提示词和请求元数据，计费、留存、审计和兼容性也由它决定。不要把 OpenAI OAuth/access token、~/.codex/auth.json、API Key 或 Cloudflare token 粘贴进文章、截图或中转配置。生产代码先脱敏，能不用中转处理的敏感项目不要使用不明服务商。

切换后历史记录暂时看不到，通常是 provider、账号或 session 不同，不代表数据被删除；先切回原 provider、原 profile 和原工作目录检查。若官方登录正常而中转失败，优先找中转服务商；若所有方式都失败，再看网络和 OpenAI 状态。

参考：Codex 身份验证｜配置方案文件。

Codex 提示 Reconnecting 5 次，怎么处理？

Fri, 18 Sep 2026 12:20:00 +0800

联系逍遥

扫码添加微信，或点击下方按钮复制联系方式。

先给结论：5 次是重试上限，不是封号提示

Reconnecting 表示流式连接中断，Codex 正在重新建立连接。官方配置参考中，stream_max_retries 的默认值是 5，所以“重试 5 次”只说明这一次请求的连接重试用完了，不能据此判断账号被封、订阅失效或额度用完。真正要看的是最后一条错误、HTTP 状态码和是否只影响某一个模型。

先判断是哪一类

只有偶尔一次：更像 Wi-Fi、代理节点、DNS 或服务端瞬时抖动。等几十秒后重新发一次即可。
同一个模型总失败，换模型正常：优先按模型容量或临时过载处理，先换模型或查看状态页。
所有模型、所有会话都失败：再检查登录状态、代理出口、时间/证书、工作区权限和客户端版本。
一输入就重连，换网络也一样：可能是配置中的 base_url、协议或认证方式不匹配，不要盲目增加重试次数。

按顺序排查，避免反复点击

停止连点，等待一次完整重试。如果错误中有 Retry-After，至少等够该时间；没有时也不要每秒重复发送，这会把临时限流变成更严重的限流。
做一次网络对照。暂时关闭不必要的代理规则，或用手机热点测试；同时检查 DNS、系统时间、IPv6 和公司防火墙是否拦截 HTTPS/WebSocket。热点正常而家中网络失败，通常不是账号问题。
更新并完全重启 Codex。保存当前输入，升级到较新的稳定版本，退出应用（不是只关窗口）后重新打开，再用一句很短的请求测试。
检查登录和模型范围。官方登录可以运行 codex login status；API/中转则检查对应环境变量是否仍存在、模型名是否由服务商支持。只换模型就恢复时，不要先改认证文件。
只有确认是兼容端点的传输问题时，才改配置。先备份配置，改一项，重启后测试；不要同时改代理、模型和登录方式，否则无法知道是哪一步起作用。

需要 HTTP/SSE 时的配置示例

下面只适用于明确支持 OpenAI Responses API 的兼容端点。它把 WebSocket 关闭，改为 HTTP/SSE；不是所有 Codex 版本或内置提供商都支持同样的覆盖方式。

model_provider = "openai_http"

[model_providers.openai_http]
name = "OpenAI HTTP"
base_url = "https://你的兼容服务地址/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

这相当于要求该提供商使用 HTTP/SSE。注意三点：

requires_openai_auth = true 只适用于端点明确支持 OpenAI/ChatGPT 登录的情况；普通中转不要填 OAuth 登录信息。
第三方中转应按其文档使用 env_key 或环境变量密钥，不能把 API Key 直接写进公开仓库或截图。
如果服务商只支持 Chat Completions、不支持 Responses API，wire_api = "responses" 也会失败；先看服务商文档，不要靠猜。

改完后完全退出并重新打开 Codex。仍失败就删除新增配置段、恢复备份，再回到原来的配置验证。不要把 stream_max_retries 无限制调大：连接本身不通时，只会让你等更久，也可能造成重复请求。

仍然不行：这样收集信息最有用

恢复备份后，记录以下内容再提交到OpenAI 帮助中心：客户端版本、操作系统、所用模型、发生时间和时区、是官方登录还是 API/中转、最后一条完整报错、请求 ID（如果有）、换网络或换模型后的结果。可以截取错误文字，但要遮住邮箱、代码、API Key、OAuth/access token、auth.json 和中转密钥。

不要先删除整个 ~/.codex 目录，也不要把“重装、清空凭据、换多个中转”同时做掉；这些操作可能丢失本地配置和排查线索。

参考：Codex 配置参考｜OpenAI 错误代码。

Codex常见问题 on 逍遥笔记

Codex 卡住、提交消息失败或一直无响应，先按这 5 步排查

联系逍遥

先区分三种“卡住”

五步快速排查

什么时候可以重试，什么时候应停止

Codex 常见报错怎么处理：capacity、429、503、usage_limit 一次看懂

联系逍遥

一个简单的判断流程

Codex 官方订阅和中转怎么切换？手改配置与 CC-Switch 说明

联系逍遥

先分清三件事：订阅、API、真正的中转

推荐用 profile 切换

CC-Switch 能不能用

Codex 提示 Reconnecting 5 次，怎么处理？

联系逍遥

先给结论：5 次是重试上限，不是封号提示

先判断是哪一类

按顺序排查，避免反复点击

需要 HTTP/SSE 时的配置示例

仍然不行：这样收集信息最有用