第二章 Claude Code 保姆级原理+真实用法

让Claude Code真正成为能帮你提升工作效率的“员工”​

​

​

第一步：安装插件​

​

代码块​

JSON

# 添加市场​

/plugin marketplace add ht***://github.c**/affaan-m/everything-claude-code​

# 安装插件​

/plugin install ecc@ecc​

​

​

​

​

🔦

说明：marketplace/plugin 是按规范化插件标识符寻址的，因此 ECC 现在统一为 ecc@ecc，让工具名和 slash command 命名空间保持简短。​

​

第二步：仅在需要时安装规则​

​

⚠️

重要提示： Claude Code 插件无法自动分发 rules。​

如果你已经通过 /plugin install 安装了 ECC，不要再运行 ./install.sh --profile full、.\install.ps1 --profile full 或 npx ecc-install --profile full。插件已经会自动加载 ECC 的技能、命令和 hooks；此时再执行完整安装，会把同一批内容再次复制到用户目录，导致技能重复以及运行时行为重复。​

对于插件安装路径，请只手动复制你需要的 rules/ 目录。只有在你完全不走插件安装、而是选择“纯手动安装 ECC”时，才应该使用完整安装器。​

​

​

​

​

代码块​

Markdown

# 首先克隆仓库​

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

cd everything-claude-code​

​

# 安装依赖（选择你常用的包管理器）​

npm install # 或：pnpm install | yarn install | bun install​

​

# 插件安装路径：只复制规则​

mkdir -p ~/.claude/rules​

cp -R rules/common ~/.claude/rules/​

cp -R rules/typescript ~/.claude/rules/​

​

# 纯手动安装 ECC（不要和 /plugin install 叠加）​

# ./install.sh --profile full​

​

​

代码块​

Markdown

# Windows 系统（PowerShell）​

​

# 插件安装路径：只复制规则​

New-Item -ItemType Directory -Force -Path "$HOME/.claude/rules" | Out-Null​

Copy-Item -Recurse rules/common "$HOME/.claude/rules/"​

Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"​

​

# 纯手动安装 ECC（不要和 /plugin install 叠加）​

# .\install.ps1 --profile full​

# npx ecc-install --profile full​

​

如需手动安装说明，请查看 rules/ 文件夹中的 README 文档。手动复制规则文件时，请直接复制整个语言目录（例如 rules/common 或 rules/golang），而非目录内的单个文件，以保证相对路径引用正常、文件名不会冲突。​

​

第三步：开始使用​

​

代码块​

Markdown

# 尝试一个命令（插件安装使用命名空间形式）​

/ecc:plan "添加用户认证"​

​

# 手动安装（选项2）使用简短形式：​

# /plan "添加用户认证"​

​

# 查看可用命令​

/plugin list ecc@ecc​

​

完成！ 你现在可以使用 60 个代理、229 个技能和 75 个命令。​

multi-* 命令需要额外配置​

​

WARNING: 上面的基础插件 / rules 安装不包含 multi-* 命令所需的运行时。​

如果要使用 /multi-plan、/multi-execute、/multi-backend、/multi-frontend 和 /multi-workflow，还需要额外安装 ccg-workflow 运行时。​

可通过 npx ccg-workflow 完成初始化安装。​

​

​

​

跨平台支持​

该插件现已全面支持 Windows、macOS 和 Linux，并与主流 IDE（Cursor、OpenCode、Antigravity）及命令行工具深度集成。所有钩子与脚本均已使用 Node.js 重写，以实现最佳兼容性。​

包管理器检测​

插件自动检测你首选的包管理器（npm、pnpm、yarn 或 bun），优先级如下：​

环境变量: CLAUDE_PACKAGE_MANAGER​

项目配置: .claude/package-manager.json​

package.json: packageManager 字段​

锁文件: 从 package-lock.json、yarn.lock、pnpm-lock.yaml 或 bun.lockb 检测​

全局配置: ~/.claude/package-manager.json​

回退: 第一个可用的包管理器​

