Everything Claude Code 本地化配置手册

基于 GitHub 项目 affaan-m/everything-claude-code 的详细配置指南
版本：v1.8.0 | 更新日期：2026 年 3 月
适用环境：Windows 11

---

📖 目录

1. 项目概述
2. 环境要求
3. 系统架构
4. 详细安装指南（模块化手动安装）
5. 核心组件配置
6. MCP 服务器配置（中国用户适用）
7. 实战演练
8. 最佳实践
9. 故障排除
10. 附录

---

项目概述

什么是 Everything Claude Code (ECC)？

ECC 是一个生产级的 AI 编程增强系统，由 Anthropic 黑客马拉松冠军开发，经过 10 多个月的密集日常使用和真实产品开发演化而来。

它能解决什么问题？

1. 记忆问题 - 对话变长或隔天再打开，AI 就忘了项目架构和决策
2. 随性派问题 - 需要反复强调编码规范，消耗 Token 和耐心
3. 缺乏工程直觉 - 原生 Claude Code 很强，但不懂你的项目习惯

核心价值：

• ✅ 持久化记忆 - Hooks 自动保存项目上下文
• ✅ 标准化工作流 - 统一的编码规范和检查机制
• ✅ 自动化检查 - 代码审查、安全检查、格式化
• ✅ 持续学习 - 从会话中自动提取模式

核心理念

1. 代理优先 (Agent-First) - 将复杂任务委托给专业子代理
2. 测试驱动 (TDD) - 先写测试，80%+ 覆盖率要求
3. 安全优先 (Security-First) - 绝不妥协的安全检查
4. 不可变性 (Immutability) - 从不修改现有对象
5. 计划先行 (Plan Before Execute) - 复杂功能先规划后实现

---

环境要求

系统： Windows 10/11
Claude Code CLI 版本： v2.1.0 或更高

# 检查 Claude Code 版本
claude --version

前置工具：

• Git（用于克隆仓库）
• nodejs

---

系统架构

目录结构

everything-claude-code/
├── .claude-plugin/          # 插件元数据
│   ├── plugin.json          # 插件配置
│   └── marketplace.json     # 市场目录
│
├── agents/                  # 22 个专业子代理
│   ├── planner.md           # 功能实现规划（架构师模式）
│   ├── architect.md         # 系统架构设计
│   ├── tdd-guide.md         # 测试驱动开发
│   ├── code-reviewer.md     # 代码质量审查
│   ├── security-reviewer.md # 安全漏洞分析
│   ├── build-error-resolver.md
│   ├── e2e-runner.md        # E2E 测试
│   └── ... (更多语言专家)
│
├── skills/                  # 102 项技能
│   ├── coding-standards/    # 编码标准
│   ├── backend-patterns/    # 后端模式
│   ├── frontend-patterns/   # 前端模式
│   ├── continuous-learning-v2/  # 持续学习
│   ├── tdd-workflow/        # TDD 工作流
│   └── ... (按领域分类)
│
├── commands/                # 52 个命令
│   ├── plan.md              # /plan - 规划（核心命令）
│   ├── tdd.md               # /tdd - TDD
│   ├── code-review.md       # /code-review - 审查
│   └── ... (更多命令)
│
├── rules/                   # 规则系统
│   ├── common/              # 通用规则（必装）
│   │   ├── coding-style.md    # 编码风格
│   │   ├── security.md        # 安全指南
│   │   ├── testing.md         # 测试要求
│   │   └── git-workflow.md    # Git 工作流
│   ├── typescript/          # TS/JS 专用
│   ├── python/              # Python 专用
│   └── golang/              # Go 专用
│
├── hooks/                   # 自动化钩子
│   ├── hooks.json           # 钩子配置
│   └── memory-persistence/  # 内存持久化
│
├── mcp-configs/             # MCP 服务器配置
│   └── mcp-servers.json     # 14 个 MCP 服务器
│
└── scripts/                 # Node.js 脚本
    ├── hooks/               # 钩子实现
    └── lib/                 # 工具库

组件关系图

用户请求
    ↓
主代理 (Claude)
    ↓
┌───────────────────────────────────────┐
│  规则系统 (Rules) - 始终遵循的指南     │
│  ↓ 指导行为                            │
│  钩子系统 (Hooks) - 自动化触发         │
│  ↓ 验证/格式化/检查                    │
└───────────────────────────────────────┘
    ↓
