Runway Dev插件进了Claude Code、Codex和Cursor:给海外产品加AI视频功能,一次安装就接上

做海外 SaaS 或电商工具的朋友，可能都想过给产品加个 AI 视频、图片功能，比如给店里每件商品自动出一条展示视频。难的往往不是调接口本身，而是选哪个模型、怎么控成本、出错了怎么查。

11月2日，Runway 发布了给编程 Agent 用的 Runway Dev 插件（Runway Dev plugin），Claude Code、Codex 和 Cursor 都能装。我把官方公告和安装文档（docs.dev.runwayml.com）对照着看了一遍，整理成能照着做的版本。

一次安装，装进来两样东西：

Runway Dev MCP。 让 Agent 能读你的 Runway Dev 账户：有哪些项目、每个项目能用哪些模型、价格和限额、积分余额，还能设置 模型路由（Model Router）、管理实时数字人 角色（Characters）、查失败的任务。

一组技能。 教 Agent 用官方 SDK 正确地接 API。Claude Code 版的文档列了七个技能，从初始化、选模型到 现成管线（Recipes） 和 工作流（Workflows） 都有。

要特别说明：插件本身不生成视频。 生成是在你自己的应用里通过 API 跑的，插件只负责让 Agent 把集成写对。

Claude Code 在终端里依次运行：

claude plugin marketplace add anthropics/claude-plugins-official

claude plugin install runway-api@claude-plugins-official

claude mcp login plugin:runway-api:runway-dev

最后一条会打开浏览器，让你登录 Runway Dev 账户。

Codex 运行 codex plugin marketplace add runwayml/skills，再 codex plugin add runway-api@runway-dev，最后 codex mcp login runway-dev。注意文档写明 Codex 的 IDE 扩展不支持插件。

Cursor 最简单，在 Agent 对话框里输入 /add-plugin runway-api，选安装就行。

也可以在侧边栏的 自定义（Customize） 里搜 Runway Dev 安装，选用户级还是项目级。

官方专门提醒：只从一个地方装。 装两份的话，Agent 会加载两套重复的技能。

一是 Agent 先读账户再动手。它知道你这个项目能用哪些模型、单价多少、还剩多少积分，写出来的集成是按你实际的权限来的，不会写一堆你根本调不了的模型。有点东西。

二是出错能查。任务失败时，Agent 能直接看错误详情，以及模型路由为什么选了某个模型，排查不用再来回翻控制台。

三是能复用现成的东西。官方说常见用法可以直接基于 Recipes 这类现成管线来搭，团队在 Runway 应用里做好的工作流，也能发布成 API 接口让 Agent 调用。对小团队来说，等于不用每个功能都从零写起。

装好之后怎么确认装对了？官方给的办法很简单：直接问 Agent 连的是哪个 Runway Dev 账户、还剩多少积分。它能答出你的账户邮箱和当前余额，就说明连上了。

插件里不存 API 密钥，登录走 OAuth。

但真正调用生成，还需要单独的密钥，环境变量名是 RUNWAYML_API_SECRET。官方建议在 Runway Dev 账户里自己创建，自己写进项目的环境文件，不要贴进对话里，也不要写死在代码里。

登录这一步也建议自己完成，不要让 Agent 代劳。

Claude Code 用的是专门的 MCP 端点，不能新建角色，要去 Runway Dev 账户里建。

先在空项目里跑通。 让 Agent 做一个最小功能，比如上传一张商品图出一段短视频，确认流程通了再接进正式产品。

上线前算好账。 每次生成都扣积分，用户量一上来费用会跟着涨。给每个用户设生成次数上限，别让免费用户无限调用。

做好失败兜底。 生成失败或排队太久时，前端要有提示，别让用户干等。

生成内容要审。 面向海外用户，生成的视频里有没有品牌、人物肖像等问题，上线前要有审核机制。

插件把「接入」这一步的门槛降低了不少，省掉的主要是查文档、试接口的时间，但产品层面的限额、成本和审核，还得你自己设计。具体命令和价格以官方文档为准。