ChatCut Agent Plugin 让外部桌面智能体创建和编辑 ChatCut 项目。你在智能体应用中描述想要的结果；ChatCut 编辑器会显示实际时间线，仍然可以随时手动调整。
支持哪些桌面应用？
| 桌面应用 | 如何开始安装 |
|---|---|
| Claude Code | 在 ChatCut 头像菜单的 Agent 插件 中，点击 Claude Code 旁的 复制 |
| Codex | 在 ChatCut 头像菜单的 Agent 插件 中，点击 ChatGPT/Codex 旁的 复制 |
| WorkBuddy | 打开 WorkBuddy 安装指南；当前头像菜单没有 WorkBuddy 复制按钮 |
插件需要安装在桌面应用中。不要把安装 prompt 粘贴到 Claude 网页版、ChatGPT 网页版、远程网页工作区或 ChatCut 网页编辑器。
Claude Code 安装 prompt
在 Claude Code 桌面应用中新建对话，粘贴并发送：
/goal 阅读 chatcut.io/claude 帮我安装和使用 ChatCut 插件
Codex 安装 prompt
在 Codex 桌面应用中创建新任务，粘贴并发送：
/goal 阅读 chatcut.io/chatgpt，帮我安装 ChatCut 插件并创建一个新任务。
WorkBuddy 的安装方式不同，当前应直接按照 chatcut.io/workbuddy 操作，不要套用 Claude Code 或 Codex 的 prompt。
安装 Claude Code 或 Codex 插件
- 打开 ChatCut 网页端并登录。
- 点击右上角头像，将鼠标悬停在 Agent 插件 上。
- 在 Claude Code 或 ChatGPT/Codex 旁点击 复制。
- 打开对应的桌面应用，新建对话或任务，粘贴 prompt 并发送。
- 等智能体打开 ChatCut 授权页；在该页面登录并允许访问。
- 安装完成后，按照提示新建会话或任务。插件工具只在会话启动时加载，安装用的旧会话不会自动获得新工具。
- 在新会话中明确说要使用 ChatCut，并描述想完成的剪辑。
更新插件
插件是从 Git marketplace 安装的，不会自己更新。在当初安装它的那个桌面应用里刷新即可——可以自己在终端里跑，也可以把命令贴给智能体让它执行。
Claude Code
claude plugin marketplace update chatcut-inc claude plugin update chatcut@chatcut-inc
Codex
marketplace 的名字是 Codex 在添加时分配的，所以先查当前名字，再升级那一条。
codex plugin marketplace list codex plugin marketplace upgrade <marketplace-name>
刷新后的工具和首次安装一样，只在会话启动时加载：让 ChatCut 干活之前，先开一个新的对话或任务。Claude Code 里不要执行 /reload-plugins——开新会话才是受支持的做法。
想确认连接还在，检查 ChatCut MCP server 是否仍然注册：Claude Code 用 claude mcp get plugin:chatcut:chatcut，Codex 用 codex mcp get chatcut。更新中途失败时，恢复步骤和首次安装相同，见常见安装问题。
插件可以做什么？
插件可以操作智能体应用 Browser 面板里的同一个可编辑项目，包括：
- 导入并整理项目素材；
- 剪切、裁剪、排列和检查时间线；
- 转写语音，添加或修改字幕；
- 创建并放置 MG 动画；
- 生成视频、图片、旁白、音乐和音效；
- 导出完成的视频或项目交接文件。
具体按钮和编辑方法参阅编辑器与素材；生成模型、音色和其他素材生成参阅 AI 功能；交付格式参阅导出面板。
编辑器显示在哪里？
安装完成后，智能体会在其 Browser 面板中打开 ChatCut。对话和编辑器会并排显示：智能体可以修改项目，你也可以进入编辑器手动调整时间线、字幕和 MG 动画。
Agent Plugin 使用 ChatCut 托管连接。它不等于 ChatCut Desktop 内部的 Agent 选择，也不会自动建立 Desktop 的本地 MCP 连接。需要控制当前打开的原生 Desktop 项目时，请阅读 ChatCut Desktop。
授权与安全
授权应在 ChatCut 打开的浏览器页面中完成。不要把 Cookie、访问令牌或账号密码粘贴到智能体对话中。如果授权超时，让安装智能体从失败的登录步骤继续；不要同时启动多个授权流程。
常见安装问题
智能体说无法安装
确认当前会话位于受支持的桌面应用中，而不是网页或隔离的远程会话。Claude Code 和 Codex 用户应从 头像 → Agent 插件 重新复制最新 prompt；WorkBuddy 用户应重新打开专用安装指南。
安装成功，但看不到 ChatCut 工具
新建一个全新的会话或任务。插件工具列表在会话启动时确定，无法加入已经打开的安装会话。
授权超时或中断
只保留一个授权流程，让安装智能体从登录或验证失败的步骤继续。如果仍然失败，重新复制当前安装 prompt，或重新打开 WorkBuddy 安装指南后再开始。