夜雨聆风装了 Claude Code 但不知道从哪开始配置？项目里该配什么 Hook？该接哪个 MCP 服务器？——Anthropic 官方出品的 claude-code-setup 插件，专门解决这个问题。它像一位资深工程师一样审查你的项目，然后告诉你"这个项目应该配这些自动化能力"。全程只读，不动你一行代码。
◆ ◆ ◆
一、这个插件做什么？
一句话概括：扫描你的代码库，在 5 个类别中各自推荐 1-2 个最适合的 Claude Code 自动化配置。
五个推荐类别：
插件的身份信息：
| claude-code-setup | |
| claude-automation-recommender | |
◆ ◆ ◆
二、安装与使用：一分钟上手
2.1 安装
# 一行命令，官方市场已内置
/plugin install claude-code-setup@claude-plugins-official无需额外配置。安装后，Claude Code 自动获得 claude-automation-recommender 技能。
2.2 触发方式
用自然语言就行——中文英文都可以：
✓ "帮我分析这个项目，推荐一些自动化配置"
✓ "recommend automations for this project"
✓ "这个项目适合用什么 MCP 服务器？"
✓ "what hooks should I use?"
✓ "help me set up Claude Code for this codebase"使用技巧：如果只想看某一类推荐，直接问"推荐一些 MCP 服务器"或"帮我看看需要哪些 hooks"——插件会针对单个类别给出 3-5 条更详细的推荐，而不是通常的 1-2 条精简版。
◆ ◆ ◆
三、三阶段工作流：它怎么分析你的项目？
阶段 1：代码库分析——它看什么？
插件会系统性地检查你的项目文件，捕捉 9 个维度的关键信号：
| package.json | ||
还会检查项目中是否已有 .claude/ 目录和 CLAUDE.md，避免重复推荐已有配置。
阶段 2：生成推荐——匹配逻辑
这是插件的核心智能。它内置了 5 个参考知识库，每个都维护着"代码特征 → 推荐配置"的映射关系：
claude-code-setup/
└── skills/claude-automation-recommender/
└── references/
├── mcp-servers.md # MCP 服务器推荐矩阵
├── skills-reference.md # Skill 模板和映射
├── hooks-patterns.md # 各语言/工具的 Hook 模式
├── subagent-templates.md # 子代理模板
└── plugins-reference.md # 官方插件清单与推荐举个例子：如果你的项目检测到 @supabase/supabase-js 依赖 → 推荐 Supabase MCP；检测到 .prettierrc → 推荐保存后自动格式化的 PostToolUse Hook；检测到 auth/ 或 payments/ 目录 → 推荐 security-reviewer 子代理。
阶段 3：输出报告
最终输出一份结构化的 Markdown 报告，包含代码库画像 + 每个推荐的"为什么"和"怎么实现"。下面是一个 React + Express 项目的典型输出：
## Claude Code Automation Recommendations
### Codebase Profile
- **Type**: Node.js / TypeScript
- **Framework**: React (frontend) + Express (backend)
- **Key Libraries**: Prisma, Stripe, Jest
---
### 🔌 MCP Servers
#### context7
**Why**: 检测到 React、Express、Prisma、Stripe——需要实时文档
**Install**: claude mcp add context7
#### Playwright MCP
**Why**: React 前端项目，需要浏览器自动化和 E2E 测试
**Install**: claude mcp add playwright
---
### 🎯 Skills
#### frontend-design
**Why**: React UI 开发，创建高质量前端组件
**Invocation**: 用户手动调用 /frontend-design
**Also available in**: frontend-design plugin
---
### ⚡ Hooks
#### auto-format on save
**Why**: 检测到 .prettierrc 配置
**Where**: .claude/settings.json
#### block .env edits
**Why**: 检测到 .env 文件存在
**Where**: .claude/settings.json
---
### 🤖 Subagents
#### security-reviewer
**Why**: 检测到 Stripe 集成，涉及支付安全
**Where**: .claude/agents/security-reviewer.md
#### test-writer
**Why**: Jest 测试套件，需要提升覆盖率
**Where**: .claude/agents/test-writer.md
**Want more?** 对任何类别说"show me more options"
**Want help implementing?** 说"帮我实现这些推荐"◆ ◆ ◆
四、五类推荐的决策逻辑详解
4.1 MCP 服务器：什么时候推荐哪个？
插件内置了完整的 MCP 推荐矩阵，以下是最核心的映射关系：
| context7 | ||
| Playwright | ||
| Supabase MCP | ||
| PostgreSQL MCP | ||
| GitHub MCP | ||
| Linear MCP | ||
| AWS MCP | ||
| Slack MCP | ||
| Sentry MCP | ||
| Docker MCP |
4.2 Skills：什么时候推荐什么？
插件的 skill 推荐分为两类——可通过插件安装的已有 skill，以及建议你自己创建的定制 skill：
| frontend-design | ||
| commit | ||
| skill-development | ||
| writing-rules | ||
| feature-dev | ||
| api-doc | ||
| create-migration | ||
| gen-test | ||
| new-component |
4.3 Hooks：什么时候推荐什么？
| PostToolUse | |
| PostToolUse | |
| PostToolUse | |
| PostToolUse | |
| PreToolUse | |
| PreToolUse | |
| PreToolUse |
4.4 Subagents：什么时候推荐什么？
| code-reviewer | |
| security-reviewer | |
| api-documenter | |
| performance-analyzer | |
| ui-reviewer | |
| test-writer |
◆ ◆ ◆
五、设计哲学：为什么是"只读"？
读 SKILL.md 源码时，最引人注目的是这一行：
This skill is read-only. It analyzes the codebase and outputs recommendations. It does NOT create or modify any files.
这个设计决策很有意思，也体现了深思熟虑：
- 信任建立：新用户对 Claude Code 还不够熟悉，如果一上来就自动修改
- 教育价值：用户看了推荐报告后，如果决定实施，可以另外让 Claude 帮忙创建——这个过程中，用户会理解每个配置是干什么的。本质上是一个"引导式学习"而非"黑盒自动化"。
- 避免冲突：团队项目可能已有部分配置。只读模式避免了自动覆盖已有 Hook 或 MCP 配置的风险。
配套用法：插件输出推荐报告后，你可以直接对 Claude 说"帮我实现这些推荐"——Claude 会逐项创建对应的配置文件。推荐和分析是两个独立步骤，但可以在同一个对话里完成。
◆ ◆ ◆
六、参考知识库的深度
这个插件不只是写了一个 prompt 让 Claude"看着办"。它的 references/ 目录里放着 5 个精心维护的知识库文件，每个都是结构化的"信号→推荐"映射表。这意味着：
- 推荐不是拍脑袋：context7 在什么情况下推荐？文档写清楚了——"使用了流行库/SDK 且希望 Claude 用最新文档编码"。Playwright 在什么情况下推荐？"React/Vue/Angular 项目 + 需要 E2E 测试"。
- 知识可维护：当出现新的 MCP 服务器或有用的 skill 时，更新对应的 reference 文件就行，不需要改写 prompt。
- 可扩展：如果你在团队里想定制推荐规则（比如你们团队统一用某个内部 MCP 服务器），fork 一份 reference 文件加上自己的规则即可。
◆ ◆ ◆
七、团队场景：新成员第一天就能用
这个插件在团队场景下的价值可能比个人用户更大：
场景：新同事入职
# 第一天，clone 仓库后
cd team-project
claude
# 问一句话
> "帮我分析这个项目，推荐所有应该装的 Claude Code 插件和配置"
# 插件输出：
# → 装 typescript-lsp（项目用 TS）
# → 装 security-guidance（有 auth 模块）
# → 配 PostToolUse Hook（已有 ESLint 配置）
# → 创建 code-reviewer subagent
# → 接 Linear MCP（项目用 Linear 管 Issue）
# 然后：
> "帮我实现这些推荐"10 分钟，新同事的 Claude Code 环境就和团队标准对齐了。不需要读内部 Wiki，不需要找人问"该装什么"，不需要手动翻 settings.json 文档。
◆ ◆ ◆
八、当前局限
- 只推荐官方/知名 MCP：reference 文件覆盖的是常见场景，冷门的内部工具可能需要手动补充推荐逻辑
- 不区分已有配置的状态：如果某个 Hook 已经配好了但没生效（比如命令写错了），插件无法诊断配置问题
- 推荐数量偏保守：默认每个类别只给 1-2 条，对已经熟悉 Claude Code 的用户来说可能觉得"不够劲"。不过这一点可以通过追问"show me more"来解决
- 没有评分/优先级：所有推荐是并列的，不会告诉用户"你应该先装 xxx，后装 yyy"
◆ ◆ ◆
九、与 IDE 初始化向导的对比
如果你用过 VS Code 或 JetBrains IDE，一定见过"打开新项目时右下角弹出一串推荐插件"的体验。claude-code-setup 在做的事情本质上类似——但有一个关键区别：
IDE 推荐插件靠的是文件扩展名匹配（看到 .tsx 就推荐 ESLint）。而 claude-code-setup 的推荐基于 Claude 本身对代码库的语义理解——它能判断"这个项目用了 Stripe 做支付，所以需要 security-reviewer"，这种语义级别的推断是纯文件扩展名匹配做不到的。
◆ ◆ ◆
十、结语
claude-code-setup 是一个"小"插件——它不帮你写代码、不帮你做审查、不帮你提交。它做的只有一件事：告诉你在 Claude Code 里该配什么。
但正是这个看似简单的功能，解决了 Claude Code 生态扩张带来的一个真实问题：180+ 插件、几十种 MCP 服务器、24 种 Hook 事件——一个新用户打开 Claude Code，该从哪开始？
claude-code-setup 的价值在于它是 入口。它不是 Claude Code 生态里最强大的插件，但很可能是你第一个该装的插件。装完它 → 拿到推荐 → 装推荐的东西 → 开始高效工作。这个"引导链条"本身就值回安装成本了。
对于团队来说，它是 AI 开发环境的标准化起点——不再是每个成员各自摸索配置，而是让同一个分析引擎为每个人生成一致的推荐基线。
