Claude Code 的功能越来越多,但新手往往不知道该开什么钩子、装什么技能、配什么 MCP 服务器。Anthropic 官方出品的 claude-code-setup 插件正在解决这个问题。
它能做什么
安装后,claude-code-setup 会执行一次完整的项目扫描:
- 分析技术栈:识别项目的语言、框架、构建工具
- 推荐钩子:根据项目类型建议应该激活哪些预提交、后处理钩子
- 匹配技能:从技能库中筛选适合当前项目的 Skills 配置
- MCP 服务器推荐:根据依赖关系推荐需要连接的 MCP 服务
- 子代理配置:如果项目需要多 Agent 协作,自动规划子代理分工
安装方式
在 Claude Code 中直接运行:
/plugin install claude-code-setup
安装完成后,首次运行会自动扫描当前目录,生成一份配置建议报告。
使用场景
| 场景 | 传统做法 | 用 claude-code-setup |
|---|---|---|
| 新项目初始化 | 手动查找文档、逐个配置 | 扫描后一键推荐 |
| 迁移到 Claude Code | 阅读大量最佳实践文章 | 自动适配现有项目结构 |
| 团队协作 | 每个人各自摸索 | 统一生成标准化配置 |
值得注意的细节
插件的推荐不是一刀切的,它会根据以下因素动态调整:
- 项目规模(文件数量、代码行数)
- 团队人数(通过 Git 提交历史推断)
- CI/CD 流程(检测 GitHub Actions、Jenkins 等配置)
- 现有 AI 工具使用痕迹(是否有 .cursorrules、.windsurfrules 等)
这使得它的推荐更贴近项目的实际需求,而不是一份通用模板。
限制
- 扫描深度受限于 Claude Code 的上下文窗口,超大项目可能需要分目录处理
- 部分推荐需要手动确认,不会自动修改项目文件
- 目前对非标准项目结构的支持还在优化中