要设置你首选的包管理器：​

​

代码块​

Markdown

# 通过环境变量​

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​

​

或在 Claude Code 中使用 /setup-pm 命令。​

钩子运行时控制​

使用运行时标记调整严格度或临时禁用特定钩子：​

​

代码块​

JSON

# 钩子严格度配置文件（默认值：standard）​

export ECC_HOOK_PROFILE=standard​

​

# 以英文逗号分隔的钩子 ID 列表，用于禁用指定钩子​

export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"​

​

里面有什么​

这个仓库是一个 Claude Code 插件 - 直接安装或手动复制组件。​

​

代码块​

Python

​

生态系统工具​

技能创建器​

两种从你的仓库生成 Claude Code 技能的方法：​

选项 A：本地分析（内置）​

使用 /skill-create 命令进行本地分析，无需外部服务：​

/skill-create # 分析当前仓库​

/skill-create --instincts # 还为 continuous-learning 生成直觉​

这在本地分析你的 git 历史并生成 SKILL.md 文件。​

选项 B：GitHub 应用（高级）​

用于高级功能（10k+ 提交、自动 PR、团队共享）：​

安装 GitHub 应用 | ecc.tools​

在任何问题上评论：​

/skill-creator analyze​

​

或在推送到默认分支时自动触发​

两个选项都创建：​

•

SKILL.md 文件 - 可直接用于 Claude Code 的技能​

•

直觉集合 - 用于 continuous-learning-v2​

•

模式提取 - 从你的提交历史中学习​

AgentShield — 安全审计工具​

​

于 Claude Code 黑客松（Cerebral Valley x Anthropic，2026 年 2 月）开发完成。包含 1282 项测试、98% 覆盖率、102 条静态分析规则。​

​

扫描你的 Claude Code 配置，检测漏洞、错误配置与注入风险。​

快速扫描（无需安装）​

npx ecc-agentshield scan​

​

自动修复安全问题​

npx ecc-agentshield scan --fix​

​

调用 3 个 Opus 4.6 智能体进行深度分析​

npx ecc-agentshield scan --opus --stream​

​

从零生成安全配置​

npx ecc-agentshield init​

扫描范围： CLAUDE.md、settings.json、MCP 配置、钩子、智能体定义与技能模块，覆盖 5 大类别 —— 密钥检测（14 种模式）、权限审计、钩子注入分析、MCP 服务风险评估、智能体配置审查。​

--opus 参数：启动 3 个 Claude Opus 4.6 智能体组成红队/蓝队/审计管道。攻击者寻找利用链，防御者评估防护机制，审计者综合生成优先级风险报告。采用对抗推理，而非单纯模式匹配。​

输出格式： 终端（彩色等级 A-F）、JSON（CI 流水线）、Markdown、HTML。发现严重问题时返回退出码 2，可用于构建门禁。​

在 Claude Code 中使用 /security-scan 运行，或通过 GitHub Action 集成到 CI。​

GitHub | npm​

持续学习 v2​

基于直觉的学习系统自动学习你的模式：​

​

代码块​

Bash

​

环境要求​

Claude Code 命令行版本​

最低版本：v2.1.0 或更高​

由于插件系统处理钩子的机制发生变更，本插件要求 Claude Code CLI 版本不低于 v2.1.0。​

查看当前版本：​

claude --version​

重要提示：钩子自动加载机制​

​

警告：贡献者请注意：请勿在 .claude-plugin/plugin.json 中添加 "hooks" 字段。回归测试已强制禁止该操作。​

​

Claude Code v2.1+ 会按照约定自动加载已安装插件中的 hooks/hooks.json。若在 plugin.json 中显式声明该文件，会触发重复检测错误：​

​

代码块​

Plain Text

检测到重复的钩子文件：./hooks/hooks.json 指向已加载的文件​

​

历史说明：该问题曾在本仓库中引发多次「修复-回滚」循环（#29、#52、#103）。因 Claude Code 版本间行为变更导致混淆，现已添加回归测试，防止该问题再次出现。​

