Claude Code 上手指南：从装好第一条命令，到让 AI 在你的仓库里稳定交付
第一次用 Claude Code 的人，通常在第二天就会撞上同一组问题。
你让它”修一下登录的 bug”，它改了七个文件，顺手重构了一个你根本没提的模块。你耐着性子纠正，它道歉、改回来，然后在第 40 轮对话里又犯了同一个错。到了周三下午，你发现这周的额度已经见底，而手上那个功能还没合并。
于是很多人得出结论：这东西不适合真实项目。
这个结论下早了。上面三个现象来自同一个可以被管理的变量——上下文与边界。Claude Code 不是一个更聪明的代码补全，它是一个会自己读文件、自己跑命令、自己决定下一步的执行体。对执行体，你要做的不是”把话说得更客气”，而是给它清晰的目标、可验证的标准，和一条它不能越过的线。
这份教程就是围绕这件事写的。读完之后，你能够：
前两章建立心智模型并跑通环境；第 3 到 6 章是日常使用的四件核心事——把话说清楚、给出边界、管住上下文、走完主循环；第 7 到 9 章把个人用法沉淀成团队资产并接入外部系统；第 10 到 11 章走向自动化与成本控制；第 12 章收口于安全，并用一次完整演练检验你是否真的学会了。
书里所有命令与配置字段，都以 2026 年 9 月初的官方文档为准。Claude Code 的发版节奏接近每天一次，所以本书刻意不写死版本号：当你发现某个命令对不上，第一反应应该是在会话里敲 /help，而不是怀疑自己装错了。
读完之后你应该能够
- 独立完成安装、登录，并在自己的仓库里跑通第一个真实任务
- 用一条固定的主循环推进任务，而不是即兴发挥
- 在正确的时刻清理上下文，而不是等它开始犯傻才反应过来
- 用权限规则和 CLAUDE.md 给它划出行为边界
- 把重复劳动固化成自定义命令、技能、子代理和钩子
- 接入 MCP 与 CI，让它在你不在终端前时也能干活
- 看懂自己的额度花在哪里，并知道先动哪个杠杆
- 识别提示注入这类安全边界，知道什么时候该停下来自己看一眼
章节目录
12 章 · 约 106 分钟- 01 它不是补全，是一个会自己动手的同事 它和代码补全的本质区别：谁来搜索、谁来决策、谁来执行、谁来验证。先建立一份现实预期。 7 min
- 02 十五分钟装好，并跑通第一个真实任务 十五分钟走完安装、登录和第一个真实任务，全程不让它动你的文件。 11 min
- 03 把话说清楚：让它第一次就理解你 为什么它总是理解错？一张模糊到具体的提示改写表，把任务说成能验收的样子。 9 min
- 04 权限模式：让它敢动手，又不闯祸 五档自主度阶梯：让它敢动手，又不闯祸。附一份最小权限配置。 6 min
- 05 上下文是唯一稀缺资源 上下文是唯一稀缺资源。聊得越久越笨的原因，和四个该在什么时候做的清理动作。 7 min
- 06 主循环：探索 → 计划 → 实现 → 验证 → 提交 探索 → 计划 → 实现 → 验证 → 提交：一个真实任务该按什么顺序推进。 8 min
- 07 用 CLAUDE.md 把项目规矩写给它 用 CLAUDE.md 把项目规矩写成文件：记忆层级怎么排，什么该写、什么不该写。 7 min
- 08 把重复劳动固化：命令、技能、子代理、钩子 命令、技能、子代理、钩子四选一决策象限，配四个能直接抄的最小示例。 10 min
- 09 接入外部世界：MCP 与插件 用 MCP 把数据库、工单、浏览器接进来，附一份接入前的信任检查清单。 10 min
- 10 走出终端：非交互模式与 CI 走出终端：-p 非交互脚本模板与一份 GitHub Actions 起步配置。 10 min
- 11 额度去哪了：成本诊断与省钱杠杆 额度到底掉在哪：诊断三步，加一张按性价比排序的省钱杠杆表。 8 min
- 12 安全边界，与一次完整实战 提示注入等安全边界的四层防线，收口于一次完整实战和一张自检量表。 13 min
常见问题
需要付费订阅吗？
教程会说明登录方式与不同档位账号的差别，并标注哪些能力依赖付费额度。价格与额度以官方当日说明为准，正文不写死数字。
可以跳着读吗？
第 1 到 6 章建议按顺序，它们构成日常使用的完整闭环。第 4 章讲权限、第 5 章讲上下文，是全篇最该慢读的两章。第 7 章之后可以按需取用。
没用过 agentic 工具能看懂吗？
可以。只假设你会用终端和 git、能读懂 JSON 与 Markdown，不需要读过任何官方文档。
教程会跟着工具更新吗？
会。工具类内容变化快，每次更新会在封面页和章节页标注日期，你可以订阅 RSS 获知更新。