Code Mode：通过代码执行减少68%的MCP令牌使用

Code Mode 官方网站 是一款面向AI代理开发的工具库，通过TypeScript代码执行替代传统的工具调用方式。LLM擅长编写代码但不擅长工具调用，Code Mode通过提供一个强大的TypeScript执行沙箱来解决这一问题，让模型能够访问整个工具包，从而将复杂的多步骤工作流转换为单批处理执行。

产品概览

Code Mode是一个即插即用的库，支持代理通过代码执行调用MCP和UTCP工具。它专为开发者设计，特别适合需要处理复杂工作流的AI代理开发场景。独立研究显示，使用Code Mode可以实现60%更快的执行速度、68%更少的令牌使用和88%更少的往返次数，Anthropic研究团队甚至发现令牌使用量减少了98.7%。

核心能力与特性

渐进式工具发现

Code Mode允许代理动态发现工具，只加载所需的内容：

// 代理动态发现工具，只加载需要的部分
const tools = await client.searchTools('github pull request');
// 从500个工具定义 → 3个相关工具

自然代码执行

支持在单个请求中链式执行多个操作：

const { result, logs } = await client.callToolChain(`
  // 在单个请求中链式执行多个操作
  const pr = await github.get_pull_request({ owner: 'microsoft', repo: 'vscode', pull_number: 1234 });
  const comments = await github.get_pull_request_comments({ owner: 'microsoft', repo: 'vscode', pull_number: 1234 });
  const reviews = await github.get_pull_request_reviews({ owner: 'microsoft', repo: 'vscode', pull_number: 1234 });

  // 在沙箱内高效处理数据
  return {
    title: pr.title,
    commentCount: comments.length,
    approvals: reviews.filter(r => r.state === 'APPROVED').length
  };
`);
// 单个API调用替代15+传统工具调用

自动生成的TypeScript接口

Code Mode自动为所有工具生成TypeScript接口，提供完整的类型支持。

企业级特性

Code Mode具备企业级应用所需的安全性和可靠性：

• 安全的VM沙箱 – Node.js隔离防止未授权访问
• 超时保护 – 可配置的执行限制防止代码失控
• 完整的可观测性 – 完整的控制台输出捕获和错误处理
• 零外部依赖 – 工具只能通过注册的UTCP/MCP服务器访问
• 运行时内省 – 动态接口发现支持自适应工作流

多协议支持

Code Mode支持任何工具生态系统：

• MCP – 模型上下文协议服务器
• HTTP – 带有自动发现的REST API
• File – 本地JSON/YAML配置
• CLI – 命令行工具执行

性能基准

独立的Python基准研究验证了性能声明，在每天1,000个场景下可实现每年9,536美元的成本节约：

场景复杂度	传统方式	Code Mode	改进
简单(2-3个工具)	3次迭代	1次执行	67%更快
中等(4-7个工具)	8次迭代	1次执行	75%更快
复杂(8+工具)	16次迭代	1次执行	88%更快

上手使用

三行代码开始使用

import { CodeModeUtcpClient } from '@utcp/code-mode';

const client = await CodeModeUtcpClient.create();                    // 1. 初始化
await client.registerManual({ name: 'github', /* MCP配置 */ });  // 2. 添加工具
const { result } = await client.callToolChain(`/* TypeScript代码 */`);   // 3. 执行代码

即用型MCP服务器

对于不想进行任何设置的用户，可以使用即插即用的MCP服务器：

{
  "mcpServers": {
    "code-mode": {
      "command": "npx",
      "args": ["@utcp/code-mode-mcp"],
      "env": {
        "UTCP_CONFIG_FILE": "/path/to/your/.utcp_config.json"
      }
    }
  }
}

典型应用场景

Code Mode适用于多种AI代理开发场景：

• 金融工作流 – 发票处理、费用跟踪
• DevOps操作 – 部署、监控
• 数据处理 – 分析、报告
• 业务自动化 – CRM、通知

开发体验

IDE集成

生成TypeScript定义以获得完整的IntelliSense支持：

// 生成工具接口
const interfaces = await client.getAllToolsTypeScriptInterfaces();
await fs.writeFile('generated-tools.d.ts', interfaces);

调试与监控

内置的可观测性支持生产环境部署：

const { result, logs } = await client.callToolChain(userCode);

// 将日志发送到监控系统
logs.forEach(log => {
  if (log.startsWith('[ERROR]')) monitoring.error(log);
  if (log.startsWith('[WARN]')) monitoring.warn(log);
});

了解更多

• Cloudflare研究 – 原始代码模式白皮书
• Anthropic研究 – MCP代码执行优势
• Python基准研究 – 全面的性能分析
• UTCP规范 – 官方TypeScript实现

小结与行动建议

Code Mode通过创新的代码执行方式显著提升了AI代理的工具调用效率，为开发者提供了更加高效和可靠的解决方案。如果您正在开发AI代理应用，特别是需要处理复杂工作流的场景，Code Mode值得尝试。

了解更多信息，请访问官方网站，查看文档获取详细的使用指南。