Agent Skills

让 Claude Code、Codex、Cursor 等编程 agent 用你的 RouteMux API key 出图、生成视频。三步搞定：拿 key、安装、开口说。

装上 RouteMux Agent Skills，你的编程 agent 就多了几样本事：用 GPT Image 2.5 出图和改图、用 MiniMax H3 生成短视频、查模型和价格、把各种工具接到 RouteMux。你只管用大白话提要求，剩下的 agent 自己办，费用从你的 RouteMux 钱包扣。

Claude Code、Codex、Cursor、OpenCode、Gemini CLI，以及其他认 SKILL.md 格式的 agent 都能用。

开始之前

账号至少充值过一次。 出图模型（openai/gpt-image-2.5-flare、openai/gpt-image-2.5-sunburst）和视频模型（minimax/minimax-h3）在首次充值后解锁，金额不限 —— 去充值。
本机有 bash、curl 和 python3。skill 只用这三样。

第一步：拿到 API key

Claude Code、Codex、Qwen Code 或 Gemini CLI 已经接了 RouteMux？ 这一步跳过：skill 直接用你的 agent 已经在发给 RouteMux 的那把 key。见 key 从哪来。

否则：

在 routemux.com/console/keys 创建一把 key。
把下面这行加到 shell 配置文件里 —— 用 zsh（macOS 默认）就写进 ~/.zshrc，用 bash 就写进 ~/.bashrc：
```
export ROUTEMUX_API_KEY='sk-...'
```
新开一个终端，让改动生效。

如果第二步你用的是安装脚本，它会问你要 key，并可以替你写进配置文件。

第二步：安装 skills

npx skills add https://routemux.com -g

需要 Node.js。它会找出你机器上装了哪些 agent，问你要装到哪几个里。想跳过这一问，直接点名：

npx skills add https://routemux.com -g -a codex

npx skills add https://routemux.com -g -a claude-code

-g 表示对你所有项目生效；去掉它就只装进当前项目。

没装 Node.js，或者想用 Claude Code 插件？见其他安装方式。

第三步：直接说

从新开的终端启动 agent（这样它才看得到 key），然后说：

画一个极简风格的咖啡店 logo，存到 ./logo.png

agent 会先写好一段详细的提示词，然后出图，最后告诉你文件存在哪、实际尺寸、用的哪个模型、多少钱。

skill 第一次运行时，agent 会征求你的许可，点允许就行：

Claude Code 会问能不能执行一条 Bash 命令。
Codex 可能会请你批准联网。

如果装的时候 Codex 正开着，先重启它。

agent 是从程序坞启动的？

从程序坞（Dock）或桌面启动器打开的 agent 不读你的 shell 配置文件，所以可能看不到 key。改从终端启动；或者把 key 写进 agent 自己的配置里 —— 见agent 看不到 key。

点名调用

用大白话说就够了。想直接点名某个 skill：

Agent	出图	视频
Claude Code（以插件安装）	`/routemux:routemux-images`	`/routemux:routemux-video`
Claude Code（用 npx 或脚本安装）	`/routemux-images`	`/routemux-video`
Codex	`$routemux-images`	`$routemux-video`
其他 agent	直接说	直接说

一共有哪几个

Skill	做什么	可以这样说
`routemux-images`	用 GPT Image 2.5 出图、改图。详细说明	「给爵士之夜做一张海报」
`routemux-video`	用 MiniMax H3 根据文字生成视频。详细说明	「来一段 5 秒的雨打窗户」
`routemux-models`	你的 key 能调哪些模型、多少钱、支持什么	「我的 key 能用哪些出图模型？」
`routemux-setup`	把你的工具接到 RouteMux	「帮我把 Codex 配成走 RouteMux」

其他安装方式

Claude Code 插件

需要 Claude Code 2.1.224 或更高版本。在 Claude Code 会话里逐条输入：

/plugin marketplace add https://routemux.com/.well-known/agent-skills/marketplace.json

/plugin install routemux@routemux

/reload-plugins

