Core concepts
How Claude Code works 它咋个干活
讲清楚它咋一边看现场、一边动手、一边验活，不是瞎忙，是有套路地转圈干活。
原页来源： 官方 How Claude Code works
一句人话
这一页官方主要在讲：Claude Code 不是你说一句，它就胡乱敲一通。 它一般是先看现场，再动手，再回头验收，像请来个会干活的师傅，先绕屋看漏点，再补墙，再泼水试试还漏不漏。
官方把这套做事法叫 agentic loop。你可以把它理解成一个会自己转圈的干活流程： 看情况，出手，检查，不对再来一轮，直到活办成。
它干活，基本就三步
1. 先摸清情况。找文件、看代码、搜报错、理清哪根线接哪根线。
2. 再动手。改文件、跑命令、开测试、查日志，能下手就下手。
3. 最后验活。看看测试过没过、命令报没报错、结果是不是你要的。
如果验出来还不对，它不会死犟，会再转一圈。 所以修 bug 往往不是“一锤子买卖”，而是看一眼、改一点、试一下，连着跑好多轮。
它靠啥干活
脑子：模型
官方说，模型负责想事。它读懂你的代码，判断下一步该先看哪儿、改哪儿、怎么验证。Sonnet 适合大多数日常活，Opus 更适合复杂推理。
手脚：工具
官方把工具分成几类：读写文件、搜索内容、跑命令、查网页、看代码智能提示。没这些手脚，它就只能光说不练。
你可以把它想成“脑子管判断，工具管执行”。有脑子没手脚，干不了活；有手脚没判断，也容易瞎折腾。
它平时能碰到什么
按官方说法，你在项目目录里跑 `claude` 之后，它通常能接触到这些东西：
你的项目文件、终端命令、Git 当前状态、`CLAUDE.md` 里的规矩、自动记下来的 memory，还有你另外给它装的扩展能力。
这就是为什么它常常能跨多个文件一起改。它不是只盯着你眼前这一页代码，而是能在整块地里到处走，看看水渠、仓库、屋梁是不是连在一处。
换地方干活，底层路数不变
官方特别强调：终端、桌面端、IDE、网页、Remote Control 这些地方，只是干活入口不一样。
底下那套“先看，再做，再验”的路数是一回事。
区别主要在于：代码到底是在你本机跑，还是在云上跑；你是用命令行盯着，还是在图形界面里看。
会话、分支、上下文，这几个词别搞混
官方说每次对话都是一个 session，会保留你这次聊天、工具调用和结果，方便以后 `--continue` 或 `--resume` 接着干。
但每个新会话一开始，还是一块新的上下文窗户，不会把上次整段聊天硬搬进来。 能跨会话留下来的，主要靠 `CLAUDE.md` 和 auto memory。
另外它看到的是你当前分支的文件。你切分支后，文件现场变了，但聊天记录还在。 如果你想平行试几条路，官方建议配合 git worktree 或 fork session，别把所有活搅在一个本子里。
上下文装满了，会咋样
官方反复提醒：上下文窗口不是无底洞。
聊得太长、读太多文件、命令输出太多，前头一些细节就可能被压缩、被总结，早先讲过的话也可能变模糊。
所以长期规矩别只靠聊天记，应该写进 `CLAUDE.md`。 大块参考资料别都塞进常驻上下文，能做成 skills 的就做成按需加载。
它不是乱来，也有刹车
官方讲了两道保险：一是 checkpoints，二是 permissions。
checkpoint 像你动工前先拍张照，改坏了还能往回退。 permission 像院门钥匙，哪些命令能直接跑，哪些要先问你，能提前定规矩。
如果你只想先看方案不动手，还能开 Plan Mode，让它先当参谋，不当施工队。
这一页最实在的用法提醒
1. 把它当同事使，不要当魔术师使。你给方向，它自己去找路。
2. 一旦发现它走偏，马上打断纠正，不必等它忙完。
3. 开头交代越具体，后头返工越少。最好把相关目录、约束、验收标准一起说。
4. 复杂活先研究、再计划、再开干，比一上来闷头改更稳。