Claude Code 深度拆解：一个顶级 AI 编程工具的核心架构

function processUserInput(input: string, mode: InputMode): UserMessage {
  if (input.startsWith('/')) {
    return handleSlashCommand(input);
  } elseif (input.startsWith('!')) {
    return handleBashCommand(input.slice(1));
  } else {
    return createUserMessage(input);
  }
}

// 简化的查询逻辑
async function* query(
  messages: Message[],
  systemPrompt: string,
  context: Context,
  canUseTool: CanUseToolFn,
  toolUseContext: ToolUseContext,
): AsyncGenerator<Message> {
  ## 1. 初始化大模型prompt
  const fullSystemPrompt = formatSystemPromptWithContext(systemPrompt, context)

  ## 2. 获取大模型返回
  const result = await queryWithBinaryFeedback(
    toolUseContext,
    getAssistantResponse,
    getBinaryFeedbackResponse,
  )

  ## 3. 处理模型返回的工具请求
  const toolUseMessages = assistantMessage.message.content.filter(
    _ => _.type === 'tool_use',
  )

  ## 4. 并行/串行执行工具
  if (
    toolUseMessages.every(msg =>
      toolUseContext.options.tools.find(t => t.name === msg.name)?.isReadOnly(),
    )
  ){
    for await (const message of runToolsConcurrently
  } else{
    for await (const message of runToolsSerially
  }

  ## 5. 处理后续交互
  yield* await query()
}

interface Tool {
  name: string;
  description: string;
  inputSchema: z.ZodType;
  execute(params: any): Promise<ToolResult>;
}

const fileEncodingCache = new LRUCache<string, BufferEncoding>({
  fetchMethod: path => detectFileEncodingDirect(path),
  ttl: 5 * 60 * 1000,
  ttlAutopurge: false,
  max: 1000,
})

const lineEndingCache = new LRUCache<string, LineEndingType>({
  fetchMethod: path => detectLineEndingsDirect(path),
  ttl: 5 * 60 * 1000,
  ttlAutopurge: false,
  max: 1000,
})

async *call({ pattern, path }, { abortController }){
    const start = Date.now()
    const { files, truncated } = await glob(
      pattern,
      path ?? getCwd(),
      { limit: 100, offset: 0 },
      abortController.signal,
    )
    const output: Output = {
      filenames: files,
      durationMs: Date.now() - start,
      numFiles: files.length,
      truncated,
    }
    yield {
      type: 'result',
      resultForAssistant: this.renderResultForAssistant(output),
      data: output,
    }
  },

const MAX_LINES = 4
const MAX_FILES = 1000
const TRUNCATED_MESSAGE = `There are more than ${MAX_FILES} files in the repository. Use the LS tool (passing a specific path), Bash tool, and other tools to explore nested directories. The first ${MAX_FILES} files and directories are included below:\n\n`

async function getContext(): Context {
  return {
    directoryStructure: await getDirectoryStructure(),
    gitStatus: await getGitStatus(),
    codeStyle: await getCodeStyle(),
    // 其他上下文...
  };
}

exportconst hasPermissionsToUseTool
  // 跳过
  if (context.options.dangerouslySkipPermissions) {
    return { result: true }
  }

  if (context.abortController.signal.aborted) {
    thrownew AbortError()
  }

  // 允许每个工具单独配置，由工具声明安全性，因为cc的工具都是自己实现的，他可以自己保证，后续这里MCP协议可能还需要看一看
  try {
    if (!tool.needsPermissions(input as never)) {
      return { result: true }
    }
  } catch (e) {
    logError(`Error checking permissions: ${e}`)
    return { result: false, message: 'Error checking permissions' }
  }

}

async function queryWithBinaryFeedback(
  toolUseContext: ToolUseContext,
  getAssistantResponse: () => Promise<AssistantMessage>,
  getBinaryFeedbackResponse?: (
    m1: AssistantMessage,
    m2: AssistantMessage,
  ) => Promise<BinaryFeedbackResult>,
): Promise<BinaryFeedbackResult> {
  if (
    process.env.USER_TYPE !== 'ant' ||
    !getBinaryFeedbackResponse ||
    !(await shouldUseBinaryFeedback())
  ):
  const [m1, m2] = await Promise.all([
    getAssistantResponse(),
    getAssistantResponse(),
  ])
}

▐  3.2MCP工具

整个Claude Code自身只维护了一个tengu_mcp_server，同时支持用户添加MCP Server，Claude Code通过三级分层的结构，来管理用户的MCP 工具：

• global：全局配置的通用的MCP

• MCPrc：配置文件，可以共享

• project：项目级别，就是当前的代码库可以单独配置

下层结构的MCP配置的可以覆盖上层的MCP配置。

exportconst getMCPTools = memoize(async (): Promise<Tool[]> => {
  const toolsList = await requestAll<
    ListToolsResult,
    typeof ListToolsResultSchema
  >(
    {
      method: 'tools/list',
    },
    ListToolsResultSchema,
    'tools',
  )

exportconst getCommandSubcommandPrefix = memoize(
  async (
    command: string,
    abortSignal: AbortSignal,
  ): Promise<CommandSubcommandPrefixResult | null> => {
    const subcommands = splitCommand(command)

    ## 获取命令前缀来观察是否在安全执行列表
    const [fullCommandPrefix, ...subcommandPrefixesResults] = await Promise.all(
      [
        getCommandPrefix(command, abortSignal),
        ...subcommands.map(async subcommand => ({
          subcommand,
          prefix: await getCommandPrefix(subcommand, abortSignal),
        })),
      ],
    )
  
  },
  command => command, // memoize by command only
)

## 创建标题任务
async function generateTitle(description: string): Promise<string> {
  const response = await queryHaiku({
    systemPrompt: [
      'Generate a concise issue title (max 80 chars) that captures the key point of this feedback. Do not include quotes or prefixes like "Feedback:" or "Issue:". If you cannot generate a title, just use "User Feedback".',
    ],
    userPrompt: description,
  })
  const title =
    response.message.content[0]?.type === 'text'
      ? response.message.content[0].text
      : 'Bug Report'
  if (title.startsWith(API_ERROR_MESSAGE_PREFIX)) {
    return `Bug Report: ${description.slice(0, 60)}${description.length > 60 ? '...' : ''}`
  }
  return title
}

## 确认前缀的任务
const getCommandPrefix = memoize(
  async (
    command: string,
    abortSignal: AbortSignal,
  ): Promise<CommandPrefixResult | null> => {
    const response = await queryHaiku({
      systemPrompt: [
        `Your task is to process Bash commands that an AI coding agent wants to run.

This policy spec defines how to determine the prefix of a Bash command:`,
      ],

Examples:
- cat foo.txt => cat
- cd src => cd
- cd path/to/files/ => cd
- find ./src -type f -name "*.ts" => find
- gg cat foo.py => gg cat
- gg cp foo.py bar.py => gg cp
- git commit -m "foo" => git commit
- git diff HEAD~1 => git diff
- git diff --staged => git diff
- git diff $(pwd) => command_injection_detected
- git status => git status

/**
 * The rules of thinking are lengthy and fortuitous. They require plenty of thinking
 * of most long duration and deep meditation for a wizard to wrap one's noggin around.
 *
 * The rules follow:
 * 1. A message that contains a thinking or redacted_thinking block must be part of a query whose max_thinking_length > 0
 * 2. A thinking block may not be the last message in a block
 * 3. Thinking blocks must be preserved for the duration of an assistant trajectory (a single turn, or if that turn includes a tool_use block then also its subsequent tool_result and the following assistant message)
 *
 * Heed these rules well, young wizard. For they are the rules of thinking, and
 * the rules of thinking are the rules of the universe. If ye does not heed these
 * rules, ye will be punished with an entire day of debugging and hair pulling.
 */

随着Claude Code的爆火出圈，我们发现这个产品是真实地提高程序员的开发效率。我们也持续追踪了两个月Claude Code的升级进展，帮助了很多同学在国内环境使用Claude Code。随着Cursor、Claude Code对国内ip加大力度管控，使用这类前沿工具变得十分困难，但最近一个月也迎来了很多惊喜：Kimi K2、Qwen3-Coder、GLM-4.5 等国产大模型相继涌现，Gemini CLI 也宣布开源。国产编程工具正不断突破创新，致力于为国内开发者打造更智能、更高效的极致开发体验。

心流团队一直在探索AGI的路上，我们也一直在找寻最通用AI助手的技术架构和产品形态，CLI + MCP的出现让我们觉得这可能就是我们实现AGI的路径。所以我们向大家隆重介绍我们最新研发的CLI工具，iFlow CLI 2.0。

它基于Gemini CLI改造，我们花了一些时间打磨它，融合了一些Claude Code的特性。

• 支持4种运行模式。yolo（模型最大权限，可以执行任何操作），accepting edits(模型只有修改文件权限), plan mode(先规划后执行), default(模型无任何权限)；

• 升级subAgent功能。让CLI从通用助手向专家团队进化，为你提供更加专业、更加准确的建议，使用/agent可以看到更多预先配置好的agent；

• 升级task工具。有效压缩上下文长度，让CLI能够更加深入完成你的任务，上下文达到70%的时候会自动压缩；

• 接入心流开放市场。快速安装好用的MCP工具、Subagent和自定义指令，可以通过/mcp了解更多；

• 免费使用多模态模型，也可以在CLI中粘贴图片了（Ctrl+V粘贴图片）；

• 支持历史对话保存和回滚(iflow --resume和/chat命令）；

• 支持更多更好用终端命令（iflow -h查看更多命令）；

• 支持VSCode、Jetbrains插件(注意IDE对应版本号)；

• 自动升级，再也不用担心最新功能体验不到了；

▐  5.1 一键安装

mac/linux/ubuntu用户

# 一键安装脚本，会安装全部所需依赖
bash -c "$(curl -fsSL https://gitee.com/iflow-ai/iflow-cli/raw/main/install.sh)"

# 已有Node.js 22+
npm i -g @iflow-ai/iflow-cli@latest

已经安装过的同学可以再次执行这个脚本，实现更新，后续cli会自动更新。

Windows用户

1. 访问 https://nodejs.org/zh-cn/download 下载最新的 Node.js 安装程序；

2. 运行安装程序来安装 Node.js；

3. 重启终端：CMD 或 PowerShell；

4. 运行 npm install -g @iflow-ai/iflow-cli 来安装 iFlow CLI；

5. 运行 iflow 来启动 iFlow CLI；

缺少了MCP和Sub agent的CLI是不完整的，加入MCP和Sub agent的之后会让CLI变成领域专家！对于很多小白用户来说，操作实在太难了！

心流开放市场帮你解决 👉 立即体验：https://platform.iflow.cn/cli

MCP开放市场，一键安装，解锁高效工具。

agent开放市场，一键安装Subagent，引入更强大的专家agent。

复制安装命令！在终端中执行！一键安装体验MCP和Subagent！

这是CLI的强项，进入到你的项目中，打开iFlow CLI，什么功能不熟悉，问他；什么业务需要实现，描述清楚让CLI帮你实现；遇到报错了，把报错信息贴给CLI让它帮你解决。

使用本地的私有数据，绘制你自己的报告网站。

你会根据用户的问题/需求，根据任务执行的顺序收集信息，最终以HTML的方式产出一份报告。
  ## 任务执行顺序
  - 你会生成非常详细的信息搜集计划。
  - 然后根据信息搜集计划生成一个html template作为index.html，他包含了一些顶部菜单的预留位置，以及一个section模块预留位。
  - 根据信息搜集计划设计index.html的顶部菜单
  - 接着，你会按照信息搜集计划挨个进行信息收集，每收集一份信息，即生成对应的section代码插入到index.html中。
  - 插入过程中，你需要关注整体页面的样式，修复一些常见的显示错误，保障整体的风格一致性
  - 不断进行信息收集、section代码生成、html template内容填充，直到所有信息收集完毕
  - MUST：确保按照计划完成所有的action
  ## 对于最终的html产出
  - 设计趋势和最佳实践有深入理解，尤其擅长创造具有极高审美价值的用户界面。你的设计作品不仅功能完备，而且在视觉上令人惊叹，能够给用户带来强烈的"Aha-moment"体验。
  - 可能包括HTML、CSS、和JavaScript文件。不断根据任务，优化这个网页项目，使网页内容逐渐完整。最终，你需要产出一个**美观、现代、易读**的"中文"可视化网页。
  # 设计要求
  **设计目标：**
  *   **视觉吸引力：** 创造一个在视觉上令人印象深刻的网页，能够立即吸引用户的注意力，并激发他们的阅读兴趣。
  *   **可读性：** 确保内容清晰易读，无论在桌面端还是移动端，都能提供舒适的阅读体验。
  *   **信息传达：** 以一种既美观又高效的方式呈现信息，突出关键内容，引导用户理解核心思想。
  *   **情感共鸣:** 通过设计激发与内容主题相关的情感（例如，对于励志内容，激发积极向上的情绪；对于严肃内容，营造庄重、专业的氛围）。
  **设计指导（请灵活运用，而非严格遵循）：**
  *   **整体风格：** 可以考虑杂志风格、出版物风格，或者其他你认为合适的现代 Web 设计风格。目标是创造一个既有信息量，又有视觉吸引力的页面，就像一本精心设计的数字杂志或一篇深度报道。
  *   **Hero 模块（可选，但强烈建议）：** 如果你认为合适，可以设计一个引人注目的 Hero 模块。它可以包含大标题、副标题、一段引人入胜的引言，以及一张高质量的背景图片或插图。
  *   **排版：**
      *   精心选择字体组合（衬线和无衬线），以提升中文阅读体验。
      *   利用不同的字号、字重、颜色和样式，创建清晰的视觉层次结构。
      *   可以考虑使用一些精致的排版细节（如首字下沉、悬挂标点）来提升整体质感。
      *   Font-Awesome中有很多图标，选合适的点缀增加趣味性。
  *   **配色方案：**
      *   选择一套既和谐又具有视觉冲击力的配色方案。
      *   考虑使用高对比度的颜色组合来突出重要元素。
      *   可以探索渐变、阴影等效果来增加视觉深度。
  *   **布局：**
      *   使用基于网格的布局系统来组织页面元素。
      *   充分利用负空间（留白），创造视觉平衡和呼吸感。
      *   可以考虑使用卡片、分割线、图标等视觉元素来分隔和组织内容。
  *   **调性：**整体风格精致, 营造一种高级感。
  *   **数据可视化：**
      *   设计一个或多个数据可视化元素，展示Naval思想的关键概念和它们之间的关系。
      *   可以考虑使用思想导图、概念关系图、时间线或主题聚类展示等方式。
      *   确保可视化设计既美观又有洞察性，帮助用户更直观地理解Naval思想体系的整体框架。
      *   使用Mermaid.js来实现交互式图表，允许用户探索不同概念之间的关联。
  **技术规范：**
  *   使用 HTML5、Font Awesome、Tailwind CSS 和必要的 JavaScript。
      *   Font Awesome: [https://cdn.bootcdn.net/ajax/libs/font-awesome/6.4.0/css/all.min.css](https://cdn.bootcdn.net/ajax/libs/font-awesome/6.4.0/css/all.min.css)
      *   Tailwind CSS: [https://g.alicdn.com/code/lib/tailwindcss/2.2.19/tailwind.min.css](https://g.alicdn.com/code/lib/tailwindcss/2.2.19/tailwind.min.css)
      *   非中文字体: [https://fonts.font.im/css?family=Noto+Serif+SC:wght@400;500;600;700&family=Noto+Sans+SC:wght@300;400;500;700&display=swap rel="stylesheet" media="print" onload="this.media='all';
  this.onload=null"]
      *   `font-family: Tahoma,Arial,Roboto,"Droid Sans","Helvetica Neue","Droid Sans Fallback","Heiti SC","Hiragino Sans GB",Simsun,sans-self;`
      *   Mermaid: [https://g.alicdn.com/code/lib/mermaid/11.5.0/mermaid.min.js](https://g.alicdn.com/code/lib/mermaid/11.5.0/mermaid.min.js)，在使用mermaid的时候，需要做mermaid initialize初始化
      *   Chart.js: [https://g.alicdn.com/code/lib/Chart.js/4.4.1/chart.umd.min.js](https://g.alicdn.com/code/lib/Chart.js/4.4.1/chart.umd.min.js)
  *   代码结构清晰、语义化，包含适当的注释。
  *   实现完整的响应式，必须在所有设备上（手机、平板、桌面）完美展示。
  **额外加分项：**
  *   **微交互：** 添加微妙而有意义的微交互效果来提升用户体验（例如，按钮悬停效果、卡片悬停效果、页面滚动效果）。
  *   **补充信息：** 可以主动搜索并补充其他重要信息或模块（例如，关键概念的解释、相关人物的介绍等），以增强用户对内容的理解。
  **输出要求：**
  *   提供一个完整、可运行的网页项目，其中包含所有必要的多个 HTML、CSS 和 JavaScript文件。
  *   每一个文件内容尽量少，可以通过文件引用来避免重复，重复读/重复写会浪费token数量。
  *   确保代码符合 W3C 标准，没有错误或警告。
  *   在根目录下维护**项目大纲**文档，来记录你的设计思路、代码模块功能、文件内容概要等，每一次变动都会记录在项目大纲中，方便下一次优化时定位优化文件。
  <用户的问题>
计划9月15到9月24或25去西欧旅游，杭州出发亲子游，共9天。地点选择Amsterdam、Cologne、Paris和Saarbrücken。为这个行程做规划和设计，要求是： 1. 少走回头路，自驾旅游，亲子为主。 2.8月23号要在Saarbrücken参观比赛 3. Cologne预留3天 4.回城的飞机可以在巴黎或者德国，找价格低的航班。
  </用户的问题>
  当前时间是2025年8月21日，我们开始吧！

产品需求文档 -> 需求处理Agent -> UI设计Agent -> UI优化Agent -> 代码逻辑开发Agent -> 接口集成Agent -> 单元测试Agent

目前我们的合作团队已经实现了这样的CLI开发范式，待后续上线我们会公开具体细节，欢迎大家和我们交流合作!

更多最佳实践等你来发现！