everything-claude-code 深度指南
一篇面向编程初学者的 Everything Claude Code 入门与实战指南。本文尽量只依据官方 README 和规则文档整理，遇到版本变化较快的命令，会明确标注“以官方 README 为准”。
导语
如果你已经开始使用 Claude Code，但总觉得默认能力还不够强，那么 everything-claude-code 就是一个值得了解的开源合集。它把代理、技能、规则、钩子、MCP 配置和安装脚本打包到一起，目标不是“再写几个配置文件”，而是把 Claude Code 变成一套更完整的 AI 编程工作台。
对新手来说，这个项目最有价值的地方有两个：
- 它把很多 Claude Code 的进阶能力整理成了可安装、可复用的模块。
- 它同时提供插件安装和手动安装两种思路，适合不同熟悉程度的用户。
官方地址
| 类型 | 地址 |
|---|---|
| 官网 | https://ecc.tools/ |
| 官方 GitHub | https://github.com/affaan-m/everything-claude-code |
| 中文 README | https://github.com/affaan-m/everything-claude-code/blob/main/README.zh-CN.md |
是什么
everything-claude-code 可以理解成一个 Claude Code 能力增强包。官方仓库把它描述为一套面向 AI agent harness 的性能优化系统，里面包含：
agents/：负责分工的子代理skills/：可复用的工作流和知识模块commands/：传统 slash 命令兼容层hooks/：在会话、工具调用、结束阶段触发的自动化逻辑rules/：始终生效的编码规范和项目规则mcp-configs/：可选的 MCP 服务配置
简单说，它做的事情就是把“一个人写代码”升级成“有分工、有检查、有规范、有自动化”的协作模式。
适用场景
这个项目适合下面几类人：
- 想把 Claude Code 用成稳定生产力工具的人。
- 需要团队级工作流，比如规划、执行、审查、测试、复盘的人。
- 想为不同语言栈统一规则的人，比如 TypeScript、Python、Go、Web 等。
- 想研究 Claude Code 生态里代理、技能、钩子如何协同的人。
如果你只是想临时跑一次简单对话，它可能有点重。但如果你希望 AI 助手长期按你的习惯工作，它就很有价值。
安装准备
开始之前，建议先确认这几件事：
- 你已经安装 Claude Code，并能正常打开会话
- 你知道自己更想走“插件安装”还是“手动安装”
- 你已经准备好要使用的语言栈，比如
typescript、python、golang、swift、php - 你能接受安装脚本会触碰到
~/.claude/下的配置
官方 README 里提到，安装脚本在不同平台上的行为并不完全相同；如果你打算安装到别的宿主环境，比如 Cursor、Gemini 或 Antigravity，也要以官方 README 的当前说明为准。
安装方式
方式一：插件安装
这是最适合新手的方式。你可以先把仓库加入 Claude Code 的 marketplace，再安装插件。
/plugin marketplace add https://github.com/affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-code安装完成后，Claude Code 会直接获得仓库提供的命令、代理、技能和钩子。
方式二：手动安装
手动安装适合想自己控制文件落点的人。官方 README 给出的基本思路是：
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
npm install
# macOS / Linux
./install.sh --profile full
./install.sh typescript
# Windows PowerShell
.\install.ps1 --profile full
.\install.ps1 typescript如果你只想安装某些语言规则，README 还给出了类似下面的用法：
./install.sh typescript python golang swift php另外，README 里也提到一个兼容入口：
npx ecc-install typescript这类命令属于会随版本调整的部分，实际可用参数请以官方 README 为准。
插件安装和手动安装差异
| 对比项 | 插件安装 | 手动安装 |
|---|---|---|
| 上手难度 | 低 | 中等 |
| 适合人群 | 新手、快速试用 | 想精细控制配置的人 |
| 生效方式 | Claude Code 插件系统直接接管 | 由安装脚本把文件复制到本地配置 |
| 配置范围 | 适合整体能力注入 | 适合按语言、按模块拆分安装 |
| 可见性 | 较少，偏“自动化” | 较高，能看到每个目录与文件 |
| 风险点 | 依赖插件系统行为 | 容易把规则目录复制错、把目录拍平 |
对初学者来说，推荐先用插件安装，熟悉以后再考虑手动安装。
目录结构
下面是官方 README 能直接看出的核心目录。不同版本可能会继续扩展，所以这里按“主干结构”理解就好：
everything-claude-code/
├── agents/
├── commands/
├── hooks/
├── mcp-configs/
├── rules/
│ ├── common/
│ ├── typescript/
│ ├── python/
│ ├── golang/
│ ├── web/
│ ├── swift/
│ └── php/
├── skills/
├── tests/
├── install.sh
├── install.ps1
└── README.md这里最容易踩坑的是 rules/ 目录。官方强调，手动复制规则时应该复制整个目录，而不是把文件平铺到同一个目录里，否则会出现同名文件覆盖和相对引用失效的问题。
命令大全
下面整理的是官方 README 中明确出现、并且对新手最有用的一组命令。个别命令在不同版本里可能增删，使用时请以官方 README 为准。
| 命令 | 作用 | 示例 | 注意事项 |
|---|---|---|---|
./install.sh --profile full | 一次性安装完整配置 | ./install.sh --profile full | 这个“full”不只是规则，官方仓库里已经明确包含更多模块，先确认影响范围 |
./install.sh typescript | 安装 TypeScript 相关配置 | ./install.sh typescript | 也可叠加其他语言参数，具体以官方 README 为准 |
.\install.ps1 --profile full | Windows 上安装完整配置 | .\install.ps1 --profile full | 适合 PowerShell 环境 |
.\install.ps1 typescript | Windows 上安装语言配置 | .\install.ps1 typescript | 记得在 PowerShell 下执行 |
npx ecc-install typescript | npm 兼容入口 | npx ecc-install typescript | 官方 README 提到它是跨平台兼容入口，参数变化请看 README |
/plugin marketplace add ... | 添加仓库到 Claude Code 市场 | /plugin marketplace add https://github.com/affaan-m/everything-claude-code | Claude Code 命令要一条一条输入，不要整段粘贴 |
/plugin install everything-claude-code@everything-claude-code | 安装插件 | /plugin install everything-claude-code@everything-claude-code | 依赖前一步 marketplace 已添加 |
/ecc:plan "..." | 插件安装后使用命名空间命令 | /ecc:plan "Add user authentication" | 这是 README 中展示的插件形态命令 |
/plan "..." | 手动安装时使用短命令 | /plan "Add user authentication" | 官方说明里，手动安装保留短命令形式 |
/plugin list everything-claude-code@everything-claude-code | 查看已安装插件 | /plugin list everything-claude-code@everything-claude-code | 适合确认插件是否生效 |
npm run dashboard | 打开桌面仪表盘 | npm run dashboard | 需要本地环境支持 GUI |
python3 ./ecc_dashboard.py | 用 Python 启动仪表盘 | python3 ./ecc_dashboard.py | README 中给出的替代启动方式 |
bash ./install.sh --target claude --modules hooks-runtime | 仅安装 Claude hook runtime | bash ./install.sh --target claude --modules hooks-runtime | 属于更细分的安装方式，适合只补钩子运行时的人 |
pwsh -File .\\install.ps1 --target claude --modules hooks-runtime | Windows 下安装 hook runtime | pwsh -File .\\install.ps1 --target claude --modules hooks-runtime | 仅在 Windows PowerShell 环境使用 |
npx ccg-workflow | 初始化多模型命令所需运行时 | npx ccg-workflow | 只对 multi-* 相关命令有意义，是否需要以官方 README 为准 |
推荐工作流
对新手来说，比较稳妥的顺序是：
- 先确认你的 Claude Code 可以正常运行。
- 先用插件安装，快速感受整个生态。
- 再根据项目语言，补上规则和语言目录。
- 确认
agents、skills、hooks、commands是否都能被 Claude Code 识别。 - 有需要再安装仪表盘和多模型工作流。
如果你是从“想让 AI 更懂我的项目”开始的，建议优先安装：
- 通用规则
rules/common - 你当前项目语言对应的规则目录
- 最常用的技能和命令
如果你是从“想做团队协作和多轮执行”开始的，再去看 hooks、agents 和 multi-model 扩展。
安全建议
这个项目非常强，但也意味着影响面更大，所以安装时要比普通小工具更谨慎：
- 不要在不了解后果的情况下直接执行完整
full安装。 - 不要把规则目录里的文件平铺复制，官方明确提醒这样会破坏相对引用。
- 不要把真实密钥写进示例配置。
- 不要默认所有模块都适合你的项目，先看清楚当前仓库用到了什么语言和工作流。
- 不要把更新频率很高的命令当成稳定 API，遇到不确定的部分直接回到官方 README。
如果你要把它用到团队环境，最好先在单个项目里试跑，再推广到全局配置。
排错
1. 插件安装后命令不生效
先确认插件是否真的被加载：
/plugin list everything-claude-code@everything-claude-code如果没有，重新检查 marketplace 和 install 两步是否都执行了。
2. 手动复制规则后出现覆盖
大概率是把目录里的文件直接拍平了。正确做法是保留目录层级，尤其是 rules/common 和语言目录。
3. multi-* 命令不能用
官方 README 已经说明，这些命令需要额外的 ccg-workflow 运行时。不要只装基础插件就期待它们自动可用。
4. 仪表盘打不开
先确认本机是否支持 GUI，再尝试：
npm run dashboard或者：
python3 ./ecc_dashboard.py5. 不确定当前命令是不是最新版
直接回到官方 README 看当前支持列表。这个仓库更新节奏快，命令和安装参数都有可能变化。
总结
everything-claude-code 的核心价值，不在于“多几个命令”，而在于它把 Claude Code 的能力拆成了可组合、可安装、可自动化的一整套体系。对于新手，最推荐的路径是先插件安装，再逐步补规则和语言目录；对于更进阶的用户，手动安装能提供更高的控制感。
如果你想把 Claude Code 真正变成生产力工具，而不是只把它当聊天框，这个项目值得认真看一遍。