affaan-m 怎么安装：ECC 引导安装与手动配置对照
affaan-m 是 GitHub 账号名；实际可安装的是其 ECC 工具包。
ECC（面向 Claude Code、Codex、OpenCode 等编程代理的增强工具包）目前既有自动引导安装，也有按目标手动安装。2026 年 9 月 8 日收录的 ECC 文档快照已出现 ECC Universal 2.2.3：它可在一次流程里选择 Claude Code、Codex 和 Kimi Code，并先检查安装目标再写入文件。现在值得重新梳理安装路径，是因为“一条命令装完”和“只安装一个代理适配器”已经是两种不同需求。
下文安装命令均按上述文档快照的原文给出；涉及旧快照与当前官方仓库可能变化的地方，以官方仓库为准。
先分清：affaan-m、ECC 与安装目标
搜索“affaan-m 官网”时，GitHub Sponsors 页面通常是入口，而不是软件下载页。该页面把 affaan-m 列为 ECC 的维护者，并链接到其 GitHub 作品。真正需要安装的是 affaan-m/ECC，不是名为“affaan-m”的独立命令行程序。
安装前还要确定目标。ECC 不是一个只能单独运行的终端程序，而是根据宿主提供技能、记忆、安全检查或代理配置的工具包。文档列出的宿主包括 Claude Code、Codex、Kimi Code、Cursor、OpenCode、Gemini CLI、Zed、Antigravity、Qwen CLI、Hermes、OpenClaw 等。
| 需求 | 应选路径 | 先确认什么 |
|---|---|---|
| 想一次配置 Claude Code、Codex、Kimi Code | ECC Universal 引导安装 | Node.js、npm、目标代理已安装 |
| 只想给 Cursor 添加 ECC 配置 | 手动安装并指定 Cursor | 当前目录是 ECC 仓库 |
| 需要 OpenCode 的完整插件载荷 | 构建后安装 | npm 安装及构建命令能正常完成 |
| 已使用插件方式安装 | 先查插件列表 | 避免再叠加一套手动规则 |
三条前置条件：安装前逐项确认
-
准备 Node.js 与 npm。在终端运行
node -v和npm -v，确认两个命令都能返回版本号。ECC Universal 通过 npm 包启动；Node.js 或 npm 不可用时，引导命令无法执行。 -
先安装目标编程代理。例如准备使用 Codex，就应先能在终端启动 Codex；准备使用 Claude Code，则先确认 Claude Code 命令可用。ECC 只配置目标代理，不会替用户安装宿主本身。
-
进入可写目录并准备 Git。运行
git --version确认 Git 可用，再进入准备存放 ECC 的父目录。手动安装会创建项目配置或向宿主目录写入文件，目录权限不足会中断安装。
免费与付费方面，官方 Sponsors 页面说明 ECC 仓库采用 MIT 许可证；赞助页面列出的月度档位从每月 10 美元起，但赞助不是安装 ECC 的付费前置条件。
路径一：用 ECC Universal 一次安装
当需要同时配置多个代理时，优先走引导式安装。文档给出的完整命令是：
npx ecc-universal@2.2.3 install --guided执行后，界面会允许选择 Claude Code、Codex 和 Kimi Code 的任意组合，并显示每个目标采用的安装渠道与写入位置。它会先对所选目标执行预检查，最后再要求确认，因此不会一开始就写入文件。
三种目标的行为并不完全相同：
- Claude Code：安装原生
ecc@ecc插件，并选择一个user、project或local作用域，同时配置 ECC hook profile。hook 是代理执行任务时触发检查或附加行为的规则。 - Codex：使用 Codex 原生的 marketplace 与 plugin 生命周期；hook 的审核和信任决定仍由 Codex 管理。
- Kimi Code：在
./.kimi-code下管理项目文件，但不会自动配置 ECC hook、模型、提供商设置和认证。
如果需要在自动化环境中安装，文档还给出了把全部选择显式写出的形式：
npx ecc-universal@2.2.3 install --guided
--harness claude --harness codex --harness kimi
--claude-scope local --claude-hooks standard
--profile core --yes这段命令适合脚本化部署，不适合第一次安装：首次使用先执行交互式命令，更容易看清每个安装渠道和目标位置。
路径二：克隆仓库后手动指定宿主
只想安装单个宿主适配器时，可以采用手动路径。先从父目录执行：
git clone https://github.com/affaan-m/ECC.git
cd ECC随后根据目标运行对应命令。以 Cursor 为例：
./install.sh --profile minimal --target cursor这会安装 Cursor 的项目级 .cursor/ 适配器。Gemini CLI、Zed、Antigravity、Qwen CLI 和 Hermes 的基本路径相同，区别只在 --target 后面的宿主名称。
OpenCode 的流程多一步构建，文档给出的完整命令是：
npm install && npm run build:opencode && ./install.sh --profile full --target opencode这里不能只运行 install.sh：OpenCode 需要先构建插件载荷，再执行完整安装。文档还列出了 Kimi Code CLI 的手动入口：
./install.sh --profile minimal 单独使用目标安装命令时，仍应先阅读仓库内对应宿主的说明，因为不同宿主的认证、模型和 hook 权限由各自平台管理。
先验证，再决定是否重装
安装后不要只凭终端没有报错判断成功。Claude Code 插件方式可在会话中运行：
/plugin list ecc@ecc结果中应出现 ecc@ecc 条目。技能是 ECC 的主要工作入口，命令则提供兼容入口；手动安装有时暴露较短名称，插件安装则使用带命名空间的完整形式。
多宿主安装还可以先做只读检查。ECC Universal 文档给出的命令是：
npx ecc-universal这一步用于验证原生 Codex 路径和受管理的 Kimi 路径，同时避免立即写入文件。如果它列出的目标状态与预期不符，应先修正目标选择，再重新执行引导安装。
已经叠加安装过多种方式时，不要直接覆盖。官方说明建议按顺序清理：先移除 Claude Code 插件，再从包含受管理安装状态的目录运行 ECC 卸载命令，最后删除手动复制且不再需要的规则目录。ECC 只会移除安装状态中记录的文件。
常见卡点：看到原文提示后这样处理
提示需要登录 GitHub
GitHub Sponsors 页面可能出现：
You must be logged in to sponsor affaan-m这只影响赞助操作，不表示 ECC 安装必须付费。若只是安装开源仓库，直接访问 affaan-m/ECC；只有需要通过 Sponsors 页面订阅支持时才登录 GitHub。
页面加载失败
GitHub 登录页可能显示：
Uh oh! There was an error while loading. Please reload this page .先刷新当前页面；如果反复出现，再打开 GitHub 登录页 检查登录状态。这个提示属于 GitHub 页面加载问题，不应通过反复运行 ECC 安装命令解决。
安装了多个版本，命令行为不一致
旧文档中的手动安装与 ECC Universal 2.2.3 的引导安装不是同一入口。可先查看仓库当前 README，确认命令名称和目标参数；若源码脚本要求在仓库根目录运行，就不要在任意项目目录直接执行 ./install.sh。
安装完成后去哪里检查
打开目标代理，查找其插件或 MCP（Model Context Protocol，模型连接外部工具与数据源的协议）配置入口，确认 ECC 条目已经出现。Claude Code 可用 /plugin list ecc@ecc 验证；Codex 应检查其原生插件管理界面；手动安装的 Cursor、OpenCode 等目标，则检查对应项目目录中的适配器文件。
如果目标列表正确，但技能、hook、模型或认证仍不可用，不要立即重装。文档明确指出，Codex 的 hook 审核与信任、Kimi Code 的模型和认证等部分由宿主自身管理，需要转到对应宿主的配置界面完成。
官方入口与继续查阅的路径
安装与版本信息优先看 affaan-m/ECC 官方仓库，不要只依赖搜索摘要或第三方镜像。维护者背景、赞助档位和 ECC 的 MIT 许可证说明可看 affaan-m 的 GitHub Sponsors 页面。
需要复习 GitHub 本身的仓库、克隆与协作功能，可进入 GitHub Platform 和 GitHub Docs；若后续还要为其他代理补充训练资料，则可查看 GitHub Skills。这些是延伸入口，不是 ECC 安装的额外步骤。
参考来源
评论区
登录后可评论。