# 用 Claude Code 或 Codex 剪辑视频：插件安装与使用

Source: [用 Claude Code 或 Codex 剪辑视频：插件安装与使用](<https://pr-693-preview.chatcut.dev/zh/docs/agent-plugin>)

Documentation index: [llms.txt](<https://pr-693-preview.chatcut.dev/zh/docs/llms.txt>)

Last updated: 2026-10-28

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 安装说明](https://chatcut.io/claude)、[Codex 安装说明](https://chatcut.io/chatgpt) |
| ChatCut 项目 | 托管插件与 Desktop 本地项目使用不同连接；仅存于本地的项目包不会出现在托管项目列表。 | [Desktop 外部智能体工作流](https://pr-693-preview.chatcut.dev/zh/docs/desktop-agent-workflows) |
| 推理与媒体工具 | 推理由宿主智能体提供，剪辑和媒体生成由 ChatCut 工具执行；宿主用量和 ChatCut 生成积分分别计算。 | [积分政策](https://pr-693-preview.chatcut.dev/zh/docs/credits-policy) |
| 生成权限 | 确认生成不会跳过输入、套餐或余额检查；确认卡缺失也不能证明任务没有创建。 | [生成确认](https://pr-693-preview.chatcut.dev/zh/docs/generation-confirmations) |

上游模型原生支持什么，不能单独证明当前连接已经开放什么工具或选项。生成前请检查实际工具和[模型能力矩阵](https://pr-693-preview.chatcut.dev/zh/docs/model-capability-matrix)；参考素材的准备方法见[生成参考素材](https://pr-693-preview.chatcut.dev/zh/docs/generation-references)。

## 支持哪些桌面应用？

| 桌面应用 | 如何开始安装 |
| --- | --- |
| **Claude Code** | 在 ChatCut 头像菜单的 **Agent 插件** 中，点击 **Claude Code** 旁的 **复制** |
| **Codex** | 在 ChatCut 头像菜单的 **Agent 插件** 中，点击 **ChatGPT/Codex** 旁的 **复制** |
| **WorkBuddy** | 打开 [WorkBuddy 安装指南](https://chatcut.io/workbuddy)；当前头像菜单没有 WorkBuddy 复制按钮 |

插件需要安装在桌面应用中。不要把安装 prompt 粘贴到 Claude 网页版、ChatGPT 网页版、远程网页工作区或 ChatCut 网页编辑器。

### Claude Code 视频剪辑：先建立连接

在 Claude Code 桌面应用中新建对话，粘贴并发送：

命令

```sh
/goal 阅读 chatcut.io/claude 帮我安装和使用 ChatCut 插件
```

### Codex 视频剪辑：先建立连接

在 Codex 桌面应用中创建新任务，粘贴并发送：

命令

```sh
/goal 阅读 chatcut.io/chatgpt，帮我安装 ChatCut 插件并创建一个新任务。
```

WorkBuddy 的安装方式不同，当前应直接按照 [chatcut.io/workbuddy](https://chatcut.io/workbuddy) 操作，不要套用 Claude Code 或 Codex 的 prompt。

## 安装 Claude Code 或 Codex 插件

1.  打开 ChatCut 网页端并登录。
2.  点击右上角头像，将鼠标悬停在 **Agent 插件** 上。
3.  在 **Claude Code** 或 **ChatGPT/Codex** 旁点击 **复制**。
4.  打开对应的桌面应用，新建对话或任务，粘贴 prompt 并发送。
5.  等智能体打开 ChatCut 授权页；在该页面登录并允许访问。
6.  安装完成后，按照提示新建会话或任务。插件工具只在会话启动时加载，安装用的旧会话不会自动获得新工具。
7.  在新会话中明确说要使用 ChatCut，并描述想完成的剪辑。

## 更新插件

插件是从 Git marketplace 安装的，不会自己更新。在当初安装它的那个桌面应用里刷新即可——可以自己在终端里跑，也可以把命令贴给智能体让它执行。

### Claude Code

命令

```sh
claude plugin marketplace update chatcut-inc
claude plugin update chatcut@chatcut-inc
```

### Codex

marketplace 的名字是 Codex 在添加时分配的，所以先查当前名字，再升级那一条。

命令

```sh
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`，并参阅[编辑器显示在哪里？](https://pr-693-preview.chatcut.dev/zh/docs/agent-plugin#%E7%BC%96%E8%BE%91%E5%99%A8%E6%98%BE%E7%A4%BA%E5%9C%A8%E5%93%AA%E9%87%8C)。更新中途失败时，恢复步骤和首次安装相同，见[常见安装问题](https://pr-693-preview.chatcut.dev/zh/docs/agent-plugin#%E5%B8%B8%E8%A7%81%E5%AE%89%E8%A3%85%E9%97%AE%E9%A2%98)。

## 插件可以做什么？

插件可以操作智能体应用 Browser 面板里的同一个可编辑项目，包括：

-   导入并整理项目素材；
-   剪切、裁剪、排列和检查时间线；
-   转写语音，添加或修改字幕；
-   创建并放置 MG 动画；
-   生成视频、图片、旁白、音乐和音效；
-   导出完成的视频或项目交接文件。

具体按钮和编辑方法参阅[编辑器与素材](https://pr-693-preview.chatcut.dev/zh/docs/editor-overview)；生成模型、音色和其他素材生成参阅 [AI 功能](https://pr-693-preview.chatcut.dev/zh/docs/video-generation-models)；交付格式参阅[导出面板](https://pr-693-preview.chatcut.dev/zh/docs/exporting)。

## 编辑器显示在哪里？

安装完成后，智能体会在其 Browser 面板中打开 ChatCut。对话和编辑器会并排显示：智能体可以修改项目，你也可以进入编辑器手动调整时间线、字幕和 MG 动画。

Agent Plugin 使用 ChatCut 托管连接。它不等于 ChatCut Desktop 内部的 **Agent 选择**，也不会自动建立 Desktop 的本地 MCP 连接。要选定并处理 Desktop 本地项目，参阅[在自己的智能体中剪辑 Desktop 项目](https://pr-693-preview.chatcut.dev/zh/docs/desktop-agent-workflows)。

反过来则会发生：同一台电脑上安装并打开 ChatCut Desktop 后，它会把 Claude Code、Codex 和 WorkBuddy 连接到自己的本地 MCP 连接，并关闭这些应用里的本插件——在 Claude Code 和 WorkBuddy 中停用，在 Codex 中移除。之后智能体处理的是 ChatCut Desktop 项目，而不是网页端项目。

## 做一次可检查的初剪

1.  在新会话中，让 ChatCut 只列出项目，暂不修改。选择返回的目标项目，或明确要求新建项目；让智能体说明将使用哪个项目和时间线，不要仅凭相似名称开始剪辑。
2.  先检查已有素材，再导入本次需要的文件。依赖语音的剪辑应等待素材处理或转写完成。
3.  要求在新的检查时间线制作初剪，说明必须保留的内容。先使用已有素材，避免让第一次剪辑依赖付费生成。

Prompt

```text
使用 ChatCut。先检查我选中的项目，确认项目名称和要编辑的时间线。用已导入的访谈录音录像新建一条检查时间线，去掉明确的说错重来和重复句，保留原意、自然呼吸、原画面和声音。只使用已有素材，等我检查后再考虑生成素材和导出。说明结果在哪条时间线，以及还有哪些步骤没有完成。
```

4.  让智能体读回保存后的时间线，再在 Browser 面板打开同一个项目。带声音播放语音接缝，检查缺字、顺序、字幕和空帧；工具返回成功不等于已经完成视听检查。
5.  在同一时间线上提出具体修改，例如恢复一处被剪掉的呼吸。确认后再导出，并打开交付文件检查。

处理本地项目包时，应按 [Desktop 工作流](https://pr-693-preview.chatcut.dev/zh/docs/desktop-agent-workflows)查找、选定并读取项目。使用 ChatCut 内置 Agent 时，直接打开编辑器 AI 面板即可，无须安装外部插件。这些路径可以执行相似任务，但会话和项目访问方式不同。

## 授权与费用如何计算？

Claude Code 或 Codex 的推理使用宿主自己的额度或计费方式；ChatCut 媒体生成可能另外消耗 ChatCut 积分。内置 Agent 的用量也有对应的 ChatCut 费用。手动剪辑与当前费率统一见[积分政策](https://pr-693-preview.chatcut.dev/zh/docs/credits-policy)。

批准生成前，检查操作内容、输入素材和显示的预估；完成后在**头像 → 积分历史 → 详情**核对实际交易。确认或进度不明时，先检查原任务和“我的素材”，再决定是否重试，避免重复提交。参阅[工作流故障恢复](https://pr-693-preview.chatcut.dev/zh/docs/workflow-failures)。

## 通过托管连接导出

视频和音频导出默认使用已登录且受支持的浏览器。智能体必须确定完整的项目与时间线 ID；目标不必是浏览器当前显示的项目。浏览器渲染与交付期间，请保持选定的浏览器打开。

也可以明确请求云端视频或音频，或在智能体说明具体的浏览器渲染阻碍后同意使用云端。对于已授权的已保存时间线，如果素材已经可从远端读取，云端渲染不需要浏览器执行器，也不需要向你的电脑发起入站回调。仅本地文件以及 Google Drive 或 Dropbox 连接素材不会自动满足这一要求；解决缺失素材仍可能需要已连接的浏览器。

云端视频最高为 1080p。保留返回的导出任务 ID，查询同一个任务，不要重复提交。素材就绪、字体选择和进度查询请按[云端导出步骤](https://pr-693-preview.chatcut.dev/zh/docs/web-export-limits#%E6%98%8E%E7%A1%AE%E8%AF%B7%E6%B1%82%E4%BA%91%E7%AB%AF%E8%A7%86%E9%A2%91%E6%88%96%E9%9F%B3%E9%A2%91%E5%AF%BC%E5%87%BA)操作。浏览器渲染失败不代表可以自动重试云端导出。

## 授权与安全

授权应在 ChatCut 打开的浏览器页面中完成。不要把 Cookie、访问令牌或账号密码粘贴到智能体对话中。如果授权超时，让安装智能体从失败的登录步骤继续；不要同时启动多个授权流程。

## 常见安装问题

### 生成在确认环节报错

如果外部智能体在生成确认环节显示 **Generation confirmation failed** 或 **Method not found**，请保留原请求。缺少确认卡片或任务 ID，不能证明任务没有开始。请按[生成确认与 Auto-Allow](https://pr-693-preview.chatcut.dev/zh/docs/generation-confirmations)先核对已有任务；若原请求状态不明，再通过原反馈获取帮助。

### 智能体说无法安装

确认当前会话位于受支持的桌面应用中，而不是网页或隔离的远程会话。Claude Code 和 Codex 用户应从 **头像 → Agent 插件** 重新复制最新 prompt；WorkBuddy 用户应重新打开专用安装指南。

### 安装成功，但看不到 ChatCut 工具

新建一个全新的会话或任务。插件工具列表在会话启动时确定，无法加入已经打开的安装会话。

### 工具仍缺失，或提示暂时不可用

如果已经新建会话并重新选择 ChatCut，工具仍缺失或提示 “tools temporarily unavailable”（工具暂时不可用），可以先用 [ChatCut 网页端](https://app.chatcut.io/zh) 继续剪辑。保留现有项目和原始素材；动手编辑前，先确认所需项目和素材在网页端确实可用。可以使用网页端内置 AI 或手动编辑器继续处理。平台区别见 [ChatCut 产品](https://pr-693-preview.chatcut.dev/zh/docs/chatcut-products)。如需排查连接问题，可通过[联系支持](https://pr-693-preview.chatcut.dev/zh/contact) 提供报错和已尝试的步骤。

### 授权超时或中断

只保留一个授权流程，让安装智能体从登录或验证失败的步骤继续。如果仍然失败，重新复制当前安装 prompt，或重新打开 WorkBuddy 安装指南后再开始。

## 核验范围与来源

**2026-10-28** 核对了公开的 [Claude Code](https://chatcut.io/claude) 与 [Codex](https://chatcut.io/chatgpt) 安装说明，以及本文链接的项目、确认和计费文档。本次更新没有进行新的付费生成，也没有在外部宿主重新完成剪辑与导出验收。