OpenRouter 官方提供了 openrouter-typescript-sdk skill，可安装到 Claude Code、Cursor、OpenCode、GitHub Copilot 等 7 种主流 AI 编程助手中。安装后，助手将具备 callModel API、tool() 工具定义、stop conditions、streaming、多轮对话等 Agent SDK 核心功能的完整知识，无需每次手动翻文档。本页提供各平台的安装命令和使用示例。

概览

将 OpenRouter Agent SDK 的知识安装到你的 AI 编程助手，通过官方 openrouter-typescript-sdk skill（来自 OpenRouterTeam/skills 仓库）实现。

该 skill 同时覆盖：

• Agent SDK (@openrouter/agent)
• Client SDK (@openrouter/sdk)

快速安装

Claude Code

/plugin marketplace add OpenRouterTeam/skills
/plugin install openrouter@openrouter

Cursor

通过 Settings > Rules > Add Rule > Remote Rule (Github)，输入 OpenRouterTeam/skills 添加。

Skills CLI（通用）

npx skills add OpenRouterTeam/skills

支持的 AI 编程助手

助手	状态
Claude Code	已支持
Cursor	已支持
OpenCode	已支持
GitHub Copilot	已支持
Codex	已支持
Amp	已支持
Roo Code	已支持

Skill 提供的知识范围

安装后，AI 编程助手将具备以下知识：

• callModel API — 推荐的模型调用方式，完整类型安全和 streaming 支持
• Tool 定义 — 使用 tool() helper 和 Zod schemas 创建工具
• Stop Conditions — 使用 stepCountIs、maxCost 等控制 agent 循环终止
• Streaming — agent 步骤内实时 token 输出
• 多轮对话 — 跨轮次管理对话状态
• 动态参数 — 在轮次之间切换 model、temperature 或 tools

使用示例

安装 skill 后，你可以直接对助手说：

"帮我搭建一个 OpenRouter agent"

import { callModel } from '@openrouter/agent';

const response = await callModel({
  model: 'anthropic/claude-sonnet-4',
  messages: [
    { role: 'user', content: 'Hello!' }
  ]
});

"给我的 agent 添加一个工具"

import { callModel, tool } from '@openrouter/agent';
import { z } from 'zod';

const searchTool = tool({
  name: 'search',
  description: 'Search the web',
  inputSchema: z.object({ query: z.string() }),
  execute: async ({ query }) => {
    return { results: ['...'] };
  },
});

const result = await callModel({
  model: 'anthropic/claude-sonnet-4',
  messages: [{ role: 'user', content: 'Search for TypeScript best practices' }],
  tools: [searchTool],
});

Skill 仓库

Skill 源码：github.com/OpenRouterTeam/skills

常见问题

Q: 安装 skill 后，助手如何知道调用哪个 API？

A: skill 将 Agent SDK 的 API 文档、类型定义和代码示例注入到助手的上下文中。助手会根据你的描述自动选择合适的 callModel、tool() 或其他 API。

Q: skill 需要定期更新吗？

A: 是的。OpenRouter 更新 SDK 后，skill 仓库也会同步更新。重新运行安装命令可获取最新版本。

Q: 如果助手不支持 skill 安装怎么办？

A: 可以直接将 Agent SDK 文档 的内容粘贴到助手的 system prompt 或上下文中作为参考文档。