TOPIC COLLECTION
Runway Dev插件进了Claude Code、Codex和Cursor：一次装好MCP和7个技能，插件本身不生成视频、不存API密钥，装之前先看这几点
Runway于2026年11月2日上线Runway Dev插件，支持Claude Code、Codex和Cursor：一次安装同时接入Runway Dev MCP与官方技能，编程智能体可读取账户里的项目、可用模型及价格限额和积分余额，帮你写视频/图片/音频生成接入代码。插件不直接生成媒体，采用OAuth登录、不保存API密钥；Codex IDE扩展暂不支持插件。
资料更新：2026-11-03
依据Runway官方新闻（2026-11-02）与Runway Dev文档《Install the Runway Dev plugin》《Connect Runway Dev》整理；各模型单价以Runway Dev账户内显示为准，本站未开通付费项目、未实测生成效果。核查2026-11-03（新加坡时间）。
主题标签：Runway、Runway Dev、MCP、Claude Code插件、AI视频API
11 月 2 日 Runway 发了一个面向开发者的更新：Runway Dev 插件上了 Claude Code、Codex 和 Cursor。说白了，就是让你在编辑器里跟编程智能体说一句「给商品库每个新品生成一段展示视频」，它能自己去查你的 Runway 账户、挑模型、写接入代码。
听起来像「AI 帮你做视频」，其实不是。文档里有一句很容易被忽略：插件本身不生成媒体，生成是在你的应用里通过 API 跑的。插件解决的是「把 Runway API 接进你的项目」这一步，不是替代 Runway 网页版。
插件里装了什么
一次安装，带两样东西：
- Runway Dev MCP：把智能体连到你的 Runway Dev 账户。它能看到你有哪些项目、每个项目能用哪些模型以及价格和限额、积分余额，能配置 Model Router（按请求自动选模型）、管理 Character（实时数字人），还能查失败任务和路由为什么选了某个模型；
- 技能（Skills）：教智能体用官方 SDK 正确接入。Claude Code 那篇指南列了 7 个：runway-dev-setup、runway-dev、runway-dev-models、runway-dev-model-routers、runway-dev-characters、runway-dev-recipes、runway-dev-workflows。
Recipes 是 Runway 预置好的流水线，Workflows 则是你团队在 Runway App 里搭好、发布成 API 端点的流程。常见需求，智能体会优先往这两样上靠，而不是从零拼调用。
三家编辑器怎么装
| 工具 | 官方安装方式 | 要留意的 |
|---|---|---|
| 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 浏览器登录；会话内也可 /plugin install runway-api@claude-plugins-official |
2.1.186 以前的版本，登录要在会话里用 /mcp 选 Runway Dev；Claude 专用 MCP 端点不能新建 Character |
| Codex CLI | codex plugin marketplace add runwayml/skills → codex plugin add runway-api@runway-dev → codex mcp login runway-dev；也可以在 ChatGPT 与 Codex 共用的插件目录里装 |
两处只装一处，否则会加载两份技能；Codex IDE 扩展不支持插件 |
| Cursor | Agent 对话里输入 /add-plugin runway-api 后点 Install；或侧栏 Customize 里搜 Runway Dev |
可选用户级或项目级安装，团队项目建议项目级 |
装完都要开一个新会话插件才生效，这一点三家一样。没有插件机制的其他智能体，可以只接 MCP：通用地址是 https://dev.runwayml.com/mcp，Claude Desktop 和 Claude Code 用的是 https://dev.runwayml.com/mcp/claude。
密钥和权限：比贴 API Key 稳一点
官方强调插件里不存 API Key，连接走 OAuth，第一次用时在浏览器里登录 Runway Dev 账户授权。文档还专门叮嘱：登录要你自己在常用浏览器里完成，别让智能体代劳。这个习惯挺好，和前几天站内写的Cursor 市场假 Claude Code 扩展是同一个道理：编辑器里装的东西越多，越要搞清楚谁拿着你的凭据。
不过 OAuth 不等于没风险。MCP 能读积分余额、能改 Model Router，意味着智能体在你的账户里有实际操作权。我自己的做法是：
- 给测试单独建一个 Runway Dev 项目，额度设小，别直接连生产项目；
- 智能体提议改 Router 或建 Character 时，看清楚再批准；
- 生成任务会实打实扣积分，批量跑之前先让它用一两条样本验证。
适合谁，不适合谁
Runway 自己的说法是给「靠指挥编程智能体交付的人」：独立开发者、技术型创始人、自己动手做功能的产品经理。典型用法是电商目录每上一个新品就自动出一条视频、内部工具加个「一键高清放大」按钮、新素材进来自动走本地化流程。
如果你只是想做几条短视频发社媒，这个插件对你没意义，直接用 Runway 网页或 App，或者国内的 可灵AI 更省事。它真正省的是接 API 时翻文档、对参数、查报错的时间。另外 Runway Dev 平台本身也聚合了其他厂商的模型，Model Router 会按请求挑，账单里能看到每个模型的花费。
和直接调 API 比，差在哪
不装插件，你一样可以让 Claude Code 照着 Runway API 文档写代码。区别在于「实时上下文」：插件版智能体知道你这个项目当前能调哪些模型、单价多少、还剩多少积分，写出来的代码不会去调你没权限的模型；任务失败时它能直接查到错误详情，而不是让你把报错贴回来。对于模型列表变化快的媒体 API，这一点比较实用。
如果你同时在比较其他视频模型 API，像 Vidu API、Luma AI API，可以去图像视频模型API分类看；纯做内容的工具在AI视频生成。编程智能体本身的对比在终端编程智能体和AI代码编辑器。
常见问题
装了插件就能在 Cursor 里直接出视频吗？
不能。官方文档写明插件不生成媒体，它帮智能体写和调试接入代码，真正的生成在你的应用通过 API 完成，并按 Runway Dev 账户计费。
需要先有 Runway Dev 账户吗？
需要。首次使用时要登录 Runway Dev 账户授权；没有账户的先去开发者平台注册。
VS Code 里的 Codex 扩展能用吗？
文档原话：Codex IDE 扩展不支持插件。要用就走 Codex CLI，或者手动把 MCP 地址配进 config.toml。
Claude Code 里为什么建不了 Character？
Claude 系列客户端连的是 /mcp/claude 专用端点，官方说明这个端点不能新建 Character，需要到 Runway Dev 账户里先建好。
来源与核查日期
- Runway News：Runway Dev is in Claude Code, Codex and Cursor（2026-11-02）
- Runway Dev Docs：Install the Runway Dev plugin
- Runway Dev Docs：Connect Runway Dev（MCP 地址）
- Runway Dev：How to build a generative media integration with Claude Code（7 个技能列表）
核查日期：2026-11-03（新加坡时间）。安装命令、端点与限制以 Runway Dev 文档实时版本为准；本站未开通付费项目，未实测生成质量与扣费速度。
