Code-Mode实战入门：如何在5分钟内搭建你的首个AI工具调用链

【免费下载链接】code-mode 🔌 Plug-and-play library to enable agents to call MCP and UTCP tools via code execution. 项目地址: https://gitcode.com/gh_mirrors/co/code-mode

Code-Mode是一款强大的开源库，能让AI代理通过代码执行轻松调用MCP和UTCP工具。本文将为你展示如何在短短5分钟内，快速搭建属于你的首个AI工具调用链，开启高效的AI工具调用之旅。

🚀 为什么选择Code-Mode

传统的工具调用方式往往需要暴露大量工具，操作繁琐且效率低下。而Code-Mode则另辟蹊径，它让AI代理只需通过一个工具就能执行TypeScript代码，从而访问整个工具集。这种方式被Apple、Cloudflare和Anthropic等知名企业认为是比传统工具调用更高效的方法。

独立的Python基准研究验证了其性能优势，在每天1000个场景下，每年可节省9536美元成本：

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

Code Mode优势所在：

• 批处理优势 - 单个代码块替代多个API调用
• 认知效率 - LLM擅长代码生成而非工具编排
• 计算效率 - 操作之间无需重新处理上下文

⚡ 3行代码快速上手

使用Code-Mode非常简单，只需3行代码就能让你的AI代理执行复杂工作流，替代数十次传统工具调用。

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. 执行代码

📦 安装步骤

1. 克隆仓库

首先，克隆Code-Mode项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/co/code-mode

2. 安装依赖

进入项目目录，安装所需依赖：

cd code-mode/typescript-library
npm install @utcp/code-mode

🛠️ 核心功能体验

渐进式工具发现

AI代理可以动态发现工具，只加载所需工具：

// 代理动态发现工具，只加载所需工具
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接口

系统会自动生成清晰的TypeScript接口，方便开发：

namespace github {
  interface get_pull_requestInput {
    /** 仓库所有者 */
    owner: string;
    /** 仓库名称 */
    repo: string;
    /** 拉取请求编号 */
    pull_number: number;
  }
}

🌟 企业级特性

Code-Mode具备企业级应用所需的各项特性：

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

🚀 即插即用的MCP服务器

如果不想进行任何设置就使用Code Mode？可以使用即插即用的MCP服务器配合Claude Desktop或任何MCP客户端：

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

这就完成了！无需安装，无需Node.js知识。Code Mode MCP服务器会自动：

• 通过npx下载并运行最新版本
• 从JSON加载工具配置
• 为Claude Desktop提供代码执行能力
• 提供call_tool_chain作为TypeScript执行的MCP工具

非常适合希望在Claude Desktop中使用Code Mode功能的非开发人员！

📝 总结

通过本文的介绍，你已经了解了Code-Mode的基本概念、优势以及如何快速搭建和使用它来构建AI工具调用链。借助Code-Mode，你可以让AI代理更高效地执行复杂任务，节省时间和成本。现在就动手尝试，体验Code-Mode带来的便捷与强大吧！

如果你在使用过程中遇到任何问题，欢迎查阅项目的官方文档或提交issue寻求帮助。

【免费下载链接】code-mode 🔌 Plug-and-play library to enable agents to call MCP and UTCP tools via code execution. 项目地址: https://gitcode.com/gh_mirrors/co/code-mode