Claude Code 和 Codex 可以通过 Agent Plugin 剪辑 ChatCut 项目：先连接桌面智能体，再选择或创建项目、导入素材，并提出范围明确的剪辑要求。导出前，应在 ChatCut 中检查实际保存的时间线。截至 2026 年 10 月 28 日，本文介绍托管插件；Desktop 本地项目使用另一条连接路径。
已核验的连接事实
最近核验：2026-10-28。 本次核验的是文档和安装步骤，没有重新执行外部智能体从剪辑到导出的完整验收。ChatCut 内置 Agent 的演示不能证明 Claude Code 或 Codex 插件已经通过同样的测试。
| 层级 | 来源能够证明的范围 | 2026-10-28 核对来源 |
|---|---|---|
| 外部智能体 | Claude Code 与 Codex 从 ChatCut marketplace 安装、在浏览器授权，并在新会话加载工具。 | Claude Code 安装说明、Codex 安装说明 |
| ChatCut 项目 | 托管插件与 Desktop 本地项目使用不同连接；仅存于本地的项目包不会出现在托管项目列表。 | Desktop 外部智能体工作流 |
| 推理与媒体工具 | 推理由宿主智能体提供，剪辑和媒体生成由 ChatCut 工具执行；宿主用量和 ChatCut 生成积分分别计算。 | 积分政策 |
| 生成权限 | 确认生成不会跳过输入、套餐或余额检查；确认卡缺失也不能证明任务没有创建。 | 生成确认 |
上游模型原生支持什么，不能单独证明当前连接已经开放什么工具或选项。生成前请检查实际工具和模型能力矩阵；参考素材的准备方法见生成参考素材。
支持哪些桌面应用？
| 桌面应用 | 如何开始安装 |
|---|---|
| Claude Code | 在 ChatCut 头像菜单的 Agent 插件 中，点击 Claude Code 旁的 复制 |
| Codex | 在 ChatCut 头像菜单的 Agent 插件 中，点击 ChatGPT/Codex 旁的 复制 |
| WorkBuddy | 打开 WorkBuddy 安装指南；当前头像菜单没有 WorkBuddy 复制按钮 |
插件需要安装在桌面应用中。不要把安装 prompt 粘贴到 Claude 网页版、ChatGPT 网页版、远程网页工作区或 ChatCut 网页编辑器。
Claude Code 视频剪辑：先建立连接
在 Claude Code 桌面应用中新建对话，粘贴并发送：
/goal 阅读 chatcut.io/claude 帮我安装和使用 ChatCut 插件
Codex 视频剪辑：先建立连接
在 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。如果这台电脑上装了 ChatCut Desktop，这两项检查可能失败，因为 Desktop 已经用本地连接替换了插件；这时改为检查 claude mcp get chatcut_desktop 或 codex mcp get chatcut_desktop，并参阅编辑器显示在哪里？。更新中途失败时，恢复步骤和首次安装相同，见常见安装问题。
插件可以做什么？
插件可以操作智能体应用 Browser 面板里的同一个可编辑项目，包括：
- 导入并整理项目素材；
- 剪切、裁剪、排列和检查时间线；
- 转写语音，添加或修改字幕；
- 创建并放置 MG 动画；
- 生成视频、图片、旁白、音乐和音效；
- 导出完成的视频或项目交接文件。
具体按钮和编辑方法参阅编辑器与素材；生成模型、音色和其他素材生成参阅 AI 功能；交付格式参阅导出面板。
编辑器显示在哪里？
安装完成后，智能体会在其 Browser 面板中打开 ChatCut。对话和编辑器会并排显示：智能体可以修改项目，你也可以进入编辑器手动调整时间线、字幕和 MG 动画。
Agent Plugin 使用 ChatCut 托管连接。它不等于 ChatCut Desktop 内部的 Agent 选择，也不会自动建立 Desktop 的本地 MCP 连接。要选定并处理 Desktop 本地项目，参阅在自己的智能体中剪辑 Desktop 项目。
反过来则会发生：同一台电脑上安装并打开 ChatCut Desktop 后，它会把 Claude Code、Codex 和 WorkBuddy 连接到自己的本地 MCP 连接，并关闭这些应用里的本插件——在 Claude Code 和 WorkBuddy 中停用，在 Codex 中移除。之后智能体处理的是 ChatCut Desktop 项目，而不是网页端项目。
做一次可检查的初剪
- 在新会话中，让 ChatCut 只列出项目，暂不修改。选择返回的目标项目，或明确要求新建项目；让智能体说明将使用哪个项目和时间线，不要仅凭相似名称开始剪辑。
- 先检查已有素材，再导入本次需要的文件。依赖语音的剪辑应等待素材处理或转写完成。
- 要求在新的检查时间线制作初剪，说明必须保留的内容。先使用已有素材，避免让第一次剪辑依赖付费生成。
使用 ChatCut。先检查我选中的项目，确认项目名称和要编辑的时间线。用已导入的访谈录音录像新建一条检查时间线，去掉明确的说错重来和重复句，保留原意、自然呼吸、原画面和声音。只使用已有素材，等我检查后再考虑生成素材和导出。说明结果在哪条时间线，以及还有哪些步骤没有完成。
- 让智能体读回保存后的时间线，再在 Browser 面板打开同一个项目。带声音播放语音接缝，检查缺字、顺序、字幕和空帧；工具返回成功不等于已经完成视听检查。
- 在同一时间线上提出具体修改，例如恢复一处被剪掉的呼吸。确认后再导出，并打开交付文件检查。
处理本地项目包时，应按 Desktop 工作流查找、选定并读取项目。使用 ChatCut 内置 Agent 时，直接打开编辑器 AI 面板即可，无须安装外部插件。这些路径可以执行相似任务，但会话和项目访问方式不同。
授权与费用如何计算？
Claude Code 或 Codex 的推理使用宿主自己的额度或计费方式；ChatCut 媒体生成可能另外消耗 ChatCut 积分。内置 Agent 的用量也有对应的 ChatCut 费用。手动剪辑与当前费率统一见积分政策。
批准生成前，检查操作内容、输入素材和显示的预估；完成后在头像 → 积分历史 → 详情核对实际交易。确认或进度不明时，先检查原任务和“我的素材”，再决定是否重试，避免重复提交。参阅工作流故障恢复。
通过托管连接导出
视频和音频导出默认使用已登录且受支持的浏览器。智能体必须确定完整的项目与时间线 ID；目标不必是浏览器当前显示的项目。浏览器渲染与交付期间，请保持选定的浏览器打开。
也可以明确请求云端视频或音频，或在智能体说明具体的浏览器渲染阻碍后同意使用云端。对于已授权的已保存时间线，如果素材已经可从远端读取，云端渲染不需要浏览器执行器，也不需要向你的电脑发起入站回调。仅本地文件以及 Google Drive 或 Dropbox 连接素材不会自动满足这一要求；解决缺失素材仍可能需要已连接的浏览器。
云端视频最高为 1080p。保留返回的导出任务 ID，查询同一个任务，不要重复提交。素材就绪、字体选择和进度查询请按云端导出步骤操作。浏览器渲染失败不代表可以自动重试云端导出。
授权与安全
授权应在 ChatCut 打开的浏览器页面中完成。不要把 Cookie、访问令牌或账号密码粘贴到智能体对话中。如果授权超时，让安装智能体从失败的登录步骤继续；不要同时启动多个授权流程。
常见安装问题
生成在确认环节报错
如果外部智能体在生成确认环节显示 Generation confirmation failed 或 Method not found，请保留原请求。缺少确认卡片或任务 ID，不能证明任务没有开始。请按生成确认与 Auto-Allow先核对已有任务；若原请求状态不明，再通过原反馈获取帮助。
智能体说无法安装
确认当前会话位于受支持的桌面应用中，而不是网页或隔离的远程会话。Claude Code 和 Codex 用户应从 头像 → Agent 插件 重新复制最新 prompt；WorkBuddy 用户应重新打开专用安装指南。
安装成功，但看不到 ChatCut 工具
新建一个全新的会话或任务。插件工具列表在会话启动时确定，无法加入已经打开的安装会话。
工具仍缺失，或提示暂时不可用
如果已经新建会话并重新选择 ChatCut，工具仍缺失或提示 “tools temporarily unavailable”（工具暂时不可用），可以先用 ChatCut 网页端 继续剪辑。保留现有项目和原始素材；动手编辑前，先确认所需项目和素材在网页端确实可用。可以使用网页端内置 AI 或手动编辑器继续处理。平台区别见 ChatCut 产品。如需排查连接问题，可通过联系支持 提供报错和已尝试的步骤。
授权超时或中断
只保留一个授权流程，让安装智能体从登录或验证失败的步骤继续。如果仍然失败，重新复制当前安装 prompt，或重新打开 WorkBuddy 安装指南后再开始。
核验范围与来源
2026-10-28 核对了公开的 Claude Code 与 Codex 安装说明，以及本文链接的项目、确认和计费文档。本次更新没有进行新的付费生成，也没有在外部宿主重新完成剪辑与导出验收。