Claude Code 工作原理详解

第一次使用 Claude Code，你大概会遇到这样的场景——

看到这里可能会有些困惑：仅仅询问了一句话，它为什么能够自动执行命令、读取文件、自行修改代码并进行验证？

简单来说，这正是 Claude Code 与普通 AI 聊天界面最根本的区别。聊天窗口只会"回复你一段文字"，而 Claude Code 则能够自动动手处理事务。这种能力背后有一套固定且高效的工作原理，今天我们就来深入剖析它。

读完本文，你将掌握：

• 一张图表理解 Claude Code 的「袋里循环」机制——它每执行一次任务都会重复的三个关键步骤
• 清楚了解它手中的 5 类「工具」分别具备什么功能，以及它如何决定使用哪种工具
• 明白它究竟能访问你电脑上的哪些信息，又有哪些无法触及（这关乎安全问题）
• 一个可以独立操作的小实验，亲眼观察它完成一次完整的循环过程

01 袋里循环——思考、执行、验证

首先直接给出结论：Claude Code 处理任何任务时，都会持续重复三个动作——收集上下文、采取行动、验证结果。官方将这套机制命名为「袋里循环（agentic loop）」。

用更通俗的语言来描述就是：思考 → 执行 → 验证。

• 思考（收集上下文）：首先弄明白当前状况——读取相关文件、查看错误信息、检查 git 状态
• 执行（采取行动）：动手操作——修改代码、运行命令、创建新文件
• 验证（验证结果）：检查刚才的操作是否正确——运行测试、查看输出，若发现问题则重新执行一轮

这就好比一位经验丰富的汽车维修师傅。你把车开进维修店并反映「方向盘抖动」，师傅不会立刻动手拆卸。他会先仔细观察一圈、试开一小段路（思考阶段），然后拿起扳手进行操作（执行阶段），修好后再次驾驶确认抖动问题已解决（验证阶段）。如果问题依旧存在，他就会重新回到第一步进行排查。Claude Code 就如同这样一位师傅，只是它维修的对象是你的代码项目。

回顾文章开头的对话，对照下面这张表你就会明白：

它将这三个步骤串联成一条工作链，上一步的操作结果会决定下一步该如何进行。修复一个程序错误可能需要循环好几轮，而询问「这段代码的含义」可能只需要「思考」这一步就足够。循环执行的轮数取决于任务的复杂程度，并非固定不变。

上面这张图表展示了 Claude Code 每次执行任务时的工作循环：从「思考」到「执行」再到「验证」，如果结果不满意，就会从「验证」环节返回到「思考」环节重新开始——你随时都可以按下 Esc 键让它暂停。

这里有一个关键点，很多人可能没有意识到：你也是这个循环的一部分。当它偏离轨道时，你随时可以介入纠正——这一点我们会在下一节详细说明。

驱动这个循环运行的有两个核心要素：模型负责「思考」部分，工具负责「执行」和「验证」部分。

模型就是 Claude 的智能大脑——Sonnet 模型能够满足日常编程需求，Opus 模型则具备更强的推理能力，适合处理复杂架构。在会话过程中输入 /model 可以随时切换，或者在启动时使用命令 claude --model sonnet 进行指定。

02 你也在循环之中——随时可以打断

上一节末尾提到：你也是这个循环的一部分。我们来详细聊聊这一点。

普通的 AI 聊天模式是「你问一句、它答一段、回合结束」。但 Claude Code 的工作方式不同——当它在循环中自主运行时，你不需要一直等待，随时都可以介入。

举例来说，当你让它重构一个模块，发现它偏离了方向、正准备大规模修改多个文件时，直接按下 Esc 键，它就会立刻停止，正在执行的命令也会被取消。这时你再补充一句「不要改动那个文件，只修改这个函数」，它就会按照新的指示继续工作。

两种不同的打断方式，需要区分清楚：

这是官方文档中的原话，特别值得牢记。刚开始使用时，总想「一句话就把需求描述完整」，憋了半天也想不出。其实没有必要：先给出一个大方向，它做错了再及时纠正，通过迭代调整比憋大招要高效得多。

03 工具——它能够真实操作的原因

上一节提到，模型负责「思考」。那么「执行」和「验证」依靠的是什么？答案是工具。

