Claude Code 30 分钟新手包

这个 pack 包含什么

刚跑完 npm i -g @anthropic-ai/claude-code，按了 /init，然后对着空白 session 发愣 — 不知道装啥。marketplace 700+ 条目，Reddit 各说各话。你不想花周六慢慢淘 — 你要的是那个能让你午饭前开干的精选短清单。

这个 pack 就是：十个资产，按安装顺序排，依次解决每个 Claude Code 新手真会踩的前十个问题。不讲高级多 agent 编排，不讲小众语言专属。只有那些枯燥但奠基的基础设施 — 装好了，后面每装一个 skill 都能加倍受益。

目标读者：有一个能用的终端，一个真实的代码仓库，零耐心浏览选择。装完第 10 个，你会有项目记忆、精选资产目录、接通的 GitHub、三个在跑的 agent、自动化 hooks、一键 commit-push-PR 流程，外加自己造 skill 的能力。

推荐安装顺序

1. CLAUDE.md 最佳实践模板 — 你能为 Claude Code 写的杠杆最高的一个文件。放在项目根目录，Claude 每个 session 自动读：技术栈、规范、不能动的东西。没有它，每个 session 都从零开始，同一个纠正你要说一辈子。5 分钟填完，每周省好几小时。
2. Claude Code Templates — 600+ Agents / Commands / MCPs — 一个可浏览的精选目录，不用再去 grep marketplace。这是你接下来 6 个月的参考索引。先扫一遍，把和你技术栈匹配的分类收藏起来，要用的时候再回来翻。
3. Awesome Claude Code — 生态指南 — 社区维护的权威清单：插件、集成、最佳实践。和 #2 互补：Templates 是资产（直接装的东西），Awesome 是上下文（值得知道的人和事，博客、talk、工具）。README 看一遍即可。
4. GitHub MCP Server — 把 Claude Code 接到 GitHub。这样 claude 能读 PR、提 issue、在 diff 上评论、看 CI 状态，不用你来回切窗口。这是绝大多数开发者使用频率最高的 MCP，先装它，再装小众的。
5. Claude Code Hooks — Pre/Post Task Actions — 早早锁死安全 + 自动化。改动落地前跑 linter。Claude 改文件后自动跑测试。挡住 /vendor/ 的写入。现在就把 hooks 框架搭起来，等真出事再补就晚了。
6. code-simplifier — Anthropic 官方清理 subagent — 你的第一个 subagent。Anthropic 官方出品。任何一次 Claude 写了 >100 行的 session 后，叫一下 code-simplifier，它会把刚改过的文件做一遍不改变行为的可读性重构。那种你永远不会手动做的清理。
7. verify-app — E2E 测试 subagent — 你的第二个 subagent。改动后跑冒烟测试，避免发个明显坏的东西。Boris Cherny 公开 demo 中那个 verification 步骤的社区等价实现。和 #5 配合（hooks 可以自动触发它）。
8. Claude Code Agent: Code Reviewer — 自动 PR 审查。当你装好了 GitHub MCP（#4），这个 agent 能读 diff，输出结构化的 review。把那些明显的问题先扫掉，让真人 reviewer 集中看架构。
9. /commit-push-pr — 一键提交+推送+开 PR — 你每天会用 20+ 次的 slash 命令。一条命令：stage、写 conventional commit message、push、开 PR。装上之后，你会忘了以前是怎么活下来的。
10. Claude Skill Factory — 自己造 Claude Code Skill — 毕业仪式。你已经用了 9 个别人写的 skill，这个教你自己写。项目专属的 skill 才是 Claude Code 从「能用」升级到「我的私人高级工程师」的分水岭。

它们怎么协同

CLAUDE.md (#1)
   │
   └─ 项目记忆，每个 session 自动读
         │
资产目录: Templates (#2) + Awesome (#3)
   │
   └─ 浏览代替瞎猜
         │
GitHub MCP (#4)
   │
   └─ Claude 和你的 repo / PR / issue / CI 对话
         │
Hooks (#5)
   │
   ├─ pre-edit: lint, format
   └─ post-edit: 触发 verify-app, 跑测试
         │
Subagents: code-simplifier (#6) + verify-app (#7)
   │
   ├─ 大改后的清理
   └─ 任何改动后的冒烟测试
         │
Code Reviewer agent (#8)
   │
   └─ 结构化 PR review，靠 GitHub MCP 取数据
         │
/commit-push-pr (#9)
   │
   └─ 日常主力：stage → commit → push → PR
         │
Skill Factory (#10) — 然后开始自己造。

CLAUDE.md + Hooks + GitHub MCP 这三件套是承重墙。没有这三个，其他都是装饰。如果你只有 10 分钟，装 #1、#4、#5 就停。

你会遇到的取舍

• Templates (#2) vs Awesome (#3) — 有重叠。Templates 是可装的资产索引（从里面 install）。Awesome 是阅读清单（博客、talk、生态上下文）。先装 Templates，把 Awesome 收藏起来每月翻一次看看新东西。
• code-simplifier vs Code Reviewer — 都是「清理代码」，但阶段不同。code-simplifier 在开发中对 Claude 刚改过的文件跑（风格、可读性）。Code Reviewer 对完成的 diff 在合并前跑（架构、正确性）。两个都跑 — 抓的是不同 bug。
• Hooks vs subagents — Hooks 是确定性 shell 命令（便宜、快、不烧 LLM）。Subagents 是LLM 驱动的专家（聪明、慢、烧 token）。用 hooks 做「编辑后永远跑一遍 prettier」；用 subagent 做「审查这个 PR 的架构」。别让 hooks 干 LLM 的活 — 延迟会让你哭。
• GitHub MCP vs gh CLI — 都能读 PR 和 issue。MCP 给 Claude 结构化访问（带类型的响应，不用 parse shell）。gh 你自己在终端里更快。两个都装；让 Claude 用 MCP，你用 gh。

常见踩坑

• CLAUDE.md 写太长 — 30-100 行是黄金区间。有人把整份架构文档 paste 进去，每轮 burn 4K token。要简：技术栈、命令、规范、硬性禁忌。
• 觉得 hooks 枯燥就跳过 — 它就是枯燥。还是要装。哪天 Claude 把 package-lock.json 重写了你没 pre-edit 拦截，你会后悔。
• 一次装 50 个 subagent — 从本 pack 这两个起步（#6, #7）。subagent 越多 = Claude 要扫的上下文越多才能挑对 = 路由越慢越蠢。遇到真实工作流缺口再加。
• 忘了 ~/.claude/CLAUDE.md 这层 — 还有一个全局 CLAUDE.md（跨所有项目的个人偏好）。别把个人风格偏好塞进项目级 CLAUDE.md — 那些放全局。
• 把 Skill Factory (#10) 当成可选 — 它才是放大器。自己写的第一个 skill（哪怕很小）会让你理解整个系统怎么思考。别因为「marketplace skill 应该都有」就跳过。