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 它不是补全，是一个会自己动手的同事 Claude Code 和代码补全的本质区别：谁搜索、谁决策、谁执行、谁验证。看懂三步执行循环，知道它什么时候该用、什么时候不该用，先建立一份现实预期。 7 min
- 02 十五分钟装好，并跑通第一个真实任务 Claude Code 安装、登录与第一个任务：四种安装方式怎么选、账号怎么登，覆盖 macOS、Windows 与 WSL，15 分钟跑通且不让它动你的文件。 11 min
- 03 把话说清楚：让它第一次就理解你 Claude Code 提示词怎么写：一张从模糊到具体的改写对照表，加上一次一步、直接投喂上下文和可复用模板，把任务说成能验收的样子。 9 min
- 04 权限模式：让它敢动手，又不闯祸 Claude Code 权限模式怎么选：plan、acceptEdits、auto 与 bypassPermissions 五档自主度的区别与风险，附一份最小权限配置与配置文件的五级优先级。 6 min
- 05 上下文是唯一稀缺资源 Claude Code 越聊越笨的原因，和 /context、/compact、/clear、/rewind 四个清理动作各该在什么时候用，附两次纠正规则与子代理外包。 7 min
- 06 主循环：探索 → 计划 → 实现 → 验证 → 提交 探索、计划、实现、验证、提交：Claude Code 的五步主循环怎么走，什么时候该进 plan 模式、什么时候可以跳过，以及五种常见失败模式。 8 min
- 07 用 CLAUDE.md 把项目规矩写给它 CLAUDE.md 怎么写才有用：五层记忆的加载顺序、文件该放在哪，用一条删除检验决定什么该写、什么不该写，以及写不进去的东西该放哪。 7 min
- 08 把重复劳动固化：命令、技能、子代理、钩子 把重复劳动固化成 Claude Code 的自定义命令、技能、子代理和钩子：四者的选择象限与最小示例，并说明为什么只有钩子能保证不漏。 10 min
- 09 接入外部世界：MCP 与插件 用 MCP 把数据库、工单和浏览器接进 Claude Code：添加服务器、选作用域、装插件的完整步骤，什么时候不该用，以及接入前的信任检查清单。 10 min
- 10 走出终端：非交互模式与 CI 用 claude -p 非交互模式跑批量任务：JSON 结构化输出、管道与 jq 组合、一份 GitHub Actions 起步配置，以及无头运行的安全要点。 10 min
- 11 额度去哪了：成本诊断与省钱杠杆 Claude Code 额度为什么掉得快：会话重发、缓存过期等四个机制，用 /context 与 /usage 做诊断，再按一张性价比排序的杠杆表动手。 8 min
- 12 安全边界，与一次完整实战 Claude Code 的提示注入风险与四层防线：目录信任、权限规则、沙箱隔离与人工复核，附上调自动化前的检查清单，最后用一次完整实战收口。 13 min
常见问题
需要付费订阅吗？
教程会说明登录方式与不同档位账号的差别，并标注哪些能力依赖付费额度。价格与额度以官方当日说明为准，正文不写死数字。
可以跳着读吗？
第 1 到 6 章建议按顺序，它们构成日常使用的完整闭环。第 4 章讲权限、第 5 章讲上下文，是全篇最该慢读的两章。第 7 章之后可以按需取用。
没用过 agentic 工具能看懂吗？
可以。只假设你会用终端和 git、能读懂 JSON 与 Markdown，不需要读过任何官方文档。
教程会跟着工具更新吗？
会。工具类内容变化快，每次更新会在封面页和章节页标注日期，你可以订阅 RSS 获知更新。