Appearance
Claude Code 完整学习路线图：IDE → CLI
为欣然量身设计 · 6 阶段 · 预计 8-12 周 · 每阶段不达标不往下走
总体思路
IDE 是训练轮，CLI 是自行车。IDE 友好但有限，CLI 才是 Claude Code 的真正战场。 路线走法：IDE 熟练 → 开始双跑（IDE + CLI）→ CLI 为主 → 自动化。
不要跳阶段。看到酷炫功能（Hook / MCP / Routine）忍住。地基没打好上高层一定塌。
🟢 阶段 1：IDE 基础操作（第 1 周）
目标：界面不再陌生，能独立完成一个小任务。
要会的
- [ ] 认识左侧栏每个按钮（看
01-左侧栏图解.md） - [ ] 背熟 20 个核心术语（
02-术语对照表.md） - [ ] 新开 session、切换、归档、置顶
- [ ] 看懂 session 前面的状态图标（✋ / 〇 / ●）
- [ ] 知道 Project 是怎么自动分组的
实操任务
- ✅ 把 "Claude IDE 学习档" 拖到 Pinned
- ✅ 随便做件事，做完手动 Archive
- ✅ 问 Claude 一个你真实的工作问题（比如游戏资产分类建议）
不做什么
- ❌ 不碰 Routines / Skills / Agents / Hooks / MCP
- ❌ 不追求"完整配置"
过关标准：闭眼说得出左侧栏 5 个主要按钮，认得 ✋ 状态图标。
🟢 阶段 2：文件组织与项目规范（第 2 周）
目标：知道东西该放哪，屎山不再生长。
要会的
- [ ] 读懂
~/CLAUDE.md的 Home Taxonomy 部分 - [ ] 理解 7 个总桶：Apps / Projects / Knowledge / Media / Scratch / Archive / Yanqian
- [ ] 什么时候写
CLAUDE.md（项目级规范） - [ ] 为什么"先改文档再改实践"
实操任务
- ✅ 把
~/claudecode_xinran/根目录散文件按归属分类 - ✅ 给 1 个现有项目写
CLAUDE.md（哪怕 10 行也写） - ✅ 建立"每周扫地"习惯（周日 10 分钟看 root 有没有漏）
不做什么
- ❌ 不搬动 metabot / claudecode_xinran 等生命线目录
过关标准：新产物能脱口而出"这应该放哪个桶"。
🟡 阶段 3：Git + PR 工作流（第 3-4 周）
目标：代码改动可控，不再"改了不知道怎么了"。
要会的
- [ ]
03-PR和Git基础.md全部看懂 - [ ] 理解 commit / branch / merge / PR 四个概念
- [ ] 看得懂 Claude 生成的 diff（+91 -35）
- [ ] 知道什么时候用 Create PR / Draft PR / Manually
实操任务
- ✅ 让 Claude 帮你做一次完整改动：改代码 → commit → push → 开 PR
- ✅ 手动在 GitHub 网页上 merge 一次 PR
- ✅ 用
git log --oneline看自己项目历史
能接受的节奏
- 每个改动都走 PR 流程（哪怕一个人）
- 不直接 push 到 main
过关标准：能独立回答"这次改了什么、为什么改、怎么合进主线"。
🟡 阶段 4：Customize 配置大本营（第 5-6 周）
目标：开始让 Claude"变成你想要的样子"。
要会的
- [ ] Skills 是什么（你已经在玩"小岛秀夫 skill"）
- [ ] Agents 是什么 · 和 Skills 的区别
- [ ] Permissions 设置 · 什么命令让 Claude 自动跑，什么要审批
- [ ] MCP 初步概念（先不深挖，知道是"外部工具插座"即可）
实操任务
- ✅ 读你已有的 skill 文件（
~/.claude/skills/或项目级） - ✅ 自己写 1 个简单 skill（比如"公众号写作规范"）
- ✅ 调整一次 Permissions（比如允许某个命令自动跑）
不做什么
- ❌ 不装超过 3 个 MCP server（每装一个评估一次价值）
- ❌ 不写 Hook（留到阶段 6）
过关标准：能说清楚"我的 skill 包里存了什么、为什么这样组织"。
🔴 阶段 5：从 IDE 迁移到 CLI（第 7-8 周）【关键转折】
目标：打开终端能直接用 claude 命令，不再依赖图形界面。
要会的
- [ ] 在终端输入
claude进入对话 - [ ] 理解 IDE 和 CLI 共享同一套
.claude/配置 - [ ] Slash 命令：
/clear、/compact、/model、/cost、/help - [ ]
claude -p "一句话任务"的 headless 模式（一次性执行不进对话） - [ ] 终端快捷键：Ctrl+C 中断、Shift+Tab 切换 auto-accept 模式
实操任务
- ✅ 连续 3 天只用 CLI 不开 IDE
- ✅ 用
claude -p跑一个一次性任务 - ✅ 对比 IDE 和 CLI 用着感觉有什么不同，写进学习档
为什么必须学 CLI
- 速度快：启动 <1 秒，IDE 要 3-5 秒
- 能脚本化：写 shell 脚本调用
claude -p - 服务器可用：SSH 上远程机器只能用 CLI
- 更少干扰：纯文本，无图形诱惑
过关标准：终端 claude 比 IDE 开得更顺手。
🔴 阶段 6：自动化和进阶（第 9-12 周 及以后）
目标：Claude 在你不在场时也能替你干活。
要会的（按顺序学，不要跳）
- Hook · 事件触发脚本（commit 前自动格式化、会话结束自动归档等）
- Routine · 定时任务（这时你已经知道哪些任务值得自动化）
- MCP Server 深入 · 写自己的 MCP server
- Subagent / Team · 多个 Claude 协作干活
- Worktree 工作流 · 同项目多分支并行开发
- Claude API 直调 · 写脚本绕过 Claude Code 直接用 API
实操任务
- ✅ 配第一个 Hook（比如 Stop hook 发送通知）
- ✅ 配第一个 Routine（只做你已经手动重复 5 次以上的事）
- ✅ 用 Subagent 跑一次真实的并行任务
终极里程碑
一个完整的自动化流水线，例如：
每周日 20:00 自动扫描本周游戏开发笔记 → 整理成公众号草稿 → 通过 Telegram 发给你审批 → 你回复"ok"后自动发布
能做到这个，你就从"用 Claude Code"升级成"驾驭 Claude Code"了。
📅 时间规划建议
| 阶段 | 周数 | 每日投入 | 里程碑 |
|---|---|---|---|
| 1. IDE 基础 | 第 1 周 | 30 分钟 | 界面不陌生 |
| 2. 文件组织 | 第 2 周 | 30 分钟 | 屎山停止生长 |
| 3. Git/PR | 第 3-4 周 | 1 小时 | 改动全部走 PR |
| 4. Customize | 第 5-6 周 | 1 小时 | 有自己的 skill |
| 5. CLI 迁移 | 第 7-8 周 | 1 小时 | CLI 为主用 |
| 6. 自动化 | 第 9-12 周+ | 按兴趣 | 第一条流水线 |
总计约 8-12 周达到"熟练"。不急，你又不是程序员。
🚫 路上要避免的 5 个陷阱
- 功能收集癖：看到酷炫功能就装。问自己：我解决什么问题？
- 跳阶段：地基没打好上阶段 6 = 配置混乱、找不到东西
- 过早自动化：Routine 没手动跑过的任务 = 等于埋雷
- 只看不做：这份路线图每一阶段都有"实操任务"，不做不算过
- 孤独学习：卡住就截图问 Claude（你今天就在用这招）
📌 下一步
现在（2026-04-23）：你处在 阶段 1 中段。 本周目标：完成阶段 1 所有 checkbox，进入阶段 2。 下次来翻这份文档：每周日晚上对一次 checkbox。