┌───────────────────────────────────────┐
│  代理系统 (Agents) - 专业任务委托       │
│  ↓ 规划/架构/审查/测试                 │
│  技能系统 (Skills) - 工作流定义         │
│  ↓ TDD/安全审查/E2E 测试               │
└───────────────────────────────────────┘
    ↓
执行结果

---

详细安装指南（模块化安装）

本指南采用模块化安装方式，你可以根据需要选择安装哪些组件。每个步骤都有详细解释，方便你理解每个文件的作用和迁移到其他工具。

安装前准备

步骤 0：下载 ECC 项目文件

方法 1：使用 Git 克隆（推荐）

# 进入你想存放项目的目录
cd D:\Desktop

# 克隆 ECC 仓库到本地
# 解释：git clone 会下载整个项目到 everything-claude-code 文件夹
git clone https://github.com/affaan-m/everything-claude-code.git

# 进入项目目录
cd everything-claude-code

方法 2：手动下载 ZIP

1. 访问 https://github.com/affaan-m/everything-claude-code
2. 点击绿色的 “Code” 按钮
3. 选择 “Download ZIP”
4. 解压到你喜欢的位置（如 D:\Desktop\everything-claude-code）

下载后的目录结构：

everything-claude-code/
├── agents/              # 代理文件
├── skills/              # 技能文件
├── commands/            # 命令文件
├── rules/               # 规则文件
├── hooks/               # 钩子配置
├── mcp-configs/         # MCP 配置
├── scripts/             # 脚本文件
└── AGENTS.md            # 通用代理指令

---

模块 1：安装规则系统（Rules）

规则是什么？ 规则是 AI 必须遵循的编码规范，比如"不可变性"、“安全检查”、"测试要求"等。

安装位置： C:\Users\你的用户名\.claude\rules\

1.1 创建规则目录

方法 1：使用文件管理器（图形界面）

1. 进入：C:\Users\你的用户名\.claude
2. 如果没有 rules 文件夹，右键空白处 → 新建 → 文件夹 → 命名为 rules
3. 进入 rules 文件夹，创建 common 和 typescript 子文件夹

1.2 复制通用规则

通用规则包含：

• coding-style.md - 编码风格（不可变性、文件组织）
• security.md - 安全指南（无硬编码密钥、输入验证）
• testing.md - 测试要求（TDD、80% 覆盖率）
• git-workflow.md - Git 工作流（提交格式、PR 流程）

使用文件管理器复制

1. 打开下载的 ECC 项目文件夹
2. 复制 rules\common\ 文件夹
3. 导航到 C:\Users\你的用户名\.claude\rules
4. 按 Ctrl + V 粘贴这个文件夹

1.3 复制语言专用规则（根据技术栈选择）

可选语言：

• typescript/ - TypeScript/JavaScript 项目
• python/ - Python 项目
• golang/ - Go 项目
• swift/ - Swift 项目
• php/ - PHP 项目

为什么要分语言？ 不同语言有不同的最佳实践，比如 Python 的 PEP 8、Go 的惯用模式、TypeScript 的类型系统。

---

模块 2：安装代理系统（Agents）

代理是什么？ 代理是专业化的 AI 助手，比如 planner 负责规划、code-reviewer 负责审查代码。

安装位置： C:\Users\你的用户名\.claude\agents\

2.1 创建代理目录

打开文件管理器

1. 进入 C:\Users\你的用户名\.claude\
2. 创建 agents 文件夹

2.2 复制代理文件

1. 在 ECC 项目中，进入 agents\ 文件夹
2. 选择你需要的代理文件（建议全选）：
   • planner.md - 规划师（核心）
   • tdd-guide.md - TDD 教练
   • code-reviewer.md - 代码审查员
   • security-reviewer.md - 安全审查员
   • build-error-resolver.md - 构建错误修复
   • e2e-runner.md - E2E 测试
   • 其他语言专家（如 go-reviewer.md、python-reviewer.md）
3. 复制到 C:\Users\你的用户名\.claude\agents\

预期结果：

C:\Users\你的用户名\.claude\agents\
├── planner.md
├── tdd-guide.md
├── code-reviewer.md
├── security-reviewer.md
├── build-error-resolver.md
├── e2e-runner.md
└── ... (其他代理)

---

模块 3：安装技能系统（Skills）

技能是什么？ 技能是工作流定义和领域知识，比如 TDD 工作流、安全检查清单。

安装位置： C:\Users\你的用户名\.claude\skills\

3.1 创建技能目录

3.2 复制核心技能（推荐）

