# 社区

- [X：有人贴出 ModelTrace Guard 的 Codex 安装命令](https://x.com/leo114119/status/2099690720408002560)（X · @leo114119 · 2026-09-15）：帖子写出 marketplace add 和 plugin add modeltrace-guard@modeltrace。装完要在 /hooks 审这份插件，不要按帖子字面信任全部钩子。探针会花 Codex 额度。
- [Google 把 Cloud 技能打成 Agent Plugins 捆](https://x.com/Marwan_3atef/status/2098225087124029529)（@Marwan_3atef · 2026-09-11）：google-cloud-developer 不是一堆散落的 SKILL.md。Codex 路径是 marketplace add google/skills，再 plugin add google-cloud-developer@google-plugins。捆里有只读 Developer Knowledge MCP，用来查官方文档，不是给你的项目写 GCP 资源。装完仍要新开会话。
- [桌面写回 config.toml 可能删掉用户登记的 MCP](https://github.com/openai/codex/issues/36465)（openai/codex#36465 · 2026-09-11）：开放 bug。桌面改设置、插件或项目信任后，用户 ~/.codex/config.toml 里的 mcp_servers 整表可能消失。项目只写 enabled = true 会 invalid transport。权宜是项目里写全 command 或 url，并自己留备份。不要清空家目录。这不是内部 codex_app。
- [关掉 Codex CLI 欢迎屏闪烁星星](https://x.com/cooperx86/status/2098051356921586076)（@cooperx86 · 2026-09-10）：欢迎动画闪得心烦时，在已有 [tui] 表写入 animations = false，然后完全退出再开新会话。官方键还覆盖微光和 spinner。标签标题还在跳就再把 terminal_title 改成只有 project。
- [Windows 桌面走 WSL 时 nvm/fnm 不在 PATH](https://github.com/openai/codex/issues/13566)（openai/codex#13566 · 2026-09-10）：Windows 桌面的 WSL 命令会话常是非 login / 非交互，不读 .zshrc，nvm 和 fnm 初始化进不去。对比 zsh -lc 能找到、zsh -c 找不到。把 PATH 写进 ~/.profile，或用 shell_environment_policy.set 写死 node bin，不要只改交互 rc。
- [远端 SSH 找不到 codex：login shell 没有 nvm PATH](https://github.com/openai/codex/issues/19744)（openai/codex#19744 · 2026-09-10）：桌面 Remote / SSH 用远端 login shell 起 app-server。交互 SSH 里 nvm 能找到 codex，干净 bash -lc 却没有。把 wrapper 放到 ~/.local/bin，或把 PATH 写进 ~/.profile，不要只写 ~/.bashrc。
- [换目录后会话像丢了：先 resume --all](https://x.com/dilemmaaa1337/status/2097872917224714591)（@dilemmaaa1337 · 2026-09-10）：有人重启 Codex 后觉得对话只剩最初几条。社区提醒：resume --last 默认按当前工作目录过滤。换过文件夹先试 codex resume --all，记录往往还在。
- [0.154 worktree 可能要先开实验开关](https://x.com/ihuamo/status/2097856138507325558)（@ihuamo · 2026-09-10）：升级到 0.154 后如果找不到 /worktree，先在实验特性里打开再新开会话。具体开关名以本机 /experimental 和 changelog 为准，不要抄过期博客。
- [Unity 发布官方 Codex 游戏开发插件](https://x.com/i/trending/2097932631295836204)（X News · 2026-09-10）：X 话题同步：Unity 官方插件给 Codex 一批第一方技能。安装仍是 marketplace add Unity-Technologies/unity-agent-plugin，再 plugin add unity@unity-agent-plugin，并新开会话。仓库写明只有技能，没有 MCP 和钩子，不要指望它起编辑器 RPC。
- [CLI 0.154 实验性 --worktree / /worktree](https://x.com/Codex_Changelog/status/2097825113588498834)（@Codex_Changelog · 2026-09-09）：官方 changelog 同步：0.154.0 可用 --worktree 或 /worktree 给新会话/fork 建隔离 checkout，并能浏览 resume。社区提醒这是实验功能，本机没有入口时先 /experimental 或对照 /help，不要把博客里的未文档化旗标当稳定 API。
- [把吵闹的命令输出交给子代理](https://community.openai.com/t/tips-and-tricks-for-using-codex/1373143)（OpenAI Developer Community · 2026-09-09）：官方论坛帖补充：测试日志和递归搜索会挤占主对话。优先安静命令、把全文落到临时文件、把套件跑在子代理里。可写成 AGENTS.md 的固定卫生规则。
- [托管 worktree 会占磁盘，合完要清理](https://x.com/i/trending/2097623159155417178)（X News · 2026-09-09）：X 话题在抱怨 Codex 托管 worktree 留下的目录和 node_modules。CLI 树默认在 $CODEX_HOME/worktrees。合完用 /worktree 清理，不要只关会话。实验性 --worktree 不是默认；桌面仍走 Handoff 和自动清理。.worktreeinclude 只拷 ignore 文件，不会缩小磁盘。
- [DevDay 前围绕 Codex 新能力的讨论](https://x.com/i/trending/2097238056495353992)（X News · 2026-09-08）：社区在 9 月 29 日 OpenAI DevDay 前讨论 Codex 产品线更新。细节以官方 changelog 和现场发布为准，本条只作时间线入口，不把传闻当配置事实。
- [开发者在配额重置日对比 Codex 与 Claude Code](https://x.com/i/trending/2097161914380165298)（X News · 2026-09-08）：X 上的话题摘要：有人把 Codex 的 ChatGPT 云沙箱和更快的任务执行，与 Claude Code 的长上下文终端流对照，不少人当成互补而不是二选一。具体配额以账户页为准。
- [0.153.4 实验性 context_management](https://community.openai.com/t/experimental-context-management-compaction-in-codex/1395578)（OpenAI Developer Community · 2026-09-07）：论坛记录：比单纯 compact 摘要更细的上下文管理，默认关闭，config 里 features.context_management.experimental_mode。键名和默认值以本机 changelog / /help 为准，不要当稳定功能写进团队配置。
- [官方编码代理与自建栈的取舍](https://x.com/i/trending/2096707628743454960)（X News · 2026-09-06）：讨论把 Codex CLI / Claude Code 这类官方 harness，和更可换模型的开源自建栈对比。支持官方方案的人看重对齐与内置读改测；反对者看重控制度和选模型。对本站的启发是：先把 AGENTS.md 和权限配稳，再谈换壳。
- [本地 MCP 列表进不了 ChatGPT 网页 Work](https://x.com/gzzonkugood/status/2095675282623545833)（@gzzonkugood · 2026-09-04）：有人在 CLI 里 codex mcp add 之后，网页 Work 仍没有工具。原因是桌面应用 / CLI / IDE 扩展才读 ~/.codex/config.toml，托管网页是另一套主机。配错入口会误判成 MCP 失效。
- [0.154：macOS MCP 裸命令和相对路径改走原生 spawn](https://github.com/openai/codex/pull/42192)（openai/codex#42192 · 2026-09-02）：合并进 0.154：macOS 启动器不再只对绝对路径做原生 spawn。uvx、npx 一类裸命令按子进程 PATH 解析，相对可执行文件同样原生启动。没有 shebang 或找不到文件才回退 shell。从 Dock 开桌面时记得给 MCP 子进程补 PATH。
- [Windows setup refresh：.git 被 CodexSandboxOffline 占走](https://community.openai.com/t/codex-desktop-windows-fix-for-helper-unknown-error-setup-refresh-had-errors/1392808)（OpenAI Developer Community · 2026-09-01）：桌面应用报 helper_unknown_error: setup refresh had errors 时，先看 sandbox.log 里的 SetNamedSecurityInfoW failed: 5。常见原因是 .git / .codex 所有者变成 CodexSandboxOffline。结束全部 ChatGPT.exe 后，用管理员 icacls 把所有权改回自己的账户，不必重装。
- [0.152 默认关掉 update_plan](https://x.com/coinweight/status/2094863172343894172)（@coinweight · 2026-09-01）：升级到 0.152 后如果规划变安静，不一定是坏了。可在 ~/.codex/config.toml 打开 tools.update_plan.enabled，并新开会话。动手前对照本机 /help 和当前版本说明。
- [Windows deny-read 的无界 glob 会把会话撑爆成 os error 206](https://github.com/openai/codex/issues/41809)（openai/codex#41809 · 2026-08-31）：企业档里 ~/AppData/Local/Google/Chrome/** 会在启动前展开上万条路径，塞进沙箱 helper 命令行后超过 32,767 字符上限。错误写成文件名太长。绕过：deny 写精确目录，不要拖尾 /**。
- [托管 worktree 可能没有 .env 和 node_modules](https://community.openai.com/t/codex-worktrees-need-a-runtime-preflight-for-missing-env-files/1393774)（OpenAI Developer Community · 2026-08-31）：工具创建的 worktree 不一定会跑本地 environment setup。官方回应：用 .worktreeinclude 拷贝指定 ignore 文件，生产密钥不要这么带。测试用无密钥默认值和假变量更稳。
- [0.150.1 未信任项目仍可能注入 AGENTS.md](https://github.com/openai/codex/issues/41499)（openai/codex#41499 · 2026-08-29）：0.150.0 写明未信任项目不再提供项目级指令。有人在 0.150.1 用隔离 CODEX_HOME 复现：trust_level=untrusted 后，哨兵字符串仍出现在 debug prompt-input 和 exec 可见输入里。克隆陌生仓先自己读文件。
- [codex queue 打 exec 线程可能成功退出却丢掉消息](https://github.com/openai/codex/issues/41060)（openai/codex#41060 · 2026-08-27）：对 codex exec 开的线程 queue，命令常 exit 0，消息却进不了当前轮，竞态下甚至从磁盘消失。没有 list/flush。只对交互 TUI 或桌面会话用 queue。
- [权限档读不到 AGENTS.md 会误报 sessions corrupt](https://github.com/openai/codex/issues/40937)（openai/codex#40937 · 2026-08-26）：自定义权限档读不到工作区时，会话起不来，错误却让人清 ~/.codex/sessions。真正失败的是沙箱读 AGENTS.md。给工作区读权限，或暂时 project_doc_max_bytes = 0。Windows 上同一问题会报 os error 206。
- [OpenAI 论坛：桌面 26.820 开 WSL 后所有线程起不来](https://community.openai.com/t/codex-desktop-26-820-7780-0-wsl-threads-fail-with-invalid-transport-in-mcp-servers-codex-app/1392811)（OpenAI Developer Community · 2026-08-26）：和 GitHub 40819 同一条回归：MS Store 桌面 26.820.7780.0 自动更新后，WSL 托管线程全部 invalid transport。请求级配置里的 mcp_servers.codex_app 只有 enabled。权宜同样是关掉桌面 WSL 代理并重启，不是去修用户 MCP 表。
- [关 codex-app-tools 插件挡不住桌面 WSL 的 invalid transport](https://github.com/openai/codex/issues/40910)（openai/codex#40910 · 2026-08-26）：捆绑插件 desktop-mcp.json 里的 codex_app 用 cmd.exe 启动。桌面把 app-server 丢进 WSL 后，这条 Windows 传输过不去。plugins."codex-app-tools@openai-bundled" enabled = false 无效。日志里会出现 Spawning process inside WSL。不要把 cmd.exe 启动块抄进 WSL 侧 config。
- [桌面 WSL 注入残缺 mcp_servers.codex_app，报 invalid transport](https://github.com/openai/codex/issues/40819)（openai/codex#40819 · 2026-08-26）：桌面 26.820.x 在 WSL 代理路径上 thread/start、thread/resume 会注入内部服务器 codex_app，常常只有 enabled 或 enabled_tools，没有 command 或 url。报错让修 config.toml，用户文件里通常没有这张表。关捆绑插件无效。可靠权宜是 runCodexInWindowsSubsystemForLinux = false 并彻底重启，这会改成 Windows 原生代理。
- [链接 worktree 里项目 hooks.json 可能根本没加载](https://github.com/openai/codex/issues/27133)（openai/codex#27133 · 2026-08-25）：链接 worktree 的 .git 是文件。有人发现项目 .codex/hooks.json 静默不跑，只有 ~/.codex 用户钩子生效。绕过信任旗标也没用。官方意图是钩子跟主仓走；发现失败就先把钩子放到用户目录。
- [mcp_tool Stop 钩子在 MCP 缺失时 fail-open](https://github.com/openai/codex/issues/39858)（openai/codex#39858 · 2026-08-21）：mcp_tool Stop 在服务器未注册或起不来时，钩子记 Failed，turn 仍 completed。exec JSONL 还不带 hook 事件。不要把 MCP Stop 当完成门；failureMode 还只是提案。
- [远程精选插件会无视 per-plugin enabled = false](https://github.com/openai/codex/issues/28443)（openai/codex#28443 · 2026-08-20）：给 openai-curated-remote 写 enabled = false，新会话里仍可能被注入。要停远程精选目录，用 features.remote_plugin = false；整面关掉插件才是 features.plugins = false。按条关建议仍走 tool_suggest.disabled_tools。
- [子仓单独 clone 时读不到父仓 .codex](https://x.com/kanagen_jp/status/2089264968189235498)（@kanagen_jp · 2026-08-17）：项目层 config.toml 只从当前 Git 根查找。monorepo 子目录被单独 clone 时，父仓的 .codex 不会出现，会话会退回 ~/.codex 的个人默认。子仓要自带一份项目配置，或把根标记设对。
- [codex exec 会在可选 MCP 1 秒宽限后丢掉已握手的工具](https://github.com/openai/codex/issues/38689)（openai/codex#38689 · 2026-08-15）：exec 一开始就冻结工具表。可选服务器默认只等 1000ms，tools/list 晚到也不会进第一轮。桌面后续轮会刷新所以看起来正常。exec 把服务器设 required，或 mcp_optional_startup_grace_ms = 0。
- [编码在 CLI 里开，桌面应用只负责盯和转向](https://x.com/DanJustiniac/status/2088362402677174446)（@DanJustiniac · 2026-08-14）：一种实际分工：任务从 Codex CLI 启动，ChatGPT 应用只用来监控和纠偏，从而保住 config.toml 里的系统/开发者指令，并沿用自己的 worktree 管理，而不是把非编码闲聊混进同一条工作线程。
- [execpolicy allow 遇上 deny-read 会静默留在沙箱](https://github.com/openai/codex/issues/38318)（openai/codex#38318 · 2026-08-13）：权限档只要有任意 deny-read，allow 规则就不会出沙箱。check 仍报 allow，git fetch 还会弹窗。要挡密钥就接受沙箱内执行；要出沙箱就不要在同一档写 deny-read。
- [可移植 mcp.json 的 env 不会展开任意 ${VAR}](https://github.com/openai/codex/issues/38438)（openai/codex#38438 · 2026-08-13）：Agent Plugin 的 env 目前只展开 PLUGIN_ROOT 和 PLUGIN_DATA。其它 ${VAR} 会原样传给子进程。0.150 起可在 .codex-plugin/.mcp.json 给同名服务器写 env_vars 做本机转发，可移植 mcp.json 仍是源。不要把密钥写进清单。
- [/import 可迁入 Claude Code 与 Cursor 配置](https://x.com/theaicatchup/status/2087596578051588477)（@theaicatchup · 2026-08-12）：社区同步：Codex CLI 增加 /import，可把 Claude Code / Cursor 的 settings、子代理、斜杠命令、hooks 和 MCP 映射过来，原目录不动。迁完仍应核对 AGENTS.md。官方 CLI 参考与 changelog 已收录该命令。
- [Oracle：用 SQLcl MCP 把 Codex CLI 接到数据库](https://blogs.oracle.com/developers/how-to-build-a-controlled-mcp-workflow-for-codex-and-oracle-ai-database)（Oracle Developers · 2026-08-12）：官方步骤：SQLcl 25.2+ 用 sql -mcp，连接先 conn -save -savepwd 存进 ~/.dbtools。Codex 只写绝对 command 和 args = ["-mcp"]，密码不要进 config.toml。后半的 Agent Memory / LangChain 是应用层，不是 Codex 配置。
- [反复 block 的 Stop 钩子会把 CLI 卡进无限续写](https://github.com/openai/codex/issues/37937)（openai/codex#37937 · 2026-08-11）：Stop 每次 block 都会再开一轮模型。没有次数上限。依赖坏了却反复返回同一段 block 时，只能杀进程。钩子必须认 stop_hook_active。
- [Grafana Cloud MCP login 失败：OAuth 探测没带 Accept 头](https://github.com/openai/codex/issues/37830)（openai/codex#37830 · 2026-08-10）：开放问题。codex mcp login grafana 探测 GET 不带 Accept: application/json, text/event-stream 时，mcp.grafana.com/mcp 会 302 到文档站，Codex 拒绝跨源跳转。权宜是 http_headers 写上这颗 Accept，以及可选的 X-Grafana-URL。
- [Windows 路径未转义会让整份 config.toml 解析失败，桌面卡在启动页](https://github.com/openai/codex/issues/37616)（openai/codex#37616 · 2026-08-08）：商店版桌面 26.803 卡在加载页、没有明确报错。双引号里的 Windows 路径把 \d、\P 当成非法转义，整份配置加载失败。改成单引号、正斜杠，或把每个反斜杠写成两个。这不是 invalid transport，也不是 MCP 进程本身挂了。
- [Computer Use 空窗口：先关 sandbox_private_desktop](https://github.com/openai/codex/issues/37043)（openai/codex#37043 · 2026-08-05）：助手跑在 Winsta0\CodexSandboxDesktop-... 上时，EnumWindows 找不到你正在用的窗口。config.toml 写 sandbox_private_desktop = false 回到 Winsta0\Default，然后彻底退出 ChatGPT / Codex 再开。不要改成 unelevated 来修窗口。
- [插件 MCP 的 command 不会展开 PLUGIN_ROOT](https://github.com/openai/codex/issues/35762)（openai/codex#35762 · 2026-07-28）：钩子会替换 ${PLUGIN_ROOT}，插件 mcp.json 的 command/args 不会，字面会进启动命令。相对 cwd 相对安装后的插件根；写成 "." 再配相对 args。讨论 28145 也是这条路，不要抄 Claude 的 CLAUDE_PLUGIN_ROOT。
- [compact_prompt 在 OpenAI 远程压缩里会被静默忽略](https://github.com/openai/codex/issues/34428)（openai/codex#34428 · 2026-07-20）：内置 OpenAI / Azure 走远程压缩，config.toml 里的 compact_prompt 和 experimental_compact_prompt_file 不会进摘要。0.150.1 仍如此。本地 OSS 路径才会读。用标记句验证，不要只看配置已加载。
- [子代理会把父会话全文拷进 rollout，history.max_bytes 管不了](https://github.com/openai/codex/issues/34061)（openai/codex#34061 · 2026-07-18）：配置参考里的 [history] 只约束 history.jsonl。sessions/ 下的子代理 rollout 会复制父会话，archive 只是挪到同盘 archived_sessions。磁盘报警先 du ~/.codex/sessions，不要只改 persistence。
- [插件 MCP 服务器名带连字符时 list 看得到、模型调不到](https://github.com/openai/codex/issues/33063)（openai/codex#33063 · 2026-07-14）：key 写成 context-library 时，mcp get 显示已启用，exec 却发现不了 mcp__context-library__... 工具。改成 context_library 立刻可调。连接器路径会把连字符收成下划线，插件 MCP 目前按原名进工具命名空间。
- [AGENTS.md 配 docs/index.md 和 @tag](https://community.openai.com/t/a-repo-native-context-pattern-for-codex-agents-md-index-md-searchable-tags/1386068)（OpenAI Developer Community · 2026-07-08）：把越写越长的 AGENTS.md 收成导航文件：docs 树用 index.md 指路，跨目录概念用 @tag 加 tags.md 注册表。目标是人类和 agent 共用同一套可 grep 的上下文，而不是再堆一份向量库。
- [MCP OAuth 的 mcp_oauth_callback_url 会再拼 callback ID](https://github.com/openai/codex/issues/30460)（openai/codex#30460 · 2026-06-28）：有人把基址当最终 redirect_uri 登到 Keycloak，精确匹配失败。Learn 现行规则就是无 issuer 支持时拼上服务器特定 callback ID。把 add 打印的完整 URL 登上去。不要写成已修 bug，也不要等未合入的 callback-url 子命令。
- [mcp list 显示 Bearer 不等于请求真带了 Authorization](https://github.com/openai/codex/issues/30125)（openai/codex#30125 · 2026-06-25）：HTTP MCP 配了 bearer_token_env_var 后，mcp list / mcp get 仍显示 Auth: Bearer token，即使当前进程里没有这个变量。真正发出的 initialize 没有 Authorization，工具直接消失。codex doctor 有时能标缺失环境变量。从 Dock 打开的桌面看不到 zshrc。改完环境必须彻底重启进程。
- [exec 里插件 MCP 键少了 @marketplace 会报用户取消](https://github.com/openai/codex/issues/29857)（openai/codex#29857 · 2026-06-24）：插件审批写在 inspect-skills 而不是 inspect-skills@meridian 时，lookup miss 落到 auto。exec 没有批准 UI，错误写成 user cancelled。正确键名后 default_tools_approval_mode = approve 即可，不必 --yolo。
- [第三方 MCP 写 auth=chatgpt 拿不到 ChatGPT 会话](https://github.com/openai/codex/pull/29733)（openai/codex#29733 · 2026-06-23）：维护者把 ChatGPT 会话鉴权从写死的 Apps 服务器名改成可选项，但只允许 URL 与 chatgpt_base_url 同源。任意第三方 MCP 不能把会话令牌拐走。现行键是 auth = chatgpt，不是早期补丁里的 use_chatgpt_auth。
- [TUI 建议给 codex_apps 写 startup_timeout_sec，照做会 invalid transport](https://github.com/openai/codex/issues/29396)（openai/codex#29396 · 2026-06-22）：主机自带的 Apps 连接器超时后，TUI 仍套用用户 MCP 的修法，让人写 [mcp_servers.codex_apps]。那台没有用户可配的 transport，config 会直接加载失败。这不是桌面 WSL 注入的残缺 codex_app，也不是给自己的 npx 服务器加超时。
- [代理注入的 HTTPS_PROXY 和 NODE_EXTRA_CA_CERTS 会被 MCP 子进程丢掉](https://github.com/openai/codex/issues/29124)（openai/codex#29124 · 2026-06-19）：Codex 清掉 stdio MCP 环境后只放行 PATH/HOME 一类默认变量。公司 MITM 注入的证书和代理变量不在名单里，npx 拉包会 EACCES。权宜是把 HTTPS_PROXY 和 NODE_EXTRA_CA_CERTS 写进该服务器的 env_vars。改 inherit=all 管不到这条。
- [桌面 Record & Replay：演示一遍生成技能](https://community.openai.com/t/introducing-record-replay/1384088)（OpenAI Developer Community · 2026-06-18）：官方在论坛宣布 macOS Record & Replay：在桌面应用里录一次流程，产出可检查、可编辑的技能。初期不含 EEA、英国和瑞士，且 Computer Use 必须可用。这不是 CLI 功能，生成的 SKILL.md 之后可以在 CLI 里调用。
- [Bearer MCP 鉴权失败时不要先跑 mcp login](https://github.com/openai/codex/issues/26760)（openai/codex#26760 · 2026-06-06）：远程服务器用 bearer_token_env_var 时，启动报 Auth required 仍可能被映射成没登录，提示去 codex mcp login。Bearer 服务器没有 OAuth 流程。先确认启动 Codex 的进程里有这个变量、token 没过期，再考虑 OAuth。
- [Codex CLI 连 Vercel MCP：OAuth 报 The app redirect URL is invalid](https://community.vercel.com/t/codex-cli-vercel-mcp-login-fails-with-the-app-redirect-url-is-invalid/42756)（Vercel Community · 2026-05-27）：报告 codex mcp add vercel --url https://mcp.vercel.com 后，浏览器停在 The app redirect URL is invalid。redirect_uri 形如 http://127.0.0.1:49683/callback/J69OfRTZqnV5。这是 Vercel 拒带 callback ID 的 loopback，不是 TOML 能改掉的。官方仍列 Codex CLI。
- [桌面应用每次启动把已移除的 js_repl 写回 config.toml](https://github.com/openai/codex/issues/24387)（openai/codex#24387 · 2026-05-25）：CLI 把 js_repl 标成 removed 后，桌面应用启动仍可能用 config/batchWrite 写回 features.js_repl = false，有时还带回 mcp_servers.node_repl。删掉这行再开桌面，它还会回来。不要把它当成还能打开的实验开关。
- [Esc 打断时 Stop 钩子不会跑](https://github.com/openai/codex/issues/22858)（openai/codex#22858 · 2026-05-15）：run_turn 只在正常完成路径调 Stop。Esc 的 TurnAborted 直接 break，扫描器状态会卡在 running。0.150 起用 Interrupt 做打断清理；不要等 Stop 补上这条路径。
- [tools.view_image 已当 noop 删除，文档可能仍列出](https://github.com/openai/codex/pull/22501)（openai/codex#22501 · 2026-05-13）：维护者确认 tools.view_image 早就失效，PR 把它从配置里拿掉。官方配置参考和 sample 有时还写着这个布尔键。要给模型看图，用 CLI 的 -i / --image 或 IDE 拖图，不要再往 config.toml 写这行。
- [插件 .mcp.json 包装键必须是 mcpServers](https://github.com/openai/codex/issues/22105)（openai/codex#22105 · 2026-05-11）：官方兼容布局示例把包装对象写成 mcp_servers。加载器按 camelCase 读，蛇形键会回退成一台名叫 mcp_servers 的假服务器，没有警告。改成 mcpServers，或直接把服务器表放在根上。TOML 策略仍写 plugins."name".mcp_servers。serde alias 补丁没有进主干。
- [commit_attribution 只在打开 codex_git_commit 时生效](https://github.com/openai/codex/issues/19799)（openai/codex#19799 · 2026-05-06）：有人问默认会不会给提交加共同作者。文档随后写明：先开 features.codex_git_commit，commit_attribution 才有用。键值是身份字符串；空字符串关掉。对照本机 features list，这个开关仍是开发中。
- [Codex 只 add GitHub MCP 的 URL 不会写入 bearer 变量名](https://github.com/github/github-mcp-server/issues/2421)（github/github-mcp-server#2421 · 2026-05-02）：安装指南里 TOML 有 bearer_token_env_var，早期 CLI 示例却只有 --url。生成的配置能 list，请求 401。现行命令必须带 --bearer-token-env-var GITHUB_PAT_TOKEN。键是变量名，不是 PAT；Codex 也不会自动读 .env。
- [stdio MCP 往 stdout 打日志，Codex 会 Transport closed](https://github.com/openai/codex/issues/18486)（openai/codex#18486 · 2026-04-28）：桌面比不少客户端更严：stdout 必须是换行分隔的 JSON-RPC。Unity MCP 把队列状态打到 stdout 后工具调用立刻 Transport closed，改到 stderr 并写绝对 node.exe 后恢复。Content-Length 帧、Python 握手和 stderr 堵管道是另几条坑。
- [stdio MCP 默认不继承 shell 里的密钥和会话变量](https://github.com/openai/codex/issues/19023)（openai/codex#19023 · 2026-04-22）：Bitwarden 一类包装在终端能握手，Codex 里却像没装。维护者说明 env_vars 从启动进程转发变量名，env 表是写进 config 的字面量。不要指望 ${VAR} 会展开，也不要把会话 token 写进仓库。
- [check_for_update_on_startup 不影响桌面应用标题栏 Update](https://github.com/openai/codex/issues/18543)（openai/codex#18543 · 2026-04-17）：config.toml 里关掉启动检查后，桌面应用标题栏仍可能出现 Update。维护者说明该键只对 CLI/TUI 生效，不管 IDE 扩展和 Codex 应用。桌面内置更新走托管 requirements.toml 的 in_app_updates。
- [流式时 SQLite WAL 狂写盘，RUST_LOG 压不住 TRACE](https://github.com/openai/codex/issues/17320)（openai/codex#17320 · 2026-04-10）：流式回复时 app-server 可持续往 logs_*.sqlite-wal 写数 MiB/s。报告称这与 RUST_LOG 过滤无关。先把 sqlite_home 指到独立磁盘，并和明文 log_dir、history.jsonl 分开看。
- [超大工具输出会整段落进上下文并加速打满额度](https://github.com/openai/codex/issues/16664)（openai/codex#16664 · 2026-04-03）：有人发现超大工具输出会进会话历史，5 小时额度掉得特别快。维护者说明可用顶层 tool_output_token_limit 覆盖；调太小会让模型拿到截断结果后行为怪异。这和 MCP 单工具 output_token_limit 不是同一键。
- [Playwright MCP 报 chrome executable not found 时先装 Chromium](https://github.com/openai/codex/issues/16696)（openai/codex#16696 · 2026-04-03）：标题写成桌面忽略已配置的 Playwright MCP，但复现后能跑通的步骤是 npm 装包再 npx playwright install chromium。缺浏览器二进制时不要假设系统 Chrome。--extension 是另一条路径，要装 Playwright 扩展，不是默认配置。
- [桌面 Figma MCP 换账号要 mcp logout 再 login](https://community.openai.com/t/codex-app-cannot-re-authenticate-figma-mcp-old-credentials-are-always-reused-with-no-way-to-switch-account/1373470)（OpenAI Developer Community · 2026-04-01）：重装插件或关掉再开会复用旧 Figma 登录。权宜是终端里 codex mcp logout figma，再 codex mcp login figma。不要去翻钥匙串当第一手段。官方远程地址是 https://mcp.figma.com/mcp。
- [桌面默认沙箱里 Playwright 技能会 listen EPERM](https://github.com/openai/codex/issues/16174)（openai/codex#16174 · 2026-03-29）：开放问题。内置 playwright 技能在桌面默认沙箱拉浏览器时，本机 CDP listen 被拒，报 EPERM。把 Playwright 缓存改到工作区只修文件权限。不要把关掉沙箱写成官方第一步。
- [MCP OAuth scopes：CLI 和 config 盖过广告 scopes_supported](https://github.com/openai/codex/pull/14419)（openai/codex#14419 · 2026-03-12）：源码 resolve_oauth_scopes 的顺序是 --scopes、config、广告 scopes_supported、空列表。广告值是临时的，不会写回 TOML。Learn 页若仍写广告优先，以这条实现为准。改范围必须重新 mcp login。
- [桌面 stdio MCP 常常要绝对 cwd 才能露工具](https://github.com/openai/codex/issues/14449)（openai/codex#14449 · 2026-03-12）：Laravel Boost 一类本地 stdio 服务器在 CLI 能用，桌面任务里 cwd 有时是 /，相对 command 起不来。项目层补绝对 command 和绝对 cwd 后才露工具。这和「桌面完全不读项目 config」是两条线，先看进程实际工作目录。
- [关掉 CLI 启动更新提示：键必须写在顶层](https://github.com/openai/codex/issues/14336)（openai/codex#14336 · 2026-03-11）：有人想关掉每日 Update available 提示。维护者给出 check_for_update_on_startup = false，并强调必须是顶层键。写进子表会看起来配了仍弹窗。这只关检查，不是自动安装。
- [后台空轮询每次都把完整历史再打一遍 API](https://github.com/openai/codex/issues/13733)（openai/codex#13733 · 2026-03-06）：后台编译或测试时空 write_stdin 轮询会反复带着完整历史打 API。background_terminal_max_timeout 是空轮询上限，不是间隔；空轮询仍有大约 5 秒下限。exec_command 首轮大约 30 秒封顶，不读这个键。调大它不能当成省 token 开关。
- [桌面 WSL 代理下列得出 MCP，线程里却没有工具](https://github.com/openai/codex/issues/13690)（openai/codex#13690 · 2026-03-06）：Agent environment 走 WSL 时，WSL 里的 npx/node stdio 服务器 mcp list 显示 enabled，手工 initialize 也能列出工具，桌面新线程却不注入。改成 Windows 侧 node.exe 启动器后工具出现。这和内部 codex_app 的 invalid transport 不是同一条。不要为了对齐配置去共用 CODEX_HOME。
- [WSL 通知会拉起 PowerShell EncodedCommand Toast](https://community.openai.com/t/codex-cli-on-windows-wsl-triggers-edr-alert-due-to-powershell-encodedcommand-toast-notifications/1375803)（OpenAI Developer Community · 2026-03-05）：WSL 里跑 CLI 时，TUI 通知可能经 powershell.exe -EncodedCommand 发 Windows Toast，触发 EDR。只设 tui.notifications = false 不够，还要清掉顶层 notify 和会弹系统通知的 Stop 钩子。
- [官方 Slack MCP 不支持 DCR，login 要预注册 client_id](https://github.com/openai/codex/issues/13200)（openai/codex#13200 · 2026-03-02）：开放问题。只写 url 再 mcp login slack，会报 Dynamic client registration not supported。Slack 官方 MCP 要求预注册应用。0.142 起用 --oauth-client-id 或 [mcp_servers.slack.oauth] client_id，再 login。不要抄文档里的 --transport http。
- [桌面经常忽略项目 .codex/config.toml 里的 MCP](https://github.com/openai/codex/issues/13025)（openai/codex#13025 · 2026-02-27）：受信任项目的项目层 mcp_servers，CLI 通常能加载，桌面和 IDE 扩展经常只读用户 config。2026-07 仍有人在桌面 26.707 复现。权宜之计是把同一段拷到 ~/.codex/config.toml，彻底退出后新开线程，并杀掉过期 MCP 进程。仓库本地二进制不要变成全局项。
- [技能写进 AGENTS.md 更容易被选中](https://community.openai.com/t/does-codex-in-vs-code-or-in-general-needs-skills-to-be-mentioned-in-agents-md/1374491)（OpenAI Developer Community · 2026-02-18）：官方仍靠 SKILL.md 的 description 做发现。社区反馈：在当前会话加载的 AGENTS.md 里列出技能名和 SKILL.md 全路径，隐式调用更稳。不必手写，可以让 Codex 先生成再改。仓库技能要从该仓根启动会话。
- [桌面应用自己开的线程可能不读 developer_instructions](https://github.com/openai/codex/issues/11004)（openai/codex#11004 · 2026-02-07）：CLI 会把顶层 developer_instructions 追加进会话；桌面应用自己开的线程可能完全不注入。2026-08 仍有人复现。桌面要个人风格用 Personalization 或 ~/.codex/AGENTS.md，并用 debug prompt-input 核对。
- [Codex 用浏览器：/skills 里装精选 playwright 技能](https://community.openai.com/t/how-do-i-get-codex-to-use-the-browser/1373178)（OpenAI Developer Community · 2026-02-02）：有人只装了全局 @playwright/cli，以为 Codex 没有 Playwright 技能。回复给出 /skills → skill-installer → playwright。原帖确认能用。这和 Playwright MCP、以及默认写进 .claude 的 install --skills 不是同一条路。
- [开发中特性警告写进 [notice] 不会消失](https://github.com/openai/codex/issues/10013)（openai/codex#10013 · 2026-01-27）：有人把 suppress_unstable_features_warning 写进 [notice]，警告还在。维护者确认必须是顶层键。关警告不会让 collab 一类开发中开关变稳定。
- [Connect Codex to OpenAI Developer Docs via MCP](https://community.openai.com/t/connect-codex-to-openai-developer-docs-via-mcp/1371352)（OpenAI Developer Community · 2026-01-09）：论坛把官方 Docs MCP 命令贴了一遍：mcp add openaiDeveloperDocs --url。AGENTS.md 那句是可选提醒，不写就要在提示里点名这台服务器。这不是桌面浏览器的 WebMCP，也不要抄 Claude 的 --transport http。
- [Windows 上 MCP stderr 管道堵死，Codex 报 Transport closed](https://github.com/openai/codex/issues/7155)（openai/codex#7155 · 2025-11-22）：stdout 已是干净 JSON-RPC，手工探测和 Claude / Copilot 都正常，只有原生 Windows 上的 Codex 立刻 Transport closed。约 4KB 的 stderr 管道没人读就会堵死子进程。权宜是 cmd /c 把 stderr 重定向到日志文件，不要默认丢进 NUL；不要把 command = cmd 抄进 WSL。
- [Codex 远程 MCP 只支持 Streamable HTTP，/sse 会在 initialize 时 404](https://github.com/openai/codex/issues/5634)（openai/codex#5634 · 2025-10-24）：维护者确认 Codex 不接旧版 SSE。url 写成 /sse 时 OAuth 往往能过，随后 initialize 报 404。改成供应商的 /mcp 或 /v1/mcp。不要先用 mcp-remote 把远程服务变回 stdio。
- [Streamable HTTP MCP 增加 http_headers 和 env_http_headers](https://github.com/openai/codex/issues/5241)（openai/codex#5241 · 2025-10-16）：给 Streamable HTTP 加上静态头和从环境变量解析的头，所有对该服务器的 MCP 请求都会带上。env_http_headers 在请求时读进程环境；缺变量或空值会静默跳过这颗头。这不是 stdio 的 env_vars。
- [自定义 MCP 头可以不用 Authorization，省略 bearer 键即可](https://github.com/openai/codex/issues/5180)（openai/codex#5180 · 2025-10-14）：有人问目标服务器只要自定义头、不要 Authorization。维护者确认可以省略 bearer_token_env_var，另外用 http_headers 或 env_http_headers。密钥写环境变量名，不要把字面量提交进 config.toml。
- [Linux 上 Playwright MCP 只有 snapshot：stdio 要转发 DISPLAY](https://github.com/openai/codex/issues/4643)（openai/codex#4643 · 2025-10-03）：本机 headed Playwright 能弹窗，Codex 的 MCP 却只回 snapshot。维护者说明默认不把 DISPLAY 交给 stdio。评论写成 env_args，现行键是 env_vars。同时转发 WAYLAND_DISPLAY、XAUTHORITY、XDG_RUNTIME_DIR。这修不了沙箱。
- [冷 npx / uvx 经常超过 MCP 默认 10 秒启动超时](https://github.com/openai/codex/issues/2905)（openai/codex#2905 · 2025-08-29）：Windows 上 Context7 / Playwright 冷启动报 request timed out。维护者在 rust-v0.31.0 合入可配置超时后关单。现行键是每台服务器的 startup_timeout_sec，默认 10 秒；startup_timeout_ms 只是毫秒别名。先预热 npx 缓存，再把超时提到 30–60。