概览

在你的编程 Agent 里使用 ModelFold

ModelFold 提供两个 Agent skill。skill 是一小组指令，你的编程 Agent（Claude Code、Codex、Cursor 等支持 skill 的 Agent）会自己加载它。装好之后，你只需用大白话说想要什么结果，API 调用由 Agent 来完成，不用再把文档一段段贴进对话里。

npx skills add https://ai.modelfold.online

先设置 API Key： export MODELFOLD_API_KEY=your_key。没有的话到 控制台 → API Keys 创建一个。

---

可用的 skill

modelfold-models：用 ModelFold 模型开发 可用

让 Agent 直接使用 ModelFold 上的图片、视频、语音和对话模型。Agent 会自己查模型列表、选择合适的接口、提交请求、等待结果并把文件保存到你指定的位置。

• 适合：在自己的应用里接入生成能力，或者直接产出图片、视频、音频文件。
• 类型：图片 · 视频 · 语音 · 对话
• 从这里开始：安装 modelfold-models → Agent 能做什么

modelfold-chat-agents：在编程 Agent 中使用 ModelFold 可用

用 ModelFold 积分，在 ModelFold 的对话模型上运行 Claude Code、Codex CLI 或 Grok Build。ModelFold 按各家原生协议提供接口（Anthropic Messages、OpenAI Responses、xAI Responses），支持流式输出和工具调用，只需改 base URL 和 Key。

• 适合：想让自己的编程 Agent 走 ModelFold 的模型和计费。
• 目前覆盖：Claude Code · Codex CLI · Grok Build
• 从这里开始：安装 modelfold-chat-agents → Claude Code / Codex CLI / Grok Build

---

示例请求

你想要	示例请求
直接生成一个文件	“用 ModelFold 上的 GPT Image 2 生成一张白色陶瓷杯的 1:1 产品图，保存到 ./public”
在自己的应用里加生成能力	“给我的后端加一个接口，调用 ModelFold 的 Veo 3.1 生成视频”
语音	“用 ModelFold 的 TTS 模型把这段介绍读出来，保存为 intro.mp3”
查模型和价格	“列出 ModelFold 上所有视频模型和每次的积分价格”
用 ModelFold 积分跑 Claude Code	“把 Claude Code 配置成使用 ModelFold”

---

快速开始

1. 安装 skill（每台机器一次，需要 Node.js）：

   npx skills add https://ai.modelfold.online

2. 创建 API Key。 到 控制台 → API Keys 创建。

3. 导出为环境变量 MODELFOLD_API_KEY。 skill 从这个变量读取密钥，不需要写进项目文件。

   macOS / Linux：

   export MODELFOLD_API_KEY=your_key

   Windows（PowerShell）：

   $env:MODELFOLD_API_KEY = "your_key"
   setx MODELFOLD_API_KEY "your_key"

4. 重启 Agent，然后直接提需求。 例如：“用 modelfold-models skill 列出 ModelFold 上的图像模型”。

以后想更新到最新版 skill，重新运行一次安装命令即可。