北京
大多数人第一次接触Claude Code时，会把它归类为"能写代码的聊天框"。
这不算错，但没抓住重点。Claude Code的真正强大之处，不在于模型能回答编程问题。围绕那个模型的是一整套工程系统：它读取你的项目、调用工具、维护上下文、管理状态、连接MCP、调度子代理，并执行权限与安全边界。
所以这一章不急着钻进某个具体函数，而是先回答一个更大的问题：Claude Code到底是什么样的工程架构？
一句话概括：Claude Code = 模型API + QueryEngine主循环 + 工具系统 + 上下文/状态管理 + 安全治理 + 代理协作。
模型提供核心推理能力。让它变成"能搞定事情的编程代理"的，是包裹在外的整个运行时层。
我们沿着三个问题来理解这套架构：Claude Code具备哪些能力？QueryEngine如何编排这些能力？最终如何对应到源码中的具体模块？
假设你要做一个最简单的AI编程助手，流程大概是：用户提问 → 后端转发给大模型 → 大模型返回答案 → 展示给用户。这勉强够"解释这段代码"，但一旦用户说"看看这个项目，找出测试失败的原因并修复"，事情立刻变复杂。
模型需要理解项目结构、知道有哪些文件、懂得如何运行测试命令、定位错误日志、确定要修改哪个文件。改完之后还要重新跑测试验证。如果中途遇到权限错误、命令失败、上下文窗口溢出或工具输出过大，它得能恢复。
模型能思考，但没法独自触碰真实的工程环境。它不会原生读取文件，不会原生执行shell命令，不会原生维护长时间任务状态，也不知道哪些操作有危险。所以Claude Code必须在模型API外面包一层"工程外壳"——这才是Claude Code的核心价值。
很多开源代理项目就卡在这里：模型调用层看起来不错，但工程外壳一遇到压力就漏。从功能架构看，Claude Code像一个分层的Agent Runtime——围绕模型构建的代理执行环境，负责调度工具、管理状态、推进任务。
特别声明：以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布，本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
