安装 modelfold-models
让你的编程 Agent 直接使用 ModelFold 上的图片、视频、语音和对话模型。
modelfold-models 教会 Agent 使用 ModelFold：查模型列表、按模型类型选接口、提交请求、等待结果并保存文件。
先决条件
- 一个支持 skill 的编程 Agent，例如 Claude Code、Codex、Cursor 或 Grok Build。
- Node.js 22.20 或更高（
npx skills的要求）。 - 一个 ModelFold API Key，在 控制台 → API Keys 创建；账户里要有积分。
第 1 步：安装 skill
在终端里运行。这条命令可以整段复制，不会停下来提问：
bash
npx skills add https://modelfold.ai --skill modelfold-models -g -a claude-code -a codex -a grok -y--skill modelfold-models只安装这一个 skill。去掉它会把站点上的 skill 全部装上（还有一个modelfold-chat-agents）。-g装到当前用户目录，所有项目可用。不加-g时只装进当前项目。-a指定 Agent。上面三个是 Claude Code、Codex 和 Grok Build。-y跳过选择。不带-y和-a时，终端会停下来等你选；没有交互终端时会直接失败，什么都不安装。- 不要在项目里不加这些参数地运行。在 Agent 里执行时，CLI 会把全部 skill 写进当前目录下几十个 Agent 文件夹。
装好的位置：
| Agent | 路径 |
|---|---|
| Claude Code | ~/.claude/skills/modelfold-models |
| Codex | ~/.agents/skills/modelfold-models |
| Grok Build | ~/.grok/skills/modelfold-models |
Claude Code 和 Grok Build 是指向 Codex 那份的软链。
Cursor
skills CLI 把 Cursor 当成通用 Agent。加了 -g 时它不会写入 Cursor 的全局目录 ~/.cursor/skills。在项目目录里运行：
bash
npx skills add https://modelfold.ai --skill modelfold-models -a cursor -y技能在该项目的 .agents/skills/modelfold-models。
想在所有项目里给 Cursor 用，全局安装之后再补软链：
bash
mkdir -p ~/.cursor/skills
ln -sfn ~/.agents/skills/modelfold-models ~/.cursor/skills/modelfold-models以后要更新，把对应的安装命令再运行一次。
第 2 步：设置 API Key
skill 从环境变量 MODELFOLD_API_KEY 读取密钥，不需要把密钥写进项目里。
macOS 与 Linux
在启动 Agent 的同一个 shell 里导出，或者写进 shell profile（~/.zshrc、~/.bashrc）：
bash
export MODELFOLD_API_KEY=your_keyWindows（PowerShell）
powershell
$env:MODELFOLD_API_KEY = "your_key"
setx MODELFOLD_API_KEY "your_key"setx 只对之后新开的窗口生效。想立刻用上，同时设 $env:。
第 3 步：试一下
在已设置 MODELFOLD_API_KEY 的 shell 里重启 Agent，然后直接用自然语言提需求：
text
Use the modelfold-models skill to list the image models on ModelFold, then generate a 1:1 product photo of a white ceramic mug on a light oak table with one of them. Save the image to ./output.Agent 会读取实时模型列表、调用图像生成接口、等待结果，并把文件保存到 ./output。每次成功调用会扣对应的积分，失败的任务自动退款。
让 Agent 选文生图模型。列表里积分最低的几项多半是图生图、放大或去背景，没有图片地址时不要选。
安全
- 把 API Key 放在环境变量里，不要贴进聊天、截图或会提交到仓库的文件。
- 密钥泄露后，立即到 控制台 → API Keys 吊销并新建。