前言

Claude Code 有很多行为，用着用着会觉得理所当然，但仔细一想会发现不太对劲。

比如改文件，为什么不能直接整文件覆盖，非要提供"要改的旧内容"？比如权限，为什么写文件要确认，但读文件不用，而访问某个网址又变成了域名级别的判断？比如 shell 执行，为什么 grep 和 rm 的体验完全不同——一个默认折叠输出，一个可能弹确认框？

这些行为都不是随机的。它们背后有一套一致的设计逻辑，每个决定都是在某种取舍之下做出的。这本书讲的就是这套逻辑。

读者预设是：你已经在用 Claude Code，不需要解释基础用法。你想知道的是"它为什么这样做"，而不是"它能做什么"。

每章围绕一个功能域，重点放在实现原理和设计取舍上。源码路径偶尔出现，但不是重点——理解设计比认识文件路径更有用。建议先读架构总览，再按兴趣进入各章。