Claude Code 是一个常驻在终端里、直接读写你的代码仓库的 AI。把代码贴进浏览器的聊天框、再把结果复制回编辑器——这段来回从此不需要了。
这一章要建立的是后面六章共同依赖的心智模型。跳过它，后面各章里「为什么要这样设计」就始终落不到实处。
先看定位 —— 它到底在哪里运行
让 AI 写代码的工具，按运行的位置可以分成三类。Claude Code 属于第一类。
在终端里运行，直接改动文件。Claude Code、Codex CLI 等。擅长把一整块工作交给它。
内嵌在编辑器里，在你敲字的旁边给出建议。Cursor、GitHub Copilot 等。擅长边看边写。
全程在浏览器里完成，还能直接发布。v0、Bolt、Lovable 等。擅长不需要搭建本地环境。
三类工具本身的对比，放在 AI 编程实战课程第 1 章 里讲。本课程只聚焦第一类，往深里走。
顺带一提，Claude Code 并不是只能在终端里用。VS Code 和 JetBrains 的扩展、桌面应用、浏览器，用的都是同一个东西。但它的设计思路是从终端出发的，理解了这一点，从别的入口进去也不会迷路。
与聊天型工具的根本差别
「浏览器版 Claude 也能写代码，那到底差在哪」——这个问题一定是最先冒出来的。差别不在聪明程度，而在手能伸到多远。
它只看得见你贴进去的内容。它交回来的是文本。落地要靠你自己。改动跨了 10 个文件，就是贴 10 次、再搬回去 10 次。
它自己去找、去读。交回来的是差异。它会跑测试，失败了就改完再跑一遍。那 10 个文件由它自己找出来。
这个差别真正起作用，是在工作里包含「查」这一步的时候。「查一下这个函数都被谁调用了，然后全部改掉」，用聊天型工具，查的人是你。智能体会自己去搜。
反过来说，手伸得越远，出错时波及的范围也越大。所以权限需要专门设计（第 5 章）。「聪明」不等于「安全」。
智能体循环 —— 收集 → 执行 → 验证
Claude Code 在干活的时候，底下一直在转同一个循环。
找文件、读文件，需要时再搜索。让它读到什么，在这一步就决定了结果。
改写文件、运行命令。权限的关卡就设在这里。
读测试和类型检查的输出。如果失败，就回到 STEP 1。
关键在于STEP 3 的存在。聊天型工具说到「大概是这样」就结束了，智能体却能把自己的产出跑一遍，验一验。之所以能一直改到测试通过，靠的就是这个循环。
反过来说，在无法验证的任务上，这个优势就消失了。「把这段代码整理干净」并没有定义什么算成功，循环只会空转。第 3 章讲的「先把验证手段交给它」这个套路，就是从这里来的。
工具与权限 —— 它能做什么，你能拦下什么
Claude Code 能做什么，取决于它拿到的「工具」范围。读文件、写文件、执行命令、搜索——每一项都是一个独立的工具。
而且每调用一次工具，都会过一道权限检查。默认情况下，每次改写文件或执行命令，它都会向你要一次批准。也有跳过批准的设置，但那里有第 5 章要讲的注意事项。
你：「把认证相关的测试修好」
↓
[搜索] 找出与认证有关的文件 ← 读取。默认不需要确认
↓
[读取] 读 auth.test.ts ← 读取
↓
[编辑] 改写 auth.test.ts ← 写入。确认会在这里弹出
↓
[执行] 运行 npm test ← 执行。这里也会要确认
↓
读完失败信息，再回到 [编辑]
看清了这条流程，你就知道它为什么会停在那一步。它不是卡住了，是撞上了权限关卡。
上下文窗口这个约束
Claude Code 一次能「记住」的量是有上限的。这个上限就是上下文窗口。对话越长、读过的文件越多，它就填得越满。
填满之后，会出现两件事。
每一轮都要重新读一大堆历史，于是变慢，费用也上去了。这一点直接连着第 7 章的成本话题。
最初交代过的前提被挤了出去。「我刚才不是说过了吗」的真相，多半就是这个。
办法是把对话折叠起来——要么总结压缩，要么就此收尾、重开一轮。什么时候该折叠需要判断，/compact 该不该手动执行里讲了判断标准。动手的步骤在第 3 章。
适合的任务与不适合的任务
一件工具的轮廓，要从它不擅长什么才看得清。
跨多个文件的改动／调查现有代码／反复迭代直到测试通过／模式固定的迁移工作／从报错信息追查根因
没有正确答案定义的工作／跑不起来、无法验证的领域／只有你才清楚的业务判断／一行就能改完的地方（来回批准反而更贵）
「不适合」那一侧，不是能力问题，而是验证循环转不起来的结构问题。所以换成更聪明的模型也解决不了。
本课程的地图
剩下六章各自的位置如下。按顺序读是基本做法，但如果你已经卡住了，从第 4 章切进去也没问题。
装好、连上，一直到第一条指令跑通。
把工作放到探索 → 计划 → 实现 → 提交这条轨道上。
从症状往下追到原因的排查步骤。
设计交出去多少、在哪里叫停。
CLAUDE.md、hooks、subagents、MCP 各自的用武之地。
长期用下去所需要的运营门道。
官方也有学习网站。 Anthropic 开放了免费学习平台 Claude Academy，其中也包含 Claude Code 的课程。本课程不是要取代它，而是更侧重中文讲解，以及从真实卡壳案例倒推出来的说明。两边一起用，应该走得更快。
小结
- Claude Code 是在终端里运行、直接读写代码仓库的智能体型工具
- 它与聊天型的差距不在聪明程度，而在手能伸到多远。它自己去找，交回差异，跑起来验证
- 内部是收集 → 执行 → 验证的循环。因为有 STEP 3，才能一直改到测试通过
- 它能做什么由工具的范围决定，而且每调用一次工具都要过权限关卡
- 上下文窗口填满后，它会变迟钝，还会忘掉前半段。什么时候折叠需要判断
- 不适合的是验证循环转不起来的任务。换模型也解决不了
读到这里，你应该已经把握住 Claude Code 是件什么样的工具了。接下来我们真的动手跑一跑。请前往 第 2 章「安装与最初一小时」。