安装配置 - ECC 帮助中心

系统要求

项目	要求
Claude Code CLI	v2.1.0 或更高版本
Node.js	v18.0.0 或更高版本
操作系统	Windows / macOS / Linux
包管理器	npm / pnpm / yarn / bun（任选其一）

⚠️ 版本检查

# 检查 Claude Code 版本
claude --version

# 检查 Node.js 版本
node --version

安装方式

方式一：插件安装（推荐）

最简单的安装方式，通过 Claude Code 的插件系统直接安装：

Step 1: 添加市场

# 在 Claude Code 中执行
/plugin marketplace add affaan-m/everything-claude-code

Step 2: 安装插件

/plugin install everything-claude-code@everything-claude-code

Step 3: 安装 Rules

ℹ️ 重要提示

Claude Code 插件系统无法自动分发 Rules，需要手动安装：

# 克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

# 安装依赖
npm install

Step 4: 安装语言 Rules

# 安装 TypeScript 规则
.\install.ps1 typescript

# 安装 Python 规则
.\install.ps1 python

# 安装多个语言
.\install.ps1 typescript python golang

# 安装到 Cursor IDE
.\install.ps1 --target cursor typescript

# 安装 TypeScript 规则
./install.sh typescript

# 安装 Python 规则
./install.sh python

# 安装多个语言
./install.sh typescript python golang

# 安装到 Cursor IDE
./install.sh --target cursor typescript

Step 5: 验证安装

# 列出已安装的插件
/plugin list everything-claude-code@everything-claude-code

# 尝试执行命令
/feature-development 测试功能

方式二：手动安装

手动复制文件，适合需要精细控制的用户：

Step 1: 克隆仓库

git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

Step 2: 复制 Agents

