everything-claude-code常见问题解答安装、配置、Hooks故障排查一次讲清【免费下载链接】everything-claude-codeClaude Code toolkit - agents, commands, skills, rules, and hooks for productive AI-assisted development项目地址: https://gitcode.com/GitHub_Trending/eve/everything-claude-codeeverything-claude-code是一个开箱即用的 Claude Code 配置工具包内置生产级 agents、commands、skills、rules 和 hooks帮助你快速搭建高效的 AI 辅助开发环境。本文汇总新手最常遇到的三大类问题安装方式怎么选、配置项怎么填、Hooks 不生效时如何排查。这个工具包里有什么everything-claude-code 由 Anthropic 黑客松获奖者基于 10 个月以上的日常实战沉淀而成完整结构如下agents/— 8 个专职子代理规划、架构、代码审查、安全审查等commands/— 斜杠命令/tdd、/plan、/code-review、/setup-pm等skills/— 工作流定义TDD 流程、持续学习、验证循环等rules/— 始终生效的规则安全、编码风格、测试覆盖率要求hooks/— 基于事件触发的自动化脚本会话持久化、压缩建议mcp-configs/— GitHub、Supabase、Vercel 等 MCP 服务器配置目录总览可直接查看 README.md 中的 Whats Inside 章节。安装问题插件方式 vs 手动安装方式一作为插件安装推荐⭐这是最省事的方式两条命令即可让所有命令、代理、技能和 hooks 全部就位/plugin marketplace add affaan-m/everything-claude-code /plugin install everything-claude-codeeverything-claude-code也可以直接把插件配置写进~/.claude/settings.json具体字段见 README.md 的 Installation 章节。方式二手动安装想要精细控制适合只想挑选部分组件的用户git clone https://gitcode.com/GitHub_Trending/eve/everything-claude-code cp everything-claude-code/agents/*.md ~/.claude/agents/ cp everything-claude-code/rules/*.md ~/.claude/rules/ cp everything-claude-code/commands/*.md ~/.claude/commands/ cp -r everything-claude-code/skills/* ~/.claude/skills/手动安装时还有两个容易漏掉的步骤把 hooks/hooks.json 中的 hooks 配置合并到你的~/.claude/settings.json把 mcp-configs/mcp-servers.json 中需要的 MCP 服务器复制到~/.claude.json并替换YOUR_*_HERE占位符为你的真实 API Key 官方建议这些配置只是起点。推荐做法是先保留用得上的按自己的技术栈修改删掉不需要的再补充自己的模式。配置问题包管理器怎么选很多用户反馈Claude Code 用的包管理器不是我预期的。工具包内置了智能检测机制按以下优先级顺序判断详见 commands/setup-pm.md优先级检测来源说明1环境变量CLAUDE_PACKAGE_MANAGER最高优先级覆盖其他所有方式2项目配置.claude/package-manager.json针对当前项目3package.json的packageManager字段随项目走4锁文件package-lock.json / yarn.lock / pnpm-lock.yaml / bun.lockb5全局配置~/.claude/package-manager.json用户级默认6回退策略按 pnpm bun yarn npm 取第一个可用的三种常见操作命令# 查看当前检测结果 node scripts/setup-package-manager.js --detect # 全局设置 node scripts/setup-package-manager.js --global pnpm # 仅当前项目设置 node scripts/setup-package-manager.js --project bun也可以直接在 Claude Code 里输入/setup-pm命令完成配置脚本入口为 scripts/setup-package-manager.js。配置问题MCP 服务器会挤占上下文怎么办这是一个高频踩坑点不要一次性启用所有 MCP。官方给出的经验法则可以配置 20-30 个 MCP 服务器每个项目启用不超过 10 个活跃工具数保持在 80 以下否则 200k 的上下文窗口可能被压缩到 70k未使用的 MCP 可通过项目配置中的disabledMcpServers数组按项目禁用。完整清单见 mcp-configs/mcp-servers.json。Hooks 故障排查不生效时先看这 4 点 hooks/hooks.json 覆盖了PreToolUse、PostToolUse、PreCompact、SessionStart、Stop、SessionEnd六类事件。当 hooks 没按预期触发时按顺序排查1. 确认 Node.js 已安装所有 hooks 脚本已用 Node.js 重写以支持 Windows、macOS、Linux 三大平台。如果你的环境没有 Node.jshooks 会静默失败——这是最常见的原因。2. 检查 hooks 配置是否已合并手动安装的用户最容易漏掉这一步hooks 配置不会自动生效必须手动从 hooks/hooks.json 复制到~/.claude/settings.json。插件方式安装则自动完成。3. 理解${CLAUDE_PLUGIN_ROOT}变量hooks.json 中多处引用了${CLAUDE_PLUGIN_ROOT}例如会话开始时执行的command: node \${CLAUDE_PLUGIN_ROOT}/scripts/hooks/session-start.js\这个变量由 Claude Code 在插件安装方式下自动注入指向插件根目录。如果你是手动安装需要把它替换为你的实际仓库路径否则脚本报 找不到文件。4. 运行测试套件验证环境工具包自带完整测试一条命令验证所有 hooks 脚本和工具库是否正常node tests/run-all.js测试入口 tests/run-all.js 会依次执行 tests/hooks/hooks.test.js、tests/lib/utils.test.js 等用例并汇总结果。若全部通过说明脚本本身没问题问题多半在配置层。附这些被阻止的行为是故意的吗以下拦截信息不是故障而是 hooks 的设计功能直接运行npm run dev被拦截 → 提示用 tmux 启动以便 Claude 能访问日志创建随机的.md文档文件被阻止 → 强制文档统一写进 README.md编辑 JS/TS 文件后自动跑 Prettier 类型检查 → PostToolUse 自动格式化会话结束前扫描console.log→ 防止调试代码混入提交常见问题速查表 问题快速解答装完看不到/tdd等命令确认插件安装成功手动安装则检查文件是否复制到了~/.claude/commands/hooks 完全没反应先检查 Node.js再确认配置已合并到settings.jsonhooks 报找不到脚本${CLAUDE_PLUGIN_ROOT}未替换手动安装需改为实际路径上下文窗口变小了启用的 MCP 太多每项目控制在 10 个以内包管理器检测不对用CLAUDE_PACKAGE_MANAGER环境变量强制指定MCP 配置报错mcp-servers.json里的YOUR_*_HERE占位符没替换进阶参考想深入了解各模块的玩法推荐按以下路径阅读插件与 Marketplace 用法plugins/README.md项目级 CLAUDE.md 示例含代码组织、测试、安全规范examples/CLAUDE.md会话持久化 hooks 脚本scripts/hooks/session-start.js、scripts/hooks/session-end.jshooks 编写规则与最佳实践rules/hooks.md贡献指南CONTRIBUTING.md记住官方的一句话先读指南、按需裁剪、持续贡献。这套配置在多个生产应用中验证过但最适合你的版本是你改出来的那一版。【免费下载链接】everything-claude-codeClaude Code toolkit - agents, commands, skills, rules, and hooks for productive AI-assisted development项目地址: https://gitcode.com/GitHub_Trending/eve/everything-claude-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考