Claude Code 源码解读:学会向 AI 提问
Claude Code源码解读:学会用工具、学会向 AI 提问(一):工具系统与提问境界
摘要:2026 年 3 月,Claude Code 因意外泄露了约 51 万行 TypeScript 源码。这次泄露让我们看清了顶级 Agent 系统的真实骨架:它不是在”回答问题”,而是在”编排工具”。
一、源码泄露背后的冰山:庞大且精密的工具系统
2026 年 3 月,Claude Code 因意外泄露了约 51 万行 TypeScript 源码。这次泄露让我们看清了顶级 Agent 系统的真实骨架:它远比大多数人想象的复杂。
它不是在”回答问题”,而是在”编排工具”。你的一次简单提问,在底层可能触发数十次工具调用和 Hook 钩子。
1.1 系统架构全景
Claude Code 拥有一个庞大且纷繁的文件目录系统:
src/ (~1,900 文件,512,000+ 行)├── main.tsx # 入口 (Commander.js CLI + React/Ink 渲染)├── commands.ts # 命令注册表 (100+ 命令)├── tools.ts # 工具注册表 (38+ 工具)├── Tool.ts # 工具类型定义├── QueryEngine.ts # LLM 查询引擎 (~46K 行)├── query.ts # 主查询循环 (~1,729 行)├── context.ts # 系统/用户上下文收集├── cost-tracker.ts # Token 成本追踪│├── commands/ # 斜杠命令实现 (100+ 个)├── tools/ # 工具实现 (38+ 个)├── components/ # Ink UI 组件 (~140 个)├── hooks/ # React Hooks + 权限 Hooks├── services/ # 外部服务集成│ ├── api/ # Anthropic API 客户端│ ├── mcp/ # MCP 协议集成│ ├── lsp/ # LSP 协议集成│ ├── compact/ # 上下文压缩│ ├── extractMemories/ # 记忆提取│ ├── SessionMemory/ # 会话记忆│ ├── tools/ # 工具执行 & 编排│ └── analytics/ # GrowthBook + 遥测├── constants/ # 系统提示词 + 常量├── bridge/ # IDE 集成桥接├── coordinator/ # 多智能体协调器├── plugins/ # 插件系统├── skills/ # 技能系统├── memdir/ # 持久记忆系统├── tasks/ # 任务管理系统├── state/ # 状态管理├── remote/ # 远程会话├── server/ # Server 模式├── vim/ # Vim 模式 (完整状态机)├── voice/ # 语音输入├── keybindings/ # 快捷键系统├── screens/ # 全屏 UI (Doctor, REPL, Resume)├── schemas/ # Zod 配置 Schema├── migrations/ # 配置迁移├── query/ # 查询管道子模块├── outputStyles/ # 输出样式└── buddy/ # 伴侣精灵 (彩蛋)
1.2 系统命令与工具库
‧ /mcp (跨协议协作) ‧ /memory (长期记忆) ‧ /permissions (权限)‧ /hooks (生命周期) ‧ /plan (规划模式) ‧ /compact (上下文压缩)‧ /skill (技能系统) ‧ /task (任务管理) ‧ /plugin (插件注入)‧ /doctor (诊断工具) ‧ /repl (交互模式) ‧ /resume (会话恢复)
1.3 核心工具列表 (38+)
|
|
|
|
|---|---|---|
| 文件操作 |
|
|
| 代码导航 |
|
|
| 终端执行 |
|
|
| 网络请求 |
|
|
| 代码理解 |
|
|
| 版本控制 |
|
|
| 调试工具 |
|
|
二、四重提问境界:从操作员到架构师
使用 Claude Code 这类高级 Agent 系统,提问方式决定了你能发挥多大的威力。根据源码分析和实战经验,我将提问方式分为四个境界。
2.1 第一重:指令式提问(操作员模式)
这是最基础的用法,你把 AI 当作一个听话但需要手把手教的实习生。
-
• 特征:每一步都给出具体指令,AI 只负责执行。 -
• 典型表现: “打开 src/components/Login.tsx,把第 10 行的 useEffect 改成 useLayoutEffect。”“运行 npm install,然后执行 npm run dev。”
-
• 问题:效率极低,你成为了系统的瓶颈。AI 的自主能力完全被浪费。
2.2 第二重:流程式提问(监工模式)
你开始意识到 AI 可以处理多步骤任务,但仍然需要你来规划流程。
-
• 特征:给出一个流程,AI 按顺序执行。 -
• 典型表现: “先读取这个文件,然后修改这个函数,接着运行测试,如果报错就修复。”
-
• 问题:比第一重好,但仍然限制了 AI 的规划能力。你仍然是系统的瓶颈。
下一篇(二):意图式提问 + 系统式提问 + 实战案例分析
参考文献:
-
1. 拆解 Claude Code:从底层机制到 10 倍效率的实战指南 -
2. Claude Code源码泄露:5 个 Agent 设计模式拆解

夜雨聆风