Codex config.toml 修复
触发条件(症状)
- ChatGPT 桌面版报「无法加载 config.toml:Model provider
ZAI/deepseek/customnot found」 - 报「stream disconnected before completion: 模型不存在,请检查模型代码」(2026-11-04 实证)——这是智谱 API 的错误文案,含义 = provider 与 model 错配:
model_provider="ZAI"(请求发往智谱)但model=留着 deepseek 系模型代码(智谱不认识)。诊断时直接比对三要素(provider/model/base_url),不用查网络。华哥确认的准确归因:CC Switch 的「路由」开关没开时切模型,配置只写一半(provider 切了、model 没跟上)→ 错配;开路由再切即正常 - codex 掉线重连、卡死、内存拉满、对话串无法继续
- 华哥说"codex 又爆内存" / "恢复 zai" / "codex 桌面版修复好了告诉我"
根因(反复发作的元凶)
CC Switch(/Applications/CC Switch.app,华哥登录项,开机自启,常驻监听 127.0.0.1:15721)会间歇性改坏 config.toml:
| 字段 | 正确 | 被 CC Switch 改坏成 |
|---|---|---|
| model_provider | "ZAI" |
"custom" |
| [model_providers] | [model_providers.ZAI] |
[model_providers.custom](或直接删 ZAI 段) |
| base_url | https://open.bigmodel.cn/api/v1 |
http://127.0.0.1:15721/v1(代理) |
| 认证 | experimental_bearer_token = "<真实key>" |
requires_openai_auth=true + "PROXY_MANAGED" |
一键修复
bash ~/.hermes/skills/autonomous-ai-agents/codex-config-repair/scripts/fix_codex_config.sh
# 可选:带 --test 会顺带 curl 实测 key 是否有效
bash ~/.hermes/skills/autonomous-ai-agents/codex-config-repair/scripts/fix_codex_config.sh --test
脚本自动:① 备份 .bak-时间戳 → ② 从 cc-switch db 读最新智谱 key → ③ 用黄金模板写正确 ZAI 直连结构 → ④ TOML 语法验证 → ⑤(可选)实测 key。
正确 ZAI 结构(黄金模板)
model_provider = "ZAI"
model = "glm-5.3"
model_reasoning_effort = "high"
disable_response_storage = true
wire_api = "responses"
model_catalog_json = "/Users/hua/.codex/models.json"
[model_providers.ZAI]
name = "ZAI"
base_url = "https://open.bigmodel.cn/api/v1"
wire_api = "responses"
experimental_bearer_token = "<key>" # 智谱 Coding 包月 key,49 位
完整模板见 templates/config.toml.zai(key 用 __ZAI_KEY__ 占位符,脚本运行时动态填充)。
关键路径
| 项 | 路径 |
|---|---|
| config 主文件 | ~/.codex/config.toml 与 ~/系统文件夹/Codex/config.toml 是硬链接(同一 inode),写一个即可 |
| key 来源 | cc-switch db ~/.cc-switch/cc-switch.db → providers 表 id='glm' 的 api_key 字段 |
| codex CLI | /Applications/ChatGPT.app/Contents/Resources/codex(~/.local/bin/codex 是断的软链,勿用) |
| 黄金模板 | 本 skill templates/config.toml.zai |
智谱 key 现状(2026-08-29 实测,会变)
93b825...Oivb(Coding 包月,49 位)→401 过期2026-11-04 实测已恢复有效(/api/v1/models200,glm-5.3/glm-5.3-flash均真实出 token)2a7c...Whvd(个人 Pro 包月,49 位)→1113 余额不足2026-11-04 实测已恢复有效(glm-5.3 出 token 正常)- ⚠️
/api/v1/models返回 0 个模型 ≠ key 失效(套餐 key 不暴露模型列表);判活必须 POST/api/v1/responses实测出 token
YUXIN 渔芯网关形态(2026-11-04 新增)
Codex 第三种常用形态:model_provider="YUXIN" + [model_providers.YUXIN] name="渔芯网关" + base_url=https://lookforge.net/llm-gateway/openai/v1(公网域名,已替代旧的 http://127.0.0.1:18888/openai/v1)+ token yxk_ 开头 52 位。model 用网关侧别名 deepseek-flash(不在 models.json/cc-switch catalog 里,会报 "Model metadata not found" 降级警告,能跑不影响)。2026-11-04 实测:SSE 流完整 + codex exec 32k tokens 成功。诊断此形态直接 curl base_url + /responses(stream:true)看 response.completed 事件。
坑点
- CC Switch「路由」代理对 DeepSeek thinking 模型多轮对话有 bug(2026-11-04 实证):开路由走本地代理 15721 时,DeepSeek 的
deepseek-v4-pro/deepseek-flash(两个都是 thinking 模型,chat/responses 均返回 reasoning_content,关不掉 reasoning)多轮对话(tool call 循环第二轮起)会报upstream_status: HTTP 400; cause: The reasoning_content in the thinking mode must be passed back to the API——CC Switch 翻译层没把上一轮 reasoning_content 回传给 DeepSeek。绕开代理直连https://api.deepseek.com/即正常(实测直连 /responses 多轮 200 + codex exec 32k tokens 多轮通过)。修法:config.toml 改model_provider="deepseek"+ base_url 直连 + 真 key;并建议华哥关掉 CC Switch 路由开关(路由开着时切档案会把 base_url 强指回 15721 代理,再次触发此 bug)。注意:直连 chat completions 协议多轮不回传 reasoning_content 也 200(宽容),只有 responses 协议 thinking 多轮才硬要求回传。 - CC Switch 档案名字与内容可能错位(2026-11-04 实证,最隐蔽的坑):
~/.cc-switch/cc-switch.db的providers表里,档案名和settings_config内容可能完全对不上——实测「DeepSeek」档案的 config 模板是model_provider="ZAI"(智谱)、auth key 贴成智谱 key;「glm-5.3-flash」档案内容却是 YUXIN 网关。诊断「模型不存在/403」时读 db 的 settings_config 三处(config 模板的 model_provider/base_url、auth.OPENAI_API_KEY、modelCatalog),别信档案名。修法:sqlite3直接 UPDATE settings_config 换 key/模板(先cp备份 db)。CC Switch 本地代理(15721)的 key 是实时读 db、非缓存——改完 db 立即生效,无需重启代理。 - 改前必备份
.bak-时间戳(脚本已内置) - CC Switch 会反复覆盖——根治方案 A(停开机自启)已于 2026-08-30 华哥拍板执行:
osascript -e 'tell application "System Events" to delete login item "CC Switch"'。⚠️ CC Switch 的自启在 macOS「登录项」(System Events 的 login items),不在 ~/Library/LaunchAgents/ 的 plist 里(那里查不到)。app 本体保留/Applications/CC Switch.app,华哥手动打开仍可切模型。停自启不影响同事——8 个同事 agent(afu/maodou/laomo/heidou/xiaobao/quant/zhenglishi/wangcai)走各自~/.hermes/profiles/<名>/config.yaml的 MiniMax-M3(minimax-cn),玉芬走 GLM-5.3-flash,均与 CC Switch 无关。若 config 再被改坏,先查华哥是否手动打开过 CC Switch 切了模型(此时需切回 ZAI/glm-5.3),不再默认归咎于自启。 - 停自启后 config 仍可能被改(2026-08-30 晚复现新变体):CC Switch 自启已停、进程未运行时,config.toml 仍被改成
model_provider="custom"+[model_providers.custom] base_url="https://open.bigmodel.cn/api/anthropic"(anthropic 端点)+ key 整个丢失(无 experimental_bearer_token)。此变体元凶疑似 ChatGPT 桌面端自己在「模型切换」时重写 config(非 CC Switch)。遇此变体需从 ChatGPT 桌面端「模型设置」入手根治,而非反复改文件。 - 两个 config 是硬链接,别写出两个不同内容
- key 在 cc-switch db 里动态读,别硬编码进脚本(key 会过期/更换)
requires_openai_auth=true+PROXY_MANAGED是代理模式的标志——出现即被 CC Switch 改坏
🔌 codex plugin 命令事实(2026-09-14 巡检实测)
- 子命令是
codex plugin add|list|marketplace|remove,没有install/update(巡检 prompt 里写codex plugin install {name}会直接失败)。 $HOME被 cron 劫持时codex读不到真实~/.codex(plugin list 输出空),必须HOME=/Users/hua codex ...或绝对路径。codex plugin list空输出先怀疑 HOME 劫持,别误判为无插件。- 期望清单里的
github插件在所有 marketplace(openai-api-curated/openai-bundled/openai-primary-runtime)中都不存在,无法安装;computer-use不是插件而是[features] computer_use开关(应为 false 防爆内存)。chrome 可从 bundled 装:codex plugin add chrome@openai-bundled。 - 当前安装格局(15 个 enabled):bundled 4(browser/chrome/codex-app-tools/visualize)+ primary-runtime 5(documents/pdf/spreadsheets/presentations/template-creator)+ api-curated 6(superpowers/build-web-apps/coderabbit/figma/linear/sentry)。
- sentry/linear/figma 启动时报 MCP
AuthRequired(OAuth 未登录)属正常噪音,不影响 exec。
🔑 key/model 现状更新(2026-09-14 实测)
- config 里
model = "glm-5.3-flash"和-m glm-5.3都能跑通(flash: 14,621 tokens;glm-5.3: 18,748 tokens)——旧的「flash 无权限 model_access_denied」结论已过时。巡检标准要求 glm-5.3 时直接改model = "glm-5.3"即可,改前备份.bak-日期,用 Pythonopen(path,'w')原地写保硬链接。 - codex CLI 版本以 ChatGPT.app 内置为准(
/Applications/ChatGPT.app/Contents/Resources/codex --version,当前 0.148.0-alpha.15);npm standalone 最新 0.154.0 但不要单独升级,ChatGPT.app 自管。 - skills 太多会触发
Exceeded skills context budget警告并剥掉全部 skill 描述——是装 skill 过多的信号,不是 config 损坏。
修复后:同步另外两处配置描述(2026-08-30 发现)
修好 config.toml 只是第一步。还有两处「配置描述」会跟着过时,不改的话进化巡检会按旧配置误报:
- AGENTS.md 的「当前配置」段 —
~/系统文件夹/Codex/AGENTS.md与~/.codex/AGENTS.md也是硬链接(同一 inode)。「模型/Provider/备用Provider/可用工具」经常还写着上一次的 deepseek / 18888。修 config 后必须同步改这里,否则 Codex 每次启动读到的自我描述是错的。 - cron 进化任务的 prompt —
Codex 技能与插件进化(cron id5e4d0547db3d,每周一 9:00)的「### 2. 配置验证」步骤里写死了 provider/model/base_url。用cronjob action=update(传 job_id + 完整新 prompt)同步,不要直接改 jobs.json。
改硬链接文件的坑:用 Python open(path,'w') 原地写才能保持 inode(两个路径同步更新);用 patch/write_file 工具会重写文件、break 硬链接,导致两个路径内容分叉。改完 ls -li 核对两个路径 inode 是否仍相同。
同步检查命令(改完跑一遍,应无残留):
grep -rn "deepseek\|18888\|api.deepseek" ~/系统文件夹/Codex/AGENTS.md ~/.hermes/cron/jobs.json
验证清单(修完必做)
-
python3 -c "import tomllib; tomllib.load(open('~/.codex/config.toml','rb'))"语法过 - grep 确认
model_provider = "ZAI"且[model_providers.ZAI]存在 -
curl https://open.bigmodel.cn/api/v1/responses用 key 实测,返回非 401/1113 - 更轻量的 key 有效性验证:
curl https://open.bigmodel.cn/api/v1/models -H "Authorization: Bearer <key>"返回模型列表(含 glm-5.3)= key 有效 - 华哥重新打开 ChatGPT 对话串,发一条消息全链路通
停电/重启后完整修复序列(2026-08-30 停电复现验证)
停电非正常关机 → CC Switch 开机自启改坏 config → ChatGPT 主进程崩溃 → 留孤儿 crashpad_handler。按此顺序修:
- 诊断:
grep -nE "^model_provider|\[model_providers" ~/系统文件夹/Codex/config.toml(确认是否被改成 custom);pgrep -fl "ChatGPT.app/Contents/MacOS/ChatGPT"(主进程是否已崩溃) - 恢复 config(两条路选一):
- 快速:
grep -l "model_providers.ZAI\|bigmodel" ~/.codex/config.toml.bak-*找最新含 ZAI 段的备份,用 Pythonopen(path,'w')原地写回(保持硬链接,见上文硬链接坑)。比跑脚本快,且 key 直接从备份来、无需重读 cc-switch db。 - 标准:
bash .../scripts/fix_codex_config.sh(从 cc-switch db 读 key 重建)
- 快速:
- 清僵尸 crashpad_handler:主进程崩溃后
browser_crashpad_handler变孤儿(PPID=1),先ps -o pid,ppid,command -p <pid>确认 PPID=1 再kill。⚠️ 主进程还活着时 crashpad_handler 是它的崩溃监听,别杀。 - 重启桌面端:
open -a ChatGPT - 验证:
ps aux | grep "ChatGPT.app/Contents/MacOS/ChatGPT"看 RSS——稳定 ~440-460MB = 正常;暴涨到 GB 级 = OOM 循环又起(computer_use 没禁用,或 key 又失效导致 codex 反复重试卡死)。
codex 卡死/内存拉满的另一诱因 = 上游 key 失效 → codex 反复重试 → 卡死。修好 key 后内存自然恢复。
🔍 Codex "stream disconnected" 不一定是协议问题(2026-08-31 实测)
Codex 报 "stream disconnected before completion: stream closed before response.completed" 时,多半不是 SSE 协议问题,而是智谱"假成功"鉴权失败的翻译:
- 智谱对完全鉴权失败的 key 返回 HTTP 200 + body
{"code":1000, "msg":"身份验证失败。", "success":false} - Codex 客户端拿到这种"伪200"响应,会在流第一帧被服务端拒收,然后翻译成"stream disconnected"
- 不要直接假设是流式协议 bug,先做 key 鉴权诊断
多端点三角验证模板 + 判读表 + Key 长度 sanity check:见 references/***SECRET***.md。5 端点(/api/v1/responses / /api/v1/chat/completions / /api/paas/v4/chat/completions / api.z.ai/api/paas/v4/chat/completions / GET /api/v1/models)全部返 1000 = key 完全无效(账号欠费/错key/未激活),让华哥去智谱后台核对;如果长度只有 20 字符(标准 35)= 剪贴板截断,让华哥 pbpaste | wc -c 复测。
🛡️ 守护脚本过激熔断陷阱(2026-08-31 实测)
codex_memory_guard.py(每2分钟 cron 5d9df933677d,守护 computer_use 配置防爆内存)自带的熔断逻辑:
THREAD_THRESHOLD = 200 # 旧阈值——误杀
RSS_THRESHOLD_MB = 4096
# 任一超阈 → pkill -9 杀掉 ChatGPT.app 主进程 + Codex Framework
坑:正常 ChatGPT.app 26.814 版本主进程稳定在 60-220 线程 / 200-500MB RSS(macOS 自带内存压缩会触发 V8 worker 拉线程),旧阈值 200 把"健康但线程数高"的进程当病态熔断 → 主进程被杀 → ChatGPT 端 Codex CLI 立刻断流。
已修(2026-08-31):阈值调到 400 线程 / 6GB RSS,且验证脚本静默退出=健康。
复盘三步骤(华哥指令"修复 codex 爆内存 bug"后必跑):
- 先看是否真爆内存(不要无脑跑守护脚本):
pid=$(pgrep -f 'ChatGPT.app/Contents/MacOS/ChatGPT' | head -1) ps -o rss= -p $pid # 单位 KB,正常 200000-500000 (200-500MB) ps -M $pid | grep -c '^' # 线程数,正常 60-220 ps aux | grep -iE 'ChatGPT|SkyComputerUse' | grep -v grep | wc -l # 进程总数,>50 才可疑 - 真爆内存特征(>4GB RSS 或 >400 线程 或 >50 个 SkyComputerUseService 僵尸):
- 检查
[features] computer_use = false是否被 ChatGPT 重写覆盖(守护会补回) - 检查 CUAService.plist 是否异常大(>10KB 可疑,正常 162 字节)
- pkill 僵尸后重启:
pkill -9 -f SkyComputerUseService; open -a ChatGPT
- 检查
- 不爆内存但守护误杀(华哥复现):把阈值调高 + 重启 ChatGPT
调阈值的正确姿势(华哥 8/31 反馈后再修改):
# ~/.hermes/scripts/codex_memory_guard.py 第 26-28 行
THREAD_THRESHOLD = 400 # 60-220 健康;>400 才病态(ChatGPT.app 26.814 实测)
RSS_THRESHOLD_MB = 6144 # 正常 200-500MB;爆内存 >4GB 才熔断
避免再次误杀:跑 python3 ~/.hermes/scripts/codex_memory_guard.py 后立刻验证主进程存活——pgrep -fl ChatGPT.app/Contents/MacOS/ChatGPT,若有输出 = 健康;无输出 = 守护误杀,需 open -a ChatGPT 重启。
长期守卫生效:cron 5d9df933677d 当前停用中(pgrep 查不到进程)。华哥 8/31 反馈"修复 bug"后已恢复阈值但 cron 仍暂停。恢复 cron 时必须先验证阈值生效:
hermes cron resume 5d9df933677d # 或 cronjob action=resume job_id=5d9df933677d
# 等 2 分钟观察一次,确认守护静默退出
tail -5 ~/.hermes/logs/codex_memory_guard.log # 若有 "Codex守护: ..." 输出 = 有动作;空 = 静默=健康