大多數(shù)人第一次接觸Claude Code時(shí)，會(huì)把它歸類為"能寫代碼的聊天框"。

這不算錯(cuò)，但沒(méi)抓住重點(diǎn)。Claude Code的真正強(qiáng)大之處，不在于模型能回答編程問(wèn)題。圍繞那個(gè)模型的是一整套工程系統(tǒng)：它讀取你的項(xiàng)目、調(diào)用工具、維護(hù)上下文、管理狀態(tài)、連接MCP、調(diào)度子代理，并執(zhí)行權(quán)限與安全邊界。

所以這一章不急著鉆進(jìn)某個(gè)具體函數(shù)，而是先回答一個(gè)更大的問(wèn)題：Claude Code到底是什么樣的工程架構(gòu)？

一句話概括：Claude Code = 模型API + QueryEngine主循環(huán) + 工具系統(tǒng) + 上下文/狀態(tài)管理 + 安全治理 + 代理協(xié)作。

模型提供核心推理能力。讓它變成"能搞定事情的編程代理"的，是包裹在外的整個(gè)運(yùn)行時(shí)層。

我們沿著三個(gè)問(wèn)題來(lái)理解這套架構(gòu)：Claude Code具備哪些能力？QueryEngine如何編排這些能力？最終如何對(duì)應(yīng)到源碼中的具體模塊？

假設(shè)你要做一個(gè)最簡(jiǎn)單的AI編程助手，流程大概是：用戶提問(wèn) → 后端轉(zhuǎn)發(fā)給大模型 → 大模型返回答案 → 展示給用戶。這勉強(qiáng)夠"解釋這段代碼"，但一旦用戶說(shuō)"看看這個(gè)項(xiàng)目，找出測(cè)試失敗的原因并修復(fù)"，事情立刻變復(fù)雜。

模型需要理解項(xiàng)目結(jié)構(gòu)、知道有哪些文件、懂得如何運(yùn)行測(cè)試命令、定位錯(cuò)誤日志、確定要修改哪個(gè)文件。改完之后還要重新跑測(cè)試驗(yàn)證。如果中途遇到權(quán)限錯(cuò)誤、命令失敗、上下文窗口溢出或工具輸出過(guò)大，它得能恢復(fù)。

模型能思考，但沒(méi)法獨(dú)自觸碰真實(shí)的工程環(huán)境。它不會(huì)原生讀取文件，不會(huì)原生執(zhí)行shell命令，不會(huì)原生維護(hù)長(zhǎng)時(shí)間任務(wù)狀態(tài)，也不知道哪些操作有危險(xiǎn)。所以Claude Code必須在模型API外面包一層"工程外殼"——這才是Claude Code的核心價(jià)值。

很多開(kāi)源代理項(xiàng)目就卡在這里：模型調(diào)用層看起來(lái)不錯(cuò)，但工程外殼一遇到壓力就漏。從功能架構(gòu)看，Claude Code像一個(gè)分層的Agent Runtime——圍繞模型構(gòu)建的代理執(zhí)行環(huán)境，負(fù)責(zé)調(diào)度工具、管理狀態(tài)、推進(jìn)任務(wù)。