Codex 插件装了却用不上?我在测试机上装了一遍:先开新对话,再查这 3 处

这两天好几个号在推「Codex 最值得装的 10 个插件」。照着装完,回到对话里一找:没有。是没装上,还是被关了,还是要等?我在测试机上(Codex CLI 0.164.0)装了一个官方插件、一个自己做的测试插件,把装、查、关、删都试了一遍。最常见的原因就一个:装完要开新对话。还不行,再查 3 处。文末有一张照着做的清单。

01先试这个:开一个新对话

我的测试是这样的:对话开着,在另一个终端里装插件,回到原对话输入 $ 看技能列表,新装的插件不在里面;输入 /new 开新对话,再输入 $,它就出来了。

官方文档也写着:插件里的技能,装完之后新开对话或会话才能用。命令行版用 /new,或者退出 codex 再打开;桌面版就新开一个对话。

图 1 · 原对话里没有,/new 之后就有

02第 1 处:装上了没有?看 STATUS

新对话里还是没有,就在终端里跑一下:

codex plugin list

它会列出所有插件市场里的插件,看 STATUS 这一列:installed, enabled 是装了也开着;installed, disabled 是装了但被关了;not installed 就是没装上,用 codex plugin add 插件名@市场名 装。我测试时,官方市场里大约有 50 个插件。

也可以在对话里输入 /plugins,切到 Installed 标签看已经装了哪些。

图 2 · 看 STATUS 判断是哪种情况

03第 2 处:是不是被关了?先停用,再卸载

在 /plugins 里选中插件,按 Tab 就能停用或打开。我试了:停用后 config.toml 里多了 enabled = false,插件文件还在,新对话里它的技能就不见了;再按一次 Tab 就开回来。

确定不要了,再用 codex plugin remove 插件名@市场名 卸载:插件文件和 config.toml 里那一段都会删掉,要用得重新装。不确定的先停用,别直接卸载。

图 3 · 停用和卸载的区别

04第 3 处:装在哪、记在哪

装好的插件放在 ~/.codex/plugins/cache/市场名/插件名/版本/ 下面;开关记在 ~/.codex/config.toml 的 [plugins."插件名@市场名"] 里。官方插件目录会自动同步到 ~/.codex/.tmp/plugins,我测试机上有 103M(就是上周《占了几十 GB》那篇里的 .tmp)。

官方文档里还有两条提醒,我没法实测,照原意写:卸载插件不会断开它连的外部服务(GitHub、Slack 这类 MCP 连接要另外去断开);带 hook 的插件要你先信任,hook 是在特定时机自动跑的命令,先看清楚再同意。

图 4 · 位置和官方提醒

插件装完先开新对话;还没有,就看 codex plugin list 的 STATUS。

· · ·

Codex 插件装了用不上,按这个顺序1. 开新对话:/new,或退出 codex 重开(桌面版新开对话)2. 输入 $,看技能列表里有没有3. 还没有:codex plugin list,看 STATUS4. disabled:/plugins 里选中按 Tab 打开5. not installed:codex plugin add 插件名@市场名6. 不想要了:先 Tab 停用;确定不要再 codex plugin remove

截图存着;刚照着推荐装了一堆插件的同事,让他照着这 6 步查一遍。还没装 Codex 的,后台回复 codex,自动发你安装文档。

最后问一句:你现在装了几个插件?真正常用的是哪一个?

资料来源:OpenAI 文档《Plugins》(新对话后可用、卸载不断开 MCP、hook 需信任)、《Package your plugin》(本地插件市场、缓存位置),2026.10.25 读取。codex plugin add / list / remove、/plugins 的 Tab 停用、config.toml 的 enabled、原对话与 /new 之后的技能列表对比、缓存与 .tmp/plugins 大小,均为作者 2026.10.25 在测试机上用 CLI 0.164.0 实测(Linux,未登录 ChatGPT 账号;装的是官方市场的 Build Web Apps 和自建测试插件 pr-review,未跑真实任务)。桌面版未实测。