返回
Everything Claude Code 系列 开发工具

Everything Claude Code 教程 1：安装与环境配置完全指南

本文详细介绍 Everything Claude Code 的安装配置方法，包含目录结构详解、安装验证步骤和常见问题排查。

教程概述

本教程是 Everything Claude Code 系列的第一篇，将带你完成从零开始的安装配置过程。

你将学到

  • ✅ Everything Claude Code 的核心工作原理
  • ✅ 一键安装与手动安装两种方法
  • ✅ .claude 目录结构详解
  • ✅ 验证安装是否成功
  • ✅ 常见问题排查

Everything Claude Code 是什么？

Everything Claude Code 是一个 AI 代理性能优化系统，由 Anthropic Hackathon Winner 打造。它不是简单的配置文件集合，而是一个完整的系统：

flowchart TD
    subgraph 核心组件
        A[Skills] --> B[Commands]
        B --> C[Hooks]
        C --> D[Subagents]
        D --> E[MCP]
        E --> F[Rules]
        F --> G[Memory]
        G --> H[Plugins]
    end

    subgraph 目标
        I[Token 优化]
        J[安全防护]
        K[持续学习]
    end

    H --> I
    H --> J
    H --> K

    style A fill:#e1f5ff
    style H fill:#e8f5e9

核心特点

  1. 模块化设计 - 每个组件独立配置，按需启用
  2. 跨平台支持 - 支持 Claude Code、Codex、Cursor、OpenCode
  3. 持续进化 - 经过 10+ 个月日常使用迭代
  4. 安全优先 - 内置 AgentShield 安全防护

安装方法

方法 A：一键安装（推荐）

Linux / macOS：

curl -fsSL https://raw.githubusercontent.com/affaan-m/everything-claude-code/main/install.sh | bash

Windows (PowerShell)：

irm https://raw.githubusercontent.com/affaan-m/everything-claude-code/main/install.ps1 | iex

安装脚本会自动：

  1. 检测你的操作系统
  2. 创建 ~/.claude 目录结构
  3. 复制所有配置文件
  4. 安装必要的依赖

方法 B：手动安装

如果需要自定义安装或一键安装失败：

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

# 2. 复制配置文件到 ~/.claude
cp -r everything-claude-code/.claude ~/.claude/

# 3. 复制 CLAUDE.md（可选）
cp everything-claude-code/CLAUDE.md ~/.claude/

方法 C：作为插件安装

Everything Claude Code 也可以作为 Claude Code 插件安装：

# 添加插件市场
claude plugin marketplace add https://github.com/affaan-m/everything-claude-code

# 安装插件
claude plugin install everything-claude-code@everything-claude-code

.claude 目录结构详解

安装完成后，你的 ~/.claude 目录结构如下：

flowchart TD
    A[~/.claude] --> B[commands/]
    A --> C[skills/]
    A --> D[agents/]
    A --> E[hooks/]
    A --> F[rules/]
    A --> G[mcp-configs/]
    A --> H[plugins/]
    A --> I[team/]
    A --> J[research/]
    A --> K[ecc-tools.json]
    A --> L[identity.json]

    B --> B1["/tdd"]
    B --> B2["/refactor-clean"]
    B --> B3["/e2e"]

    C --> C1["everything-claude-code/"]
    C --> C2["continuous-learning/"]

    D --> D1["planner.md"]
    D --> D2["architect.md"]
    D --> D3["code-reviewer.md"]

    E --> E1["memory-persistence/"]

    style A fill:#e3f2fd
    style B fill:#e8f5e9
    style C fill:#fff3e0
    style D fill:#fce4ec

目录说明

目录 作用 示例
commands/ 快速执行的斜杠命令 /tdd, /e2e, /refactor-clean
skills/ 可复用的工作流定义 everything-claude-code/, continuous-learning/
agents/ 子代理配置文件 planner.md, architect.md, code-reviewer.md
hooks/ 自动化触发器 memory-persistence/
rules/ 持久化开发规范 security.md, coding-style.md
mcp-configs/ MCP 服务器配置 github.json, supabase.json
plugins/ 插件配置 LSP 插件等
team/ 团队协作配置 多代理协作模式
research/ 研究输出存储 探索结果存档

核心配置文件