插件和 npx 二选一

在 Claude Code 里，插件和 npx 只装一种。两种都装，每个 skill 都会出现两遍。

安装脚本（不需要 Node.js）

curl -fsSL https://routemux.com/.well-known/agent-skills/install.sh | sh

这个脚本会：

找出你机器上的 agent，把 skills 装进各自的 skills 目录。
逐个核对下载文件的 sha256 摘要，有一个对不上就停下，不装。
如果还没设置 ROUTEMUX_API_KEY，它会问你要 key（输入时不显示），先拿去 RouteMux 验证， 你同意之后才追加到 shell 配置文件里。它会直接告诉你：key 在那里是明文保存的。如果你的 agent 已经接了 RouteMux，直接回车跳过。

只装给某一个 agent：

curl -fsSL https://routemux.com/.well-known/agent-skills/install.sh | sh -s -- --agent codex

其他选项：--dir PATH 装到你指定的目录，--no-key 跳过 key 这一步。

Agent	skills 目录
Claude Code	`~/.claude/skills`
Codex	`~/.agents/skills`
Cursor	`~/.cursor/skills`
OpenCode	`~/.config/opencode/skills`
Gemini CLI	`~/.gemini/skills`

手动下载

routemux.com/.well-known/agent-skills/index.json 这份清单里每个 skill 对应一个 zip，每条记录有 url（相对于 https://routemux.com）和 digest（sha256:...）。

下载你要的那个 skill 的 zip。
核对它的 sha256 和 digest 一致 —— macOS 用 shasum -a 256，Linux 用 sha256sum。
在 agent 的 skills 目录（见上表）里建一个以 skill 命名的文件夹，解压进去。SKILL.md 就在 zip 的根目录：
```
mkdir -p ~/.claude/skills/routemux-images
unzip routemux-images-*.zip -d ~/.claude/skills/routemux-images
```

key 从哪来

skill 按下表顺序找，用找到的第一把 key：

位置	什么时候用
`ROUTEMUX_API_KEY`	总是
`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_API_KEY`	`ANTHROPIC_BASE_URL` 是 `https://api.routemux.com` —— 已接 RouteMux 的 Claude Code
`OPENAI_API_KEY`	`OPENAI_BASE_URL` 是 `https://api.routemux.com/v1` —— Qwen Code、OpenAI SDK
`GEMINI_API_KEY`	`GOOGLE_GEMINI_BASE_URL` 是 `https://api.routemux.com/vertex-ai` —— Gemini CLI
`~/.codex/config.toml` 里某个 provider 的 `experimental_bearer_token`，或它 `env_key` 指向的变量	这个 provider 的 `base_url` 是 `https://api.routemux.com/v1` —— Codex。当前 `model_provider` 优先
`~/.claude/settings.json` 里的 `env.ANTHROPIC_AUTH_TOKEN` 或 `env.ANTHROPIC_API_KEY`	`env.ANTHROPIC_BASE_URL` 是 `https://api.routemux.com` —— Claude Code（skill 跑在别的 agent 里时用得上）

只比 base URL 的域名，所以带不带 /v1、末尾有没有斜杠都一样。base URL 指向别处的 key —— 厂商官方 API、别的网关、或者根本没设 base URL —— 是那个服务的，skill 一概不用。配置文件里，key 只和它所在那一项的 base URL 配对；CODEX_HOME / CLAUDE_CONFIG_DIR 也会照顾到。

skill 会碰什么

key 只从上面这些地方来：环境变量，以及 Codex 和 Claude Code 配置文件里指向 RouteMux 的那一项。skill 不读 .env 和任何其他文件，不会把 key 写到任何地方，也只发给 api.routemux.com。
它们只写一种文件：你要的图片和视频。
没有 eval，不装 SDK —— 只用 bash、curl 和一点 python3。MIT 许可。

接下来

出图 —— 尺寸、改图、模型和价格
视频 —— 时长、分辨率、画面比例和价格
排查 —— 看不到 key、需要先充值、更新和卸载

On this page