核心技能列表：

• tdd-workflow/ - TDD 工作流
• security-review/ - 安全检查清单
• coding-standards/ - 编码标准
• backend-patterns/ - 后端设计模式
• frontend-patterns/ - 前端设计模式

或者全部技能也可以

1. 在 ECC 项目中，进入 skills\ 文件夹
2. 选择你需要的技能文件夹
3. 复制整个文件夹到 C:\Users\你的用户名\.claude\skills\

模块 4：安装命令系统（Commands）

命令是什么？ 命令是斜杠命令，如 /plan、/tdd、/code-review。

安装位置： C:\Users\你的用户名\.claude\commands\

4.1 创建命令目录

4.2 复制命令文件

1. 在 ECC 项目中，进入 commands\ 文件夹
2. 选择所有 .md 文件
3. 复制到 C:\Users\你的用户名\.claude\commands\

模块 5：安装通用代理指令（AGENTS.md）

AGENTS.md 是什么？ 这是所有工具都能识别的通用指令文件，定义了 AI 的核心行为准则。

安装位置： 项目根目录（每个项目都需要）

5.1 复制到项目根目录

1. 在 ECC 项目根目录找到 AGENTS.md
2. 复制到你的项目根目录

为什么每个项目都需要？ AGENTS.md 定义了该项目的 AI 行为准则，比如使用什么技术栈、遵循什么规范。

---

模块 6：配置 MCP 服务器（可选）

MCP 是什么？ MCP (Model Context Protocol) 让 AI 能访问外部服务，比如 GitHub、数据库、文档查询。

配置位置： C:\Users\你的用户名\.claude.json

6.1 编辑配置文件

1. 添加以下内容：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "description": "持久化记忆（本地运行，无需网络）"
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"],
      "description": "链式思考推理（本地运行）"
    }
  }
}

6.2 添加更多 MCP 服务器

更多mcp建议在下文提供，选择你需要的服务器添加到配置中。

国内用户推荐：

• ✅ memory - 本地记忆（无需网络）
• ✅ sequential-thinking - 本地推理（无需网络）
• ✅ filesystem - 本地文件系统（无需网络）
• ⚠️ github - 需要 GitHub Token 和网络代理
• ⚠️ vercel - 需要网络代理

---

模块 7：配置钩子系统（可选）

钩子是什么？ 钩子是自动化脚本，比如编辑文件后自动格式化、会话结束时自动保存状态。

配置位置： C:\Users\你的用户名\.claude\settings.json

7.1 创建钩子配置

里面可能存在你之前配置的env，添加hooks即可

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "",
    "ANTHROPIC_BASE_URL": "",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "qwen3.5-plus",
    "availableModels": "qwen3.5-plus"
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [{
          "type": "command",
          "command": "npx prettier --write \"$file_path\""
        }],
        "description": "编辑后自动格式化"
      }
    ]
  }
}

关键钩子示例

1. 自动格式化

{
  "PostToolUse": [
    {
      "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\.(ts|tsx|js|jsx)$\"",
      "hooks": [{
        "type": "command",
        "command": "npx prettier --write \"$file_path\""
      }],
      "description": "编辑后自动格式化"
    }
  ]
}

2. console.log 检查

{
  "Stop": [
    {
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "grep -r 'console\\.log' --include=\"*.ts\" --include=\"*.tsx\" src/ && echo '[Hook] 移除 console.log'"
      }],
      "description": "检查遗留的 console.log"
    }
  ]
}

注意： 钩子系统需要 Node.js 环境，且不同工具的钩子格式可能不同。

---

✅ 验证安装

测试功能

# 启动 Claude Code
claude

# 测试命令（应该能看到提示）
/plan

# 测试skills，展示skills列表
/skills

# 测试Agents
/agents

# 测试hooks钩子
/hooks

---

📊 安装总结表

模块	必装？	安装位置	大小
规则（Rules）	✅ 必装	.claude\rules\	~50KB
代理（Agents）	✅ 推荐	.claude\agents\	~200KB
技能（Skills）	⚠️ 可选	.claude\skills\	10-50MB
命令（Commands）	⚠️ 可选	.claude\commands\	~100KB
AGENTS.md	✅ 必装	项目根目录	~10KB
MCP 配置	⚠️ 可选	.claude.json	~1KB
钩子配置	⚠️ 可选	.claude\settings.json	~1KB

