Appearance
Everything Claude Code 是一套面向 Claude Code、Codex、Cursor 等 AI 编程助手的生产级插件体系,内含 38 个专业 Agent、156 个 Skill、72 个 Command 及自动化 Hook 体系。本文将详细介绍其 Selective Install 选择性安装架构、多平台(macOS/Linux/Windows)部署方式、Profiles 配置、按语言/技能定制安装,以及如何通过 configure-ecc 交互式向导高效完成环境搭建和个性化优化,助力开发者系统性提升 AI 辅助编程效率。
Everything Claude Code 安装配置指南:Selective Install、多平台部署与 configure-ecc 向导
Everything Claude Code(ECC)是当前最系统化的 AI 编程助手增强插件库,支持 Claude Code、Cursor、Codex、OpenCode、Antigravity 等主流 AI harness,经过 10 个月生产实践,沉淀出 38 个专业 Agent、156 个 Skill、72 个 Command 及完善的自动化 Hook/Rules 体系。它不仅仅是配置集合,更是一个可持续进化的 AI 编程工作流优化系统,极大提升 AI 辅助编程的专业性、安全性与可维护性。本文将围绕安装策略、组件选择、跨平台部署和交互式配置向导,帮助你高效完成从零到生产级的 ECC 环境搭建。
推荐先阅读 Everything Claude Code 完全指南:38 Agent + 156 Skill 的生产级 AI 编程插件 获取整体架构与能力全貌。
1. 安装策略演进:从全量到 Selective Install
1.1 传统全量安装的局限
ECC 早期安装方式为“全量复制”,即一次性将全部 agents/skills/commands/rules/hook 目录复制到本地(如 ~/.claude/),虽然简单直接,但带来以下问题:
- 体积大:复制了大量用不到的技能/规则,浪费磁盘与同步资源。
- 升级难:后续变更难以追踪,卸载/修复不够精细。
- 定制性差:不同项目/团队对语言、框架、业务领域的需求差异大,无法按需裁剪。
1.2 Selective Install 架构
自 v1.9.0 起,ECC 引入了 Selective Install 选择性安装架构,通过模块化清单(manifest)和 Profiles 配置,允许你只安装所需的核心组件、特定语言/框架支持或业务领域技能。其核心机制包括:
- 模块/组件清单:
manifests/install-modules.json、manifests/install-components.json记录所有可选模块、依赖关系与目标平台。 - Profile 预设:
manifests/install-profiles.json提供 core、developer、security、research、full 等多种典型安装方案,快速适配不同用户需求。 - 安装状态持久化:每次安装都会记录“安装意图-实际操作-目标路径”,便于后续 repair/uninstall/doctor 等生命周期管理。
- 跨平台统一 CLI:所有安装、升级、修复、卸载操作都可通过 Node.js 脚本统一管理,支持 macOS、Linux、Windows。
详细原理可参考 ECC 的 Selective Install 架构设计文档。
2. Profiles 体系:四大安装模式详解
ECC 的 Profile 体系让你无需手动挑选每个模块,直接按场景一键安装。主要包括:
| Profile | 适用场景 | 包含模块(部分) |
|---|---|---|
| core | 最小可用/基础配置 | 规则、核心 agents、commands、hooks、平台配置、质量工作流 |
| developer | 推荐给大多数开发者 | core + 语言/框架技能(如 TS/Go/Python/Java)+ 数据库 + Orchestration |
| security | 安全优先型 | core + 安全相关技能/规则 |
| research | 内容创作/调研/市场分析 | core + research-apis + business-content + social-distribution |
| full | 全量安装(所有模块) | 包含全部已分类模块 |
示例:选择 developer profile 安装
bash
# macOS/Linux
./install.sh --profile developer
# Windows PowerShell
.\install.ps1 --profile developer按需语言/框架选择
如只需 TypeScript 和 Python 相关支持:
bash
./install.sh typescript python
# 或
.\install.ps1 typescript pythonProfile 机制有效避免了“装太多”或“装太少”的两难,适合从入门到深度定制的各类团队。
3. 按语言/技能选择安装
ECC 支持按语言、框架、业务域精细化安装。常见选择包括:
- 语言支持:TypeScript/JavaScript、Python、Go、Java、Kotlin、C++、Rust、Swift、PHP、Perl、C# 等
- 框架支持:Django、Spring Boot、Laravel、Next.js、React、Flutter、Ktor 等
- 业务/领域技能:数据库优化、API 设计、内容运营、市场调研、AI 媒体生成、供应链/物流等
示例:仅安装 Python 相关技能与规则
bash
./install.sh python
# 或
.\install.ps1 python示例:定制安装部分技能
通过 configure-ecc 向导(见下文),可在交互界面逐项勾选/排除具体技能,实现“只装我需要的”极致定制。
4. 跨平台部署:macOS/Linux/Windows 全覆盖
ECC 的安装脚本和 CLI 工具已全面支持主流开发平台:
- macOS/Linux:使用
install.sh脚本或npx ecc-install命令 - Windows:使用
install.ps1PowerShell 脚本,或npx ecc-install - 自动检测包管理器:支持 npm、pnpm、yarn、bun,自动识别优先级(可通过环境变量/配置文件指定)
示例:全量安装(full profile)
bash
# macOS/Linux
./install.sh --profile full
# Windows
.\install.ps1 --profile full
# 跨平台通用
npx ecc-install --profile full多 IDE/Harness 支持
ECC 针对 Cursor、Codex、OpenCode、Antigravity 等主流 AI harness 提供专用 target 适配,确保不同平台/项目结构下都能无缝集成。
5. configure-ecc Skill:交互式安装与个性化优化
5.1 交互式向导入口
ECC 提供了 configure-ecc 交互式 Skill(技能),支持在 Claude Code 内直接对话式完成安装、校验与优化。适合初次安装、升级迁移、或对现有配置进行“体检”。
激活方式:
- 插件用户:
/plugin install everything-claude-code后自动加载 - 手动用户:复制
skills/configure-ecc/SKILL.md至~/.claude/skills/configure-ecc/,对 Claude 说“configure ecc”即可
5.2 向导流程概览
- 克隆最新 ECC 源码(自动或指定本地路径)
- 选择安装层级(用户级 ~/.claude/、项目级 .claude/、或两者结合)
- 选择技能范围(核心/全部/自定义类别/逐项勾选)
- 选择规则集(common 规则、各语言规则多选)
- 自动校验与依赖检查(路径、引用、技能依赖关系等)
- 个性化优化(可选:剔除无关内容、调整路径、定制规则目标等)
- 安装总结报告(输出已装内容、发现/修复问题、优化措施)
详细流程与交互逻辑可参考 configure-ecc Skill 文档。
5.3 个性化 Skill 推荐
安装后,建议运行 workspace-surface-audit Skill,对当前项目代码仓库进行自动审计,智能推荐最具价值的 ECC 组件组合,实现“按需装,装得准”。
6. 安装后体验与进阶用法
- 所有已装 Agent/Skill/Command 可通过
/plugin list everything-claude-code@everything-claude-code查询 - Skill 为主力入口,Command 兼容 slash 命令习惯,Agent 负责专业分工
- Hooks/Rules 自动驱动质量门控、安全审计、上下文优化等自动化流程
- 可通过
ecc doctor、ecc repair、ecc uninstall等 CLI 命令进行后续维护与升级
更多进阶技巧详见 Claude Code 高级技巧:Token 优化、记忆持久化、并行化与验证循环 及 Everything Claude Code Hooks 实战:PreToolUse / PostToolUse / Stop 事件驱动自动化完全配置。
FAQ
Q: 安装 ECC 时如何只装我需要的语言或技能?
A: 推荐用 configure-ecc 交互式向导或 install.sh/install.ps1 脚本指定语言(如 ./install.sh python),也可通过 profile 精细选择。
Q: Windows 下如何安装 ECC?
A: 直接运行 .\install.ps1 或 npx ecc-install,流程与 macOS/Linux 一致,支持 PowerShell 全自动操作。
Q: 项目级和用户级规则/技能如何选择?
A: 用户级(~/.claude/)适用于所有项目,项目级(.claude/)仅对当前仓库生效。可通过 configure-ecc 向导灵活选择或同时部署。
通过本指南,你可以根据自身团队/项目需求,灵活、可控、高效地完成 Everything Claude Code 的安装与个性化配置,充分发挥其在 AI 辅助编程中的生产力优势。