~/.claude/
├── ecc-tools.json      # ECC 工具配置
├── identity.json       # 身份标识配置
└── package-manager.json # 包管理器配置

验证安装成功

验证 1：检查目录结构

# 检查 .claude 目录是否存在
ls -la ~/.claude

# 预期输出应包含以下目录
# commands/  skills/  agents/  hooks/  rules/  mcp-configs/

验证 2：检查核心文件

# 检查关键配置文件
cat ~/.claude/ecc-tools.json

# 预期输出：JSON 格式的工具配置

验证 3：测试 Skills 加载

启动 Claude Code 并输入：

列出可用的 skills

如果安装成功，Claude 应该能够列出 everything-claude-code 等技能。

验证 4：测试 Commands

# 在 Claude Code 中尝试斜杠命令
/tdd

如果看到 TDD 工作流提示，说明 commands 加载成功。

验证 5：检查 Hooks 配置

# 检查 hooks 配置
cat ~/.claude/hooks/memory-persistence/hooks.json

配置文件示例

ecc-tools.json

{
  "tools": {
    "enabled": [
      "mgrep",
      "hookify",
      "context7"
    ],
    "disabled": []
  },
  "contextWindow": {
    "maxTools": 80,
    "maxEnabledMcp": 10
  }
}

identity.json

{
  "name": "your-name",
  "preferences": {
    "editor": "zed",
    "language": "zh-CN",
    "outputStyle": "concise"
  }
}

常见问题排查

问题 1：安装脚本执行失败

症状：curl: command not found 或权限错误

解决方案：

# 确保安装了 curl
sudo apt install curl  # Debian/Ubuntu
brew install curl      # macOS

# 或使用 wget 替代
wget -qO- https://raw.githubusercontent.com/affaan-m/everything-claude-code/main/install.sh | bash

问题 2：目录权限问题

症状：Permission denied 错误

解决方案：

# 检查目录权限
ls -la ~ | grep .claude

# 修复权限
chmod -R 755 ~/.claude

问题 3：Skills 不加载

症状：Claude Code 无法识别 skills

解决方案：

  1. 检查 skills 目录结构：

    ls -la ~/.claude/skills/

  2. 确保 skills 包含 README.md：

    ls ~/.claude/skills/everything-claude-code/
# 应该看到 README.md

  3. 重启 Claude Code 会话

问题 4：Commands 不显示

症状：/tdd 等命令不工作

解决方案：

# 检查 commands 目录
ls ~/.claude/commands/

# 确保文件格式正确
cat ~/.claude/commands/tdd.md

问题 5：Hooks 不触发

症状：配置了 hooks 但没有反应

解决方案：

  1. 检查 hooks 配置语法：

    cat ~/.claude/hooks/*/hooks.json

  2. 确保 matcher 语法正确：

    {
  "PreToolUse": [
    {
      "matcher": "tool == \"Bash\"",
      "hooks": [...]
    }
  ]
}

问题 6：与现有配置冲突

症状：已有其他 Claude Code 配置，担心冲突

解决方案：

# 备份现有配置
mv ~/.claude ~/.claude.backup

# 安装 ECC
curl -fsSL https://raw.githubusercontent.com/affaan-m/everything-claude-code/main/install.sh | bash

# 手动合并需要的配置
cp ~/.claude.backup/your-custom-skills ~/.claude/skills/

下一步

安装完成后，继续学习：

参考资源

📚 完整教程系列导航

你正在阅读本系列的 教程 1，以下是完整目录：

  1. 系列介绍：从配置到精通的完整指南
  2. 教程 1：安装与环境配置（当前）
  3. 教程 2：Skills 与 Commands - 打造你的 AI 工作流
  4. 教程 3：编辑器集成 - Zed / VSCode / Cursor 最佳实践
  5. 教程 4：Hooks - 自动化触发器完全指南
  6. 教程 5：Subagents - 子代理架构与任务委托
  7. 教程 6：MCP 配置与上下文管理
  8. 教程 7：Rules 与 Memory - 持久化你的开发规范
  9. 教程 8：Plugins - 扩展 Claude Code 能力
  10. 教程 9：Token 优化与模型选择策略
  11. 教程 10：Verification Loops 与持续学习
  12. 教程 11：安全防护与 AgentShield

系列导航：