最小安装： 规则 + 代理 + AGENTS.md（约 260KB）
推荐安装： 规则 + 代理 + 技能（核心）+ 命令 + AGENTS.md（约 10MB）
完整安装： 所有模块（约 50MB）

---

核心组件配置

1. 代理系统 (Agents)

代理是专业化的子助手，用于处理特定领域的任务。

核心代理列表

代理	用途	何时使用
planner ⭐	功能实现规划	复杂功能开发、重构
architect	系统架构设计	架构决策、系统设计
tdd-guide ⭐	测试驱动开发	新功能、Bug 修复
code-reviewer ⭐	代码质量审查	写完代码后立即审查
security-reviewer	安全漏洞检测	提交前、敏感代码
build-error-resolver	修复构建错误	构建失败时
e2e-runner	E2E 测试执行	关键用户流程测试
refactor-cleaner	死代码清理	代码维护
doc-updater	文档同步	更新文档

代理使用示例

# 规划新功能（核心用法！）
/plan "添加用户认证系统，支持 OAuth2"

# 测试驱动开发
/tdd "实现用户注册 API"

# 代码审查
/code-review "审查刚才写的认证模块"

# 安全审查
/security-scan "检查是否有安全漏洞"

# 修复构建
/build-fix "npm run build 失败了"

2. 命令系统 (Commands)

最常用命令

开发工作流：

/plan              # 创建实现计划（核心命令）
/tdd               # TDD 工作流
/code-review       # 代码审查
/build-fix         # 修复构建错误
/e2e               # E2E 测试生成
/refactor-clean    # 死代码清理

学习与管理：

/learn             # 从会话提取模式
/checkpoint        # 保存验证状态
/verify            # 运行验证循环
/sessions          # 查看会话历史

/plan 命令详解（核心功能）

使用场景：

• 开始新功能开发
• 进行架构重构
• 复杂需求分析

使用方法：

# 方式 1：直接带参数
/plan "使用 HTML5 和原生 JavaScript 写一个贪吃蛇游戏，界面要现代简洁，支持分数记录"

# 方式 2：先进入计划模式，再描述需求
/plan
# 然后输入需求描述

工作流程：

1. 需求分析 - Claude 会重述你的需求，确保理解正确
2. 架构设计 - 规划文件结构、技术选型、核心功能
3. 细节确认 - 主动询问模糊点（如地图大小、难度等）
4. 等待确认 - 必须得到你的明确确认后才开始写代码

示例输出：

# 实现计划：贪吃蛇游戏

## 需求重述
- 使用 HTML5 Canvas + 原生 JavaScript
- 现代简洁的深色界面
- 支持 WASD 和方向键操作
- 使用 localStorage 记录最高分

## 文件结构
- index.html (骨架)
- style.css (样式)
- game.js (游戏逻辑)

## 核心功能
1. 游戏循环 (60 FPS)
2. 蛇的移动和增长
3. 食物生成和碰撞检测
4. 分数系统和最高分记录
5. 游戏结束判定

## 技术细节
- 画布大小：400x400
- 网格大小：20x20（推荐）
- 配色方案：深色背景 (#1a1a2e) + 霓虹绿蛇身 (#00ff88)

## 风险点
- 浏览器兼容性
- 移动端适配（暂不支持）

**等待确认**: 是否按此计划执行？(yes/no/修改)

关键技巧：

• ✅ 先规划再写代码，避免"盲写"
• ✅ 仔细阅读计划，提出修改意见
• ✅ 确认后再开始执行
• ✅ 使用 Shift + Tab 选择"允许所有编辑"，避免重复确认

3. 规则系统 (Rules)

规则是始终遵循的编码指南。

通用规则 (common/)

coding-style.md - 编码风格

• 不可变性（CRITICAL）：从不修改现有对象
• 文件组织：多小文件 > 少大文件（200-400 行典型，800 行最大）
• 错误处理：显式处理所有错误
• 输入验证：在系统边界验证所有输入

security.md - 安全指南

• 禁止硬编码密钥
• 所有用户输入必须验证
• SQL 注入防护（参数化查询）
• XSS 防护（HTML 转义）
• CSRF 保护启用

testing.md - 测试要求

• TDD：先写测试
• 最低 80% 覆盖率
• 单元测试 + 集成测试 + E2E 测试

git-workflow.md - Git 工作流

• Conventional Commits：feat:, fix:, refactor:
• 小步提交
• PR 需要审查

4. 钩子系统 (Hooks)

钩子是自动触发的行为。

关键钩子示例

1. 自动格式化

{
  "PostToolUse": [
    {
      "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\.(ts|tsx|js|jsx)$\"",
      "hooks": [{
        "type": "command",
        "command": "npx prettier --write \"$file_path\""
      }],
      "description": "编辑后自动格式化"
    }
  ]
}

2. console.log 检查

{
  "Stop": [
    {
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "grep -r 'console\\.log' --include=\"*.ts\" --include=\"*.tsx\" src/ && echo '[Hook] 移除 console.log'"
      }],
      "description": "检查遗留的 console.log"
    }
  ]
}

