# Agent Plugin

Source: [Agent Plugin](<https://pr-444-preview.chatcut.dev/zh/docs/agent-plugin>)

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

Last updated: 2026-08-26

ChatCut Agent Plugin 让外部桌面智能体创建和编辑 ChatCut 项目。你在智能体应用中描述想要的结果；ChatCut 编辑器会显示实际时间线，仍然可以随时手动调整。

## 支持哪些桌面应用？

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

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

### Claude Code 安装 prompt

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

命令

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

### Codex 安装 prompt

在 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`。更新中途失败时，恢复步骤和首次安装相同，见[常见安装问题](https://pr-444-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-444-preview.chatcut.dev/zh/docs/editor-overview)；生成模型、音色和其他素材生成参阅 [AI 功能](https://pr-444-preview.chatcut.dev/zh/docs/video-generation-models)；交付格式参阅[导出面板](https://pr-444-preview.chatcut.dev/zh/docs/exporting)。

## 编辑器显示在哪里？

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

Agent Plugin 使用 ChatCut 托管连接。它不等于 ChatCut Desktop 内部的 **Agent 选择**，也不会自动建立 Desktop 的本地 MCP 连接。需要控制当前打开的原生 Desktop 项目时，请阅读 [ChatCut Desktop](https://pr-444-preview.chatcut.dev/zh/docs/desktop-app)。

## 授权与安全

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

## 常见安装问题

### 智能体说无法安装

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

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

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

### 授权超时或中断

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