这是关于 Claude Code 最值得记住的一句话：如果没有工具，Claude 只能回复你文字信息；但有了工具，它就能真正读取你的代码、修改你的文件、运行你的命令。

这就好比一位配备了智能手环的助理。只会说话的助理只能提供建议；但为他配备能够开门、打字、查阅资料的设备，他才能真正帮你把事情办好。工具就是 Claude Code 的「双手」。

官方将内置工具分为 5 个大类。下面用通俗易懂的方式为你列出——

那么它是如何决定使用哪种工具的呢？并非由你指定，而是模型根据你的指令和当前进展情况自主选择。

举个例子，官方文档中提到，当你说一句「修复失败的测试」，它内部大致会执行以下操作：

1. 运行测试套件，查看哪些测试失败了 —— 使用了 执行 工具
2. 读取错误输出信息 —— 执行 工具
3. 搜索相关的源代码文件 —— 搜索 工具
4. 读取这些文件以理解代码逻辑 —— 文件操作 工具
5. 修改文件以修复程序错误 —— 文件操作 工具
6. 重新运行测试进行验证 —— 执行 工具

看出来了吗？这 6 个步骤就是「思考→执行→验证」循环在工具层面上的具体展开。每使用一次工具，就会获取到一些新的信息，供模型判断下一步该做什么——循环就是这样持续运转起来的。

有一个非常典型的应用场景：让 Claude Code 为一个没有文档的老项目「整理一下目录结构」。它不需要你提供任何文件，而是自己执行 ls 命令、自己使用 grep 搜索关键字、读取七八个文件，最后生成一张结构图。全程没有指定任何一个文件——这就是官方所说的「委派任务，而非下达指令」：给出方向，它自己负责处理细节。

至于 Skill、MCP、Hook、Subagent 这些功能——它们是构建在这 5 类内置工具之上的扩展层，可以让 Claude 了解更多信息、连接更多外部服务。本系列文章后面会逐一讲解，目前先了解有这些功能存在即可。

04 它能看到你电脑上的哪些内容

这一节关系到安全问题，需要详细说明。很多人第一次使用时都会产生顾虑：它是不是会翻遍我整个硬盘并将数据传走？不是这样的。

先记住一句话：Claude Code 的「视野」基本等同于你在当前目录下通过终端能够访问到的内容。你在哪个文件夹中执行 claude 命令，它的活动范围就以该文件夹为中心。

根据官方文档，当你在某个目录下运行 claude 命令时，它能够访问的内容包括：

• 你的项目文件：当前目录及其子目录中的文件（其他位置的文件需要你授予权限后才能访问）
• 你的终端环境：你所能执行的任何命令——构建工具、git、包管理器、脚本。命令行能做到的事情，它也能做到
• 你的 git 状态：当前所在分支、尚未提交的修改内容、最近的提交历史记录
• 你的 CLAUDE.md 文件：你编写的项目专属使用说明，每次会话它都会读取该文件（这个文件后续会有专门章节讲解）
• 你配置的扩展：MCP、Skill、Subagent 等

正因为它能够看到整个项目，而不仅仅是你当前打开的那一个文件，所以它能够进行跨文件的协调工作——你说「修复登录程序错误」，它能够搜索出相关的好几个文件、同时进行修改、再运行测试进行验证。这与只看当前文件的内联补全插件完全是两回事。

那么安全问题是如何保障的呢？主要依靠两道防线——

第一道防线：检查点（checkpoint）功能，相当于游戏中的保存点。它在修改任何文件之前，会先对当前内容进行一次快照备份。如果修改出了错误，你可以在输入框为空的状态下连续按两次 Esc 键（或输入 /rewind 命令），这时会弹出一个「回溯菜单」，选择「恢复代码」选项即可将文件回退到修改前的状态；你也可以直接说「撤销刚才的修改」。

这里有一个常见的误区：有时候它修改了五六个文件，你查看后觉得方向完全错误。以前你只能手动逐个使用 git checkout 命令回滚，而现在只需按两下 Esc 键、在弹出的菜单中选择「恢复代码」——所有五个文件就会整齐划一地恢复到修改前的状态，干净利落。有了这个功能，放手让它修改代码也就不那么让人担心了。

第二道防线：权限模式，相当于实习生在动手操作前是否需要征求你的意见。按下 Shift+Tab 键可以循环切换权限模式：