---

MCP 服务器配置

提示

由于网络环境限制，部分海外 MCP 服务器在中国大陆可能无法正常使用。以下是针对中国用户的配置建议：

推荐使用的 MCP 服务器

推荐直接配置

# 记忆
claude mcp add memory -- npx -y @modelcontextprotocol/server-memory

# 文件受控访问，让claude在你指定的目录zh'xin
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem D:\Workspace\Projects # 改为你指定的目录

# 链式思考
claude mcp add sequential-thinking -- npx -y
@modelcontextprotocol/server-sequential-thinking

# 实时文档
claude mcp add context7 -- npx -y @upstash/context7-mcp@latest

# chrome浏览器自动化
claude mcp add chrome-devtools npx chrome-devtools-mcp@latest

1. 本地/国内可用服务

memory（记忆） - ✅ 推荐

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "description": "持久化记忆 - 本地运行，无需网络"
    }
  }
}

sequential-thinking（链式思考） - ✅ 推荐

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"],
      "description": "链式思考推理 - 本地运行"
    }
  }
}

filesystem（文件系统） - ✅ 推荐

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "D:/projects"],
      "description": "文件系统操作 - 本地运行"
    }
  }
}

context7（实时文档） - ⚠️ 可能需要代理

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"],
      "description": "实时文档查询"
    }
  }
}

chrome-devtools - 浏览器自动化

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest"]
    }
  }
}

2. 需要网络代理的 MCP 服务器

以下服务在中国大陆可能需要配置网络代理才能使用：

github - ⚠️ 需要代理

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "你的 GitHub Token"
      },
      "description": "GitHub 操作（需要网络代理）"
    }
  }
}

vercel - ⚠️ 需要代理

{
  "mcpServers": {
    "vercel": {
      "type": "http",
      "url": "https://mcp.vercel.com",
      "description": "Vercel 部署（需要网络代理）"
    }
  }
}

supabase - ⚠️ 需要代理

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "@supabase/mcp-server-supabase@latest", "--project-ref=YOUR_PROJECT_REF"],
      "description": "Supabase 数据库（需要网络代理）"
    }
  }
}

国内替代方案

1. 使用 Gitee 代替 GitHub

虽然目前没有官方的 Gitee MCP 服务器，但你可以通过以下方式实现类似功能：

# 使用 bash 命令代替
!gh pr create --title "feat: 新功能" --body "描述..."
!git push origin main

2. 使用国内云服务

腾讯云 CloudBase

# 安装腾讯云 CLI
npm install -g @cloudbase/cli

# 在 Claude 中使用
/cloudbase deploy

阿里云函数计算

# 安装阿里云 CLI
npm install -g @alicloud/fc-cli

3. 本地数据库

使用本地 PostgreSQL/MySQL 代替 Supabase：

{
  "mcpServers": {
    "postgres-local": {
      "command": "npx",
      "args": ["-y", "pg-mcp-server", "--connection-string=postgresql://localhost:5432/mydb"],
      "description": "本地 PostgreSQL"
    }
  }
}

网络代理配置

如果你有可用的网络代理，可以在 MCP 配置中指定：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "你的 Token",
        "HTTP_PROXY": "http://127.0.0.1:7890",
        "HTTPS_PROXY": "http://127.0.0.1:7890"
      }
    }
  }
}

⚠️ 上下文窗口管理警告

• 每个 MCP 工具描述都会消耗 token
• 200k 上下文窗口可能缩减到 70k
• 建议： 配置 5-10 个 MCP 即可，不要贪多

---

实战演练

实战 1：贪吃蛇游戏开发

这是博客中提到的经典示例，展示 ECC 的强大规划能力。

步骤 1：启动规划模式

/plan "使用 HTML5 和原生 JavaScript 写一个贪吃蛇游戏，界面要现代简洁，支持分数记录"

步骤 2：见证规划能力

Claude 不会直接写代码，而是会：

