---
title: "安装 ECC 原生 Codex 插件"
summary: "从 affaan-m/ECC 安装 ecc@ecc。插件与旧版同步脚本选择一种安装方式，钩子在 /hooks 中单独确认信任。"
category: skills
level: starter
surfaces: [cli, app, ide]
tags: ["plugins", "ECC", "Skills", "hooks"]
canonical: /tips/ecc-codex-native-plugin/
---

# 安装 ECC 原生 Codex 插件

从 affaan-m/ECC 安装 ecc@ecc。插件与旧版同步脚本选择一种安装方式，钩子在 /hooks 中单独确认信任。

Everything Claude Code（ECC）给 Codex 有原生插件专节，写在仓库 README 和 `.codex-plugin/README.md`。要求 Codex 0.146.0 以上。CLI 动词是 `plugin add`，不是 `plugin install`。源仓简写是 `affaan-m/ECC`，清单 `.agents/plugins/marketplace.json` 的 name 是 ecc，插件 name 也是 ecc，所以是 `ecc@ecc`。

```bash
codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc
codex plugin list --json
```

两条 add 都可以再跑：marketplace 已加过会报 `alreadyAdded: true`，插件 add 会保持同一条已启用登记。刷新先升级清单，再装一次缓存：

```bash
codex plugin marketplace upgrade ecc
codex plugin add ecc@ecc
```

本地开发时将 checkout 根目录作为插件源：

```bash
codex plugin marketplace add /absolute/path/to/ECC
codex plugin add ecc@ecc
```

marketplace 入口指向**仓库根**，这样 Codex 拷进缓存时 `skills/`、`.mcp.json`、`hooks/` 和脚本还在一起。marketplace 根应指向完整仓库，而非 `.codex-plugin/` 子目录：父级相对路径会逃出缓存，装完技能和 MCP 都是空的。

启用状态记在当前 `CODEX_HOME`（默认 `~/.codex`），对用这个 home 的会话生效。**没有** Claude 的 `user` / `project` / `local` 三档。不要抄 `/plugin marketplace add https://github.com/affaan-m/ECC` 或 `/plugin install ecc@ecc`。不要把 `npx skills add` 当 Codex 插件安装器。

装完打开 `/plugins` 看 `ecc@ecc`。钩子是另一套控制：原生清单绑的是 `./hooks/codex-hooks.json`，目前核实过的是同步 `SessionStart`。Codex 默认开钩子支持，但**不会**因为装了插件就静默授权命令。新开会话，打开 `/hooks`，审过再信任。哈希变了要再审一次。不要把 Claude 的 `off` / `minimal` / `standard` / `strict` 四档套到 Codex，也不要手写 `plugin_hooks`。

会话里走引导配置用 `$configure-ecc`。那是技能调用，不是 Claude 的 `/ecc:configure-ecc`，也替不了第一次的 `plugin add`。

默认捆绑的 MCP 只剩 `chrome-devtools`（`npx -y chrome-devtools-mcp@latest`）。`github`、`context7`、`exa`、`memory`、`playwright`、`sequential-thinking` 已退役，工作改由技能包 CLI / REST，或 Codex 自己的能力。它们还在 `mcp-configs/mcp-servers.json` 里可选。已经手写过 `[mcp_servers.chrome-devtools]` 就不要和插件那张再叠一台。插件**不会**改 `~/.codex/config.toml` 里的模型、沙箱这些键。

不要和遗留 `bash scripts/sync-ecc-to-codex.sh` 叠用。那条路把文件合并进 `~/.codex`，**不会**登记 marketplace，现行 Codex 请走原生插件。仓库里直接开 Codex、读根 `AGENTS.md` 和可信的 `.codex/`，也是项目本地路径，同样不要再叠一条全局 marketplace。

`codex plugin list` 只证明登记成功。要从 ECC checkout 核对缓存里的技能、MCP 和资源，跑：

```bash
node scripts/codex/check-plugin-cache.js
```

0.154 起先看**当前会话**；当前会话没有再新开。桌面改 marketplace 后彻底退出再开。IDE 扩展没有 `/plugins`，用 CLI 加完再到 TUI 或桌面去装。网页 Cloud 不读取你这台 `CODEX_HOME` 插件缓存。

钩子会跑命令，保持工具批准。

## 来源

- [affaan-m/ECC](https://github.com/affaan-m/ECC)
- [ECC · Codex native plugin](https://github.com/affaan-m/ECC/blob/main/.codex-plugin/README.md)
- [ECC · configure-ecc](https://github.com/affaan-m/ECC/blob/main/skills/configure-ecc/SKILL.md)