# 复制所有 agents 到用户配置目录
cp agents/*.md ~/.claude/agents/

Step 3: 复制 Rules

# 创建 rules 目录
mkdir -p ~/.claude/rules

# 复制通用规则（必装）
cp -r rules/common/* ~/.claude/rules/

# 复制语言规则（按需）
cp -r rules/typescript/* ~/.claude/rules/
cp -r rules/python/* ~/.claude/rules/
cp -r rules/golang/* ~/.claude/rules/

Step 4: 复制 Commands

mkdir -p ~/.claude/commands
cp commands/*.md ~/.claude/commands/

Step 5: 复制 Skills

mkdir -p ~/.claude/skills
cp -r skills/* ~/.claude/skills/

Step 6: 配置 Hooks

将 hooks/hooks.json 中的内容复制到你的 ~/.claude/settings.json：

# 查看 hooks 配置
cat hooks/hooks.json

# 编辑 settings.json
# 将 hooks 内容合并到你的配置中

方式三：NPM 包安装

通过 npm 包管理器安装：

ECC Universal

# 全局安装
npm install -g ecc-universal

# 或者在项目中安装
npm install ecc-universal --save-dev

AgentShield（安全审计工具）

# 快速扫描（无需安装）
npx ecc-agentshield scan

# 自动修复
npx ecc-agentshield scan --fix

# 深度分析（使用 Opus 4.6）
npx ecc-agentshield scan --opus --stream

NPM 安装后使用

# 使用安装脚本
npx ecc-install typescript

语言支持

ECC 支持多种编程语言，按需安装对应的 Rules：

语言	安装命令	包含内容
TypeScript	`.\install.ps1 typescript`	coding-style, patterns, security, testing, hooks
Python	`.\install.ps1 python`	coding-style, patterns, security, testing, hooks
Go	`.\install.ps1 golang`	coding-style, patterns, security, testing, hooks
Swift	`.\install.ps1 swift`	coding-style, patterns, security, testing, hooks
PHP	`.\install.ps1 php`	coding-style, patterns, security, testing, hooks
Java	`.\install.ps1 java`	coding-style, patterns, security, testing
Kotlin	`.\install.ps1 kotlin`	coding-style, patterns, security, testing
Rust	`.\install.ps1 rust`	coding-style, patterns, security, testing
C++	`.\install.ps1 cpp`	coding-style, patterns, testing

💡 提示

common 规则会自动安装，包含语言无关的通用规则（git-workflow、testing、security 等）。

平台目标

除了 Claude Code，ECC 还支持其他 AI 编程工具：

平台	安装命令	支持程度
Claude Code	`.\install.ps1 typescript`	✅ 完整支持
Cursor IDE	`.\install.ps1 --target cursor typescript`	✅ 完整支持
OpenCode	`.\install.ps1 --target opencode typescript`	✅ 完整支持
Codex	参考 `.codex/` 目录	✅ 参考配置
Antigravity	`.\install.ps1 --target antigravity typescript`	✅ 完整支持

包管理器配置

ECC 自动检测你的包管理器偏好，优先级如下：

环境变量：CLAUDE_PACKAGE_MANAGER
项目配置：.claude/package-manager.json
package.json：packageManager 字段
锁文件检测：package-lock.json、yarn.lock、pnpm-lock.yaml、bun.lockb
全局配置：~/.claude/package-manager.json
默认值：第一个可用的包管理器

设置包管理器

# 通过环境变量
export CLAUDE_PACKAGE_MANAGER=pnpm

# 通过脚本设置（全局）
node scripts/setup-package-manager.js --global pnpm

# 通过脚本设置（项目）
node scripts/setup-package-manager.js --project bun

# 检测当前设置
node scripts/setup-package-manager.js --detect

Hook 配置

通过环境变量控制 Hook 行为：

# Hook 严格度配置（默认：standard）
export ECC_HOOK_PROFILE=standard    # standard | minimal | strict

# 临时禁用特定 Hook
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

Profile	说明
`minimal`	仅运行核心安全检查
`standard`	默认配置，平衡功能和性能
`strict`	所有检查，包括格式化和类型检查

验证安装

# 检查 Claude Code 版本
claude --version

# 列出已安装的插件
/plugin list

# 测试命令
/feature-development 测试功能

# 测试 Agent
# 在对话中请求使用特定 Agent
"使用 code-reviewer Agent 审查当前代码"

常见问题

❓ Hooks 不工作 / 出现 "Duplicate hooks file" 错误

不要在 .claude-plugin/plugin.json 中添加 "hooks" 字段。Claude Code v2.1+ 会自动加载 hooks/hooks.json。

❓ 上下文窗口缩小 / Claude 运行时内存不足

禁用未使用的 MCP 服务器：

// 在项目的 .claude/settings.json 中
{
  "disabledMcpServers": ["supabase", "railway", "vercel"]
}

保持启用的 MCP 不超过 10 个，活动工具不超过 80 个。

❓ 可以只安装部分组件吗？

可以。使用手动安装方式，只复制你需要的组件：

# 只安装 Agents
cp agents/*.md ~/.claude/agents/

# 只安装 Rules
cp -r rules/common/* ~/.claude/rules/

下一步

📦 安装配置

系统要求

安装方式

方式一：插件安装（推荐）

Step 1: 添加市场

Step 2: 安装插件

Step 3: 安装 Rules

Step 4: 安装语言 Rules

Step 5: 验证安装

方式二：手动安装

Step 1: 克隆仓库

Step 2: 复制 Agents

Step 3: 复制 Rules

Step 4: 复制 Commands

Step 5: 复制 Skills

Step 6: 配置 Hooks

方式三：NPM 包安装

ECC Universal

AgentShield（安全审计工具）

NPM 安装后使用

语言支持

平台目标

包管理器配置

设置包管理器

Hook 配置

验证安装

常见问题

❓ Hooks 不工作 / 出现 "Duplicate hooks file" 错误

❓ 上下文窗口缩小 / Claude 运行时内存不足

❓ 可以只安装部分组件吗？

下一步