​

​

安装​

选项 1：作为插件安装（推荐）​

使用此仓库的最简单方法 - 作为 Claude Code 插件安装：​

​

代码块​

JSON

​

或直接添加到你的 ~/.claude/settings.json：​

​

代码块​

JSON

{​

"extraKnownMarketplaces": {​

"ecc": {​

"source": {​

"source": "github",​

"repo": "affaan-m/everything-claude-code"​

}​

}​

​

这让你可以立即访问所有命令、代理、技能和钩子。​

​

注意： Claude Code 插件系统不支持通过插件分发 rules（上游限制）。你需要手动安装规则：​

​

​

代码块​

Markdown

# 首先克隆仓库​

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

​

# 方案 A：用户级规则（对所有项目生效）​

mkdir -p ~/.claude/rules​

cp -r everything-claude-code/rules/common ~/.claude/rules/​

cp -r everything-claude-code/rules/typescript ~/.claude/rules/ # 选择你使用的技术栈​

cp -r everything-claude-code/rules/python ~/.claude/rules/​

cp -r everything-claude-code/rules/golang ~/.claude/rules/​

​

选项 2：手动安装​

如果你希望手动控制安装内容，可按以下步骤操作：​

​

代码块​

Markdown

# 克隆仓库​

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

​

# 将智能体文件复制到 Claude 配置目录​

cp everything-claude-code/agents/*.md ~/.claude/agents/​

​

# 复制规则目录（通用规则 + 特定语言规则）​

mkdir -p ~/.claude/rules​

​

将钩子配置添加到 settings.json​

仅适用于手动安装：如果你没有通过 Claude 插件方式安装 ECC，可以将 hooks/hooks.json 中的钩子配置复制到你的 ~/.claude/settings.json 文件中。​

如果你是通过 /plugin install 安装 ECC，请不要再把这些钩子复制到 settings.json。Claude Code v2.1+ 会自动加载插件中的 hooks/hooks.json，重复注册会导致重复执行以及 ${CLAUDE_PLUGIN_ROOT} 无法解析。​

配置 MCP 服务​

从 mcp-configs/mcp-servers.json 中复制需要的 MCP 服务定义，粘贴到官方 Claude Code 配置文件 ~/.claude/settings.json 中； 若需要仓库本地的 MCP 访问权限，可粘贴到项目级配置文件 .mcp.json 中。​

如果你已自行运行 ECC 捆绑的 MCP 服务，设置以下环境变量：​

​

代码块​

JSON

​

ECC 托管的安装程序和 Codex 同步流程将跳过或移除这些服务，避免重复添加。​

重要提示：将配置中的 YOUR_*_HERE 占位符替换为你真实的 API 密钥。​

​

​

关键概念​

代理​

子代理以有限范围处理委托的任务。示例：​

​

代码块​

YAML

---​

name: code-reviewer​

description: 审查代码的质量、安全性和可维护性​

tools: ["Read", "Grep", "Glob", "Bash"]​

​

技能​

技能是由命令或代理调用的工作流定义：​

​

代码块​

JSON

# TDD 工作流​

​

1. 首先定义接口​

2. 编写失败的测试（RED）​

3. 实现最少的代码（GREEN）​

4. 重构（IMPROVE）​

5. 验证 80%+ 的覆盖率​

​

钩子​

钩子在工具事件时触发。示例 - 警告 console.log：​

​

代码块​

SQL

{​

"matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",​

"hooks": [{​

"type": "command",​

"command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] 移除 console.log' >&2"​

}]​

}​

​

规则​

规则是始终遵循的指南，分为 common/（通用）+ 语言特定目录：​

​

代码块​

JSON

​

运行测试​

插件包含一个全面的测试套件：​

​

代码块​

JSON

# 运行所有测试​

node tests/run-all.js​

​

# 运行单个测试文件​

node tests/lib/utils.test.js​

node tests/lib/package-manager.test.js​

node tests/hooks/hooks.test.js​

​

​