嗨，朋友！今天咱们聊聊Claude Code Agent是怎么跑起来的。别kan它名字挺高大上，其实它背后是一套可爱又灵活的架构。你Ke以把它想象成一个Neng自己拆任务、叫工具、记住历史、还会跟你聊天的智Neng小助手。

在 Claude Code 的世界里所有工具dou不需要自己去抓取环境信息。它们拿到的dou是一个大对象——ToolUseContext。这个对象里装着：

// src/src/Tool.ts - ToolUseContext 核心字段概览type ToolUseContext = {
    // 工具相关
    options: {
        tools: Tools                      // 可用工具池
        commands: Command               // 可用 Slash Commands
        thinkingConfig: ThinkingConfig     // 思考配置
        mcpClients: McpClientMap          // MCP 客户端  
    }
    // 中断与取消  
    abortController: AbortController     // 用户可随时取消  
    // 文件状态  
    readFileState: FileStateCache       // 文件读取缓存  
    // 状态管理  
    getAppState:  => AppState         // Zustand 全局状态读取  
    setAppState:  => void      // 状态geng新  
    // Agent 追踪  
    agentId?: string                     // 当前 Agent ID  
    queryTracking?: QueryTracking       // 当前查询追踪信息  
    contentReplacementState: ContentReplacementState   // 上下文压缩状态  
    permissionContext: PermissionContext   // 权限上下文 
}

一句话说它把所有“外部”依赖dou塞进去，让工具只关心自己的业务逻辑。这样Zuo符合依赖注入的原则，也让工具geng易测试、geng易组合。

想想kan，Ru果每个工具dou得自己去读文件、去检查权限，那代码会变得混乱，难以维护。把这些公共职责集中起来就像给所有人配了统一的“厨房”，每个人只负责切菜、炒菜。

Claude Code 并不是单一的 ChatGPT，而是一个由主 Agent和若干工作 Agent组成的团队。主 Agent 的职责：

任务拆分——把大问题拆成细粒度子任务；

派发——决定哪个子代理负责哪个子任务；

结果聚合——把各自完成的结果拼成Zui终答案。

Coordinator Mode 就是这种模式的实现方式。在代码里你会kan到类似下面的调用路径：

// src/src/tools/AgentTool/AgentTool.tsx - call 方法逻辑框架async call {
  if  {
      return spawnTeammate
  }
  if ) {
      return runForkedAgent
  }
  const agentDef = resolveAgentDefinition
  return runAgent
}

"spawnTeammate" 是给团队协作准备的；"runForkedAgent" 则是轻量级子代理，复用了父亲那份 Prompt Cache；而普通子代理则完全独立执行。这样既保证了效率，又保持了安全性。

"Fork 子代理" 的核心在于共享同一份缓存参数。这意味着当父亲问“请给我Zui近一次提交的代码”，孩子Ke以直接从缓存里拿，而不是重新请求模型，省掉不少 token 和延迟。

Colede Code 默认使用 Server-Sent Events流式调用 Anthropic API。这种方式支持事件级别处理，让我们Ke以在接收到模型输出的一小段文字时就立刻展示，而不是等整个回复完成。

// src/src/services/tools/StreamingToolExecutor.ts - 工具状态机type TrackedTool = {
 id: string,
 block: ToolUseBlock,
 status: 'queued' | 'executing' | 'completed' | 'yielded',
 isConcurrencySafe: boolean,
 promise?: Promise,
 results?: Message,
 pendingProgress: Message,
 contextModifiers?: Array< => ToolUseContext>
}
function canExecuteTool:boolean {
 const executingTools = this.tools.filter
 return executingTools.length === /*some threshold*/ || 
   )
}

"status" 字段让我们知道工具当前在哪个阶段，'queued' 等待排队；'executing' 正在跑；'completed' Yi经结束；而 'yielded' 则表示Yi经有进度信息返回但还没全部完成。这些状态让整个执行流程透明又可控。

"StreamingToolExecutor" 同时负责：

并发判定：Ru果多个工具dou是并发安全，就Ke以一起跑；否则排队等着;

错误回滚：某个工具报错就Neng立即触发 PostFailure 钩子;

进度回调：长时间操作也Neng实时给用户kan进度条或日志;

A/B 测试：通过特性开关动态开启或关闭某些功Neng。

Colede Code 用 Bun 打包，并利用 bun:bundle.feature 宏来Zuo树摇晃。你会kan到类似下面的代码：

// src/src/tools.ts - 工具组装逻辑export function assembleToolPool: Tools {
 const builtins = getAllBaseTools
 const sortedMcpTools = .sort=>a.name.localeCompare)
 const merged=
 const deduplicated=uniqBy
 return deduplicated}
if){
   const { CoordinatorMode } = require
}
if){
   const { CronTool }=require
}

"feature" 就像一个门开关，只有打开了才会编译进去相关代码。这样既节省体积，又保证不同配置下不会跑出没必要的逻辑。

Colede Code 在设计上考虑到安全性，从文件读写到命令执行dou有层层防护。例如：

// src/src/hooks/useCanUseTool.tsx async function useCanUseTool:Promise{
 const tool=findToolByName
 const toolPermission=await tool.checkPermissions
 ifreturn toolPermission
 const globalPermission=await checkGlobalPermissionRules
 ifreturn globalPermission
 if{
   const bashAnalysis=parseBashCommand
   const dangerLevel=detectDangerousPatterns
   if{
     return{behavior:'block',reason:'Dangerous pattern detected'}
   }
 }
 return{behavior:'allow'}
}

"checkPermissions" 是工具自身权限校验；然后全局规则 核对；Zui后 Bash 特殊检测确保不被恶意命令攻击。Ru果任何一步失败，就直接拦截，不会让危险操作进入模型层面。