最值得养成的习惯是使用 Plan Mode：对于复杂任务，可以先按两下 Shift+Tab 键进入该模式，让它「只进行分析、生成方案、不要动手」，你详细审阅方案、进行修改调整，确认无误后再让它执行。这种方式能够有效避免「方向错误导致改了一半需要返工」的情况——先看图纸再施工，比边做边改要节省大量时间。

如果觉得每次都询问很麻烦，你可以在项目的 .claude/settings.json 配置文件中，将信任的命令（比如 npm test、git status）加入白名单，以后执行这些命令时就不再询问了。具体配置细节后续会有专门章节讲解。

05 动手实践——亲眼看它完成一个完整循环

光看原理可能不容易记住。我们来进行一个小实验，亲眼看它完成一次「思考→执行→验证」的完整循环。这个实验不依赖任何现有项目，只需新建一个空文件夹即可完成。

第一步：创建一个空目录，然后进入该目录启动 Claude Code。

在终端中执行以下命令（Mac / Linux 系统；Windows 系统使用 PowerShell 时，将 mkdir -p 替换为 mkdir 即可）：

mkdir -p ~/cc-demo && cd ~/cc-demo
claude

第二步：进入后，先切换到计划模式，看看它是如何进行「思考」的。

按两下 Shift+Tab 键，界面底部会提示已进入 Plan Mode（计划模式）。然后向它提交以下指令：

帮我写一个 Python 脚本 add.py，里面包含一个函数 add(a, b) 返回两数之和，再写几个测试用例验证它的功能，最后运行一遍测试。先给我一份计划，不要直接动手。

你预计会看到：它不会立刻创建文件，而是先回复你一份计划，大致内容如下——

计划：1. 创建 add.py 文件，实现 add(a, b) 函数
2. 创建测试代码（使用 assert 或 pytest）
3. 运行测试，确认所有测试用例通过
是否需要我开始执行？

这就是「思考」——它在动手操作之前先理清了工作思路。注意它停下来等待你批准，这正是计划模式的典型特征。

第三步：批准计划，然后观察它如何「执行」和「验证」。

回复「可以，开始吧」。接着你会看到它依次执行以下操作：

• 创建文件（使用文件操作工具）——可能会先弹出权限确认窗口，你点击同意
• 编写完代码后运行测试（使用执行工具），比如执行 python add.py 或 pytest 命令
• 将测试输出结果展示给你，预期内容类似：

测试通过：
add(2, 3) == 5 ✓
add(-1, 1) == 0 ✓
add(0, 0) == 0 ✓

至此，你就完整地观察了一遍循环过程：思考（制定计划）→ 执行（创建文件、编写代码）→ 验证（运行测试、输出结果）。

第四步（可选）：故意制造一次「重新循环」的机会。

你可以对它说：「将 add 函数改成减法运算，但函数名称保持不变，然后重新运行测试。」

你会看到它修改代码后、再次运行测试——如果测试断言仍然针对加法逻辑，测试就会失败，它会自己发现测试失败、然后回头修改测试代码。这就是循环的精髓：当发现结果不正确时，它会自动重新开始一轮修正。

新手都值得完成一遍这个实验。与其读十遍「袋里循环」这个术语，不如亲眼看到它停下来制定计划、再动手操作、最后验证结果，这样理解起来要快得多。

06 小结

这一篇文章只讲清楚了一件事：Claude Code 凭什么能够自主完成任务。

回顾一下核心要点：

你现在应该能够理解 Claude Code 在执行任务时屏幕上显示的内容了——它每次读取文件、每次运行命令，都是循环中的一步操作；同时也知道了如何使用 Esc 键紧急停止、使用计划模式预先查看方案、依靠检查点功能放心地让它修改代码。

理解这套机制后，你使用它的心态会完全不同：它不是一个许愿池，而是一个会自己思考、动手操作、检查结果的协作伙伴——你的任务是指明方向、确定验收标准、在它偏离轨道时及时纠正。

下一篇 04 · 接入第三方 / 国产模型：Claude Code 已经安装完成、工作原理也理解了，但它需要连接模型才能真正开始工作。下一篇我们带你配置好 API 连接——这一步完成后，前面学到的循环机制和工具才能实际运行起来。