1. 需求分析 - 重述你的需求
2. 架构设计 - 规划文件结构
3. 细节确认 - 询问模糊点（如地图大小）

可能的输出：

# 实现计划：贪吃蛇游戏

## 需求重述
- 使用 HTML5 Canvas + 原生 JavaScript
- 现代简洁的深色界面
- 支持 WASD 和方向键操作
- 使用 localStorage 记录最高分

## 技术细节选择

请选择你偏好的配置：

1. 网格大小：
   - 20x20 (推荐) - 经典手感
   - 15x15 - 地图小，节奏快
   - 25x25 - 地图大，难度高

2. 游戏速度：
   - 中等 (推荐)
   - 快速
   - 可调节

请选择你的偏好（直接回复数字或选项）：

步骤 3：确认细节

选择推荐的选项：

1

步骤 4：查看最终计划

## 最终方案总结

### 文件结构
- index.html (骨架)
- style.css (皮肤)
- game.js (灵魂)

### 核心功能
1. 游戏循环 (60 FPS)
2. 蛇的移动和增长
3. 食物生成和碰撞检测
4. 分数系统和最高分记录
5. 游戏结束判定

### UI 设计
- 深色背景 (#1a1a2e)
- 霓虹绿蛇身 (#00ff88)
- 响应式布局

### 网格配置
- 20x20 格子
- 中等速度

**确认退出规划模式并开始实现吗？** (yes/no)

步骤 5：一键授权

关键技巧： 按 Shift + Tab 选择：

> 2. Yes, allow all edits during this session

这样可以避免每个文件都询问一次。

步骤 6：见证成果

几秒钟后，所有文件创建完成：

• index.html (约 20KB)
• style.css
• game.js

直接打开 index.html 即可运行游戏！

实战 2：Bug 修复工作流

# 步骤 1：重现并写测试
/tdd "写一个测试重现这个 bug：用户登录后积分没有增加"

# 步骤 2：实现修复
# Claude 会先写测试，然后实现修复

# 步骤 3：审查
/code-review "确保修复没有引入新问题"

# 步骤 4：验证
/verify "运行完整验证循环"

实战 3：代码重构

# 步骤 1：分析技术债务
/code-review "分析这个模块的技术债务和可改进点"

# 步骤 2：清理死代码
/refactor-clean "移除未使用的导入和死代码"

# 步骤 3：验证覆盖率
/test-coverage "确保重构后覆盖率仍然达标"

---

---

故障排除

常见问题

1. 钩子不工作 / "重复钩子文件"错误

问题： 看到错误提示 Duplicate hooks file detected

解决方案：
不要在 .claude-plugin/plugin.json 中添加 "hooks" 字段。Claude Code v2.1+ 会自动加载插件的 hooks/hooks.json。

2. 上下文窗口不足

症状： Claude 频繁提示上下文不足

解决方案：

# 检查启用的 MCP
/mcp

# 禁用未使用的 MCP（在项目配置中）
{
  "disabledMcpServers": ["supabase", "railway", "vercel"]
}

# 手动压缩
/compact

# 重置会话
/clear

3. 规则未生效

检查清单：

• 规则文件位于 C:\Users\你的用户名\.claude\rules\
• 文件扩展名为 .md
• 规则格式正确（包含 YAML frontmatter）
• Claude Code 已重启

4. 代理未调用

可能原因：

• 代理描述不清晰
• 任务不够复杂
• 工具权限不足

解决方案：

# 手动调用代理
@planner 帮我规划这个功能

5. 安装脚本失败（Windows）

问题： PowerShell 执行策略限制

解决方案：

# 以管理员身份运行 PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 然后重新运行安装脚本

---

总结

Everything Claude Code 是一个经过生产验证的 AI 编程增强系统。通过合理配置和使用，可以显著提升开发效率和代码质量。

关键要点：

1. ✅ 从核心组件开始，逐步扩展
2. ✅ 根据技术栈定制配置
3. ✅ 管理好上下文窗口（MCP < 10 个）
4. ✅ 使用代理优先的工作流（特别是 /plan）
5. ✅ 坚持 TDD 和安全检查
6. ✅ 定期清理未使用的配置

国内特别注意：

• ⚠️ 部分海外 MCP 服务器可能无法使用
• ✅ 优先使用本地 MCP（memory、sequential-thinking）
• ✅ 必要时配置网络代理
• ✅ 使用国内云服务替代方案

致谢：

• 基于 affaan-m/everything-claude-code 项目编写
• 参考了 CSDN 博客教程