乐于分享
好东西不私藏

Claude Code 源码解读:学会向 AI 提问

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+)

工具类别
工具名称
用途
文件操作
Read, Write, Edit, MultiEdit
文件读写与修改
代码导航
Grep, Glob, LS
代码搜索与浏览
终端执行
Bash
命令行执行
网络请求
WebFetch, WebSearch
网页抓取与搜索
代码理解
ASTGrep, SymbolSearch
代码结构分析
版本控制
Git
Git 操作
调试工具
Debug, Log
调试与日志

二、四重提问境界:从操作员到架构师

使用 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. 1. 拆解 Claude Code:从底层机制到 10 倍效率的实战指南
  2. 2. Claude Code源码泄露:5 个 Agent 设计模式拆解