# ChatCut Desktop

Source: [ChatCut Desktop](<https://pr-444-preview.chatcut.dev/zh/docs/desktop-app>)

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

Last updated: 2026-10-09

ChatCut 桌面端是 ChatCut 编辑器的原生应用版本，适合直接处理电脑里的本地素材、在本机渲染，以及让智能体协助剪辑。

它支持两种不同的智能体工作方式：

-   在 ChatCut 桌面端的 AI 输入框里，直接运行 **ChatCut**、**Claude Code**、**Codex CLI** 或 **Hermes Agent**。
-   在 Claude Code 桌面应用或 Codex 桌面应用里对话，让外部应用通过 ChatCut 的本地 MCP 连接控制当前打开的 ChatCut 桌面端项目。

这两种方式彼此相关，但都不等同于安装 [ChatCut 智能体插件](https://pr-444-preview.chatcut.dev/zh/docs/agent-plugin)。

## 先选对产品形态

| 产品 | 在哪里操作 | 更适合什么情况 |
| --- | --- | --- |
| ChatCut 网页端 | 电脑浏览器 | 快速开始、云端项目、协作和浏览器或云端导出 |
| ChatCut 桌面端 | macOS 或 Windows 原生编辑器 | 本地素材、更大的素材库、本地智能体和本地 4K/HDR 导出 |
| ChatCut 智能体插件 | Claude Code、Codex 或 WorkBuddy 桌面应用 | 让外部桌面智能体创建或修改 ChatCut 项目 |

智能体插件不会安装到 ChatCut 网页编辑器、Claude 网页版或 ChatGPT 网页版里。

## 下载并安装 ChatCut 桌面端

1.  打开 ChatCut 网页端并登录。
2.  点击右上角头像。
3.  将鼠标悬停在 **桌面应用** 上。
4.  在对应平台旁点击 **下载**：**macOS — Apple silicon**、**macOS — Intel** 或 **Windows**。
5.  打开下载的安装程序，按系统提示完成安装。
6.  启动 ChatCut 桌面端，并登录同一个 ChatCut 账号。

目前下载菜单里没有 Linux 版本。

## 更新 ChatCut 桌面端

ChatCut 桌面端会检查更新，并在后台下载可用版本。下载完成后，应用会提示立即重启更新或稍后处理；推迟一次重启不会隐藏后续新版本。

如果后台更新失败，或需要手动重装，可以重新下载安装包并覆盖现有版本：

1.  退出 ChatCut 桌面端。
2.  打开 ChatCut 网页端，点击右上角头像，把鼠标移到 **Desktop App**。
3.  点击对应平台旁边的 **下载**。
4.  macOS 上打开下载的磁盘映像，把 **ChatCut** 拖到 **应用程序**，确认替换；Windows 上直接运行下载的安装程序。
5.  启动 ChatCut 桌面端，按提示登录。

在现有应用上覆盖安装新版 Desktop，会保留项目包和设置。本地素材仍在原来的磁盘位置。如果更新后项目里的素材显示缺失，用 **重新关联文件** 修复，不要重新导入一遍——见[我的素材](https://pr-444-preview.chatcut.dev/zh/docs/my-assets#%E4%BF%AE%E5%A4%8D%E7%BC%BA%E5%A4%B1%E6%88%96%E4%B8%AD%E6%96%AD%E7%9A%84%E7%B4%A0%E6%9D%90)。

Desktop 0.5.5 及以上版本会优先把新项目创建为本地项目包。即使没有云端项目记录，它们也会保留在 Desktop 项目库中。Desktop 还会自动保留近期项目数据备份；媒体文件仍位于原来的磁盘位置，不会被复制进这些备份。

## 导入本地或在线素材

在 ChatCut 桌面端打开项目，进入 **我的素材**，点击工具栏里的 **上传** 按钮，然后选择 **文件…** 或 **文件夹…**。也可以从 Finder 或文件资源管理器把文件拖进“我的素材”。

桌面端会记住原始文件在电脑上的位置，并可直接读取支持的媒体，用于剪辑和本地导出。长录音、多机位拍摄和大型素材文件夹因此不需要先完成漫长上传才能开始工作。

部分云端功能仍然需要网络。例如，使用 AI 生成服务时，ChatCut 可能需要上传本次生成所需的参考素材。“本地素材”并不代表 ChatCut 的所有功能都能离线运行。

要从视频或音频 URL 导入素材，选择 **我的素材 → 上传 → 从 URL 导入…**。桌面端会先检查来源，再显示兼容的分辨率、帧率、音频语言和音频质量选项。下载任务会出现在共用任务队列中，处理成功后才会进入当前项目。

仅云端项目也可以从桌面端项目库的卡片或列表行直接导入。卡片会显示下载进度和可重试错误；如果你是点击该项目开始导入，准备完成后桌面端会自动打开它。

## 在 ChatCut 桌面端内使用本地 Agent

这种方式是在 ChatCut 桌面端内部运行你已经安装的本地智能体。

1.  在 ChatCut 桌面端打开一个项目。
2.  如果 AI 面板处于折叠状态，先将它打开。
3.  在 AI 输入框底部，点击消息框旁当前显示的智能体按钮。
4.  在 **Agent 选择** 中选择 **ChatCut**、**Claude Code**、**Codex CLI** 或 **Hermes Agent**。
5.  如果界面显示 **登录**，完成对应智能体的登录流程。
6.  输入剪辑要求并发送。选中的智能体可以通过 ChatCut 工具读取和修改当前项目的时间线。

ChatCut 检测到兼容的本地安装后，才会提供 Claude Code、Codex CLI 和 Hermes Agent。如果某个 Agent 未安装、未登录或无法启动，对应选项会显示需要完成的安装或登录步骤。选择本地 Agent 会使用该服务商自己的账号和额度，不会消耗 ChatCut 内置 Agent 的额度。

### 给本地智能体更多项目背景

Claude Code 和 Codex 在本机运行，因此你可以让它们把项目之外的资料作为剪辑背景，例如脚本、brief、PDF、表格、网站或代码仓库；能否访问这些内容取决于对应智能体的文件与网络权限。这些资料只为智能体提供上下文，不会自动变成时间线素材。真正要使用的视频、图片和音频仍需通过 **我的素材** 导入。

智能体工作时，你仍然保留普通编辑器的完整控制权。可以在预览器和时间线里检查改动，再手动修剪、排序或调整样式。尝试另一个方向前，点击顶部的 **版本**，再选择 **保存当前版本**，保存一个可以随时返回的命名时间线快照。

## 让外部桌面智能体通过 MCP 控制 ChatCut 桌面端

这是相反的使用方向：对话留在 Claude Code 桌面应用或 Codex 桌面应用里，智能体操作的是 ChatCut 桌面端当前打开的项目。

1.  安装并至少启动一次 ChatCut 桌面端。
2.  确认同一台电脑上已经安装 Claude Code 桌面应用或 Codex 桌面应用。
3.  在 ChatCut 桌面端打开你希望智能体处理的项目。
4.  打开外部桌面智能体应用，让它使用 ChatCut 剪辑该项目。
5.  连接成功后，ChatCut 桌面端顶部会显示智能体图标。点击它可以看到 **ChatGPT** 或 **Claude Code** 及其连接状态。
6.  点击智能体名称可以回到对应对话；如果界面显示 **Reconnect**，点击它修复本地 MCP 连接。

ChatCut 桌面端启动后，会尝试向检测到的受支持智能体注册本地 MCP 服务。两个应用必须在同一台电脑上运行；外部智能体要控制当前原生项目时，ChatCut 桌面端也必须保持打开。

Desktop 0.5.16 及以上版本还会把本地创建的项目提供给这些项目工具。Agent 可以列出并指定本地项目，再对它执行重命名、复制、备份、恢复或删除，无需额外创建云端副本。

这个本地 MCP 通道和智能体插件使用的 ChatCut 托管连接不是一回事。另一种流程参见[智能体插件：支持的桌面应用与安装方法](https://pr-444-preview.chatcut.dev/zh/docs/agent-plugin)。

## 在本地导出 4K 或 HDR 视频

1.  确保时间线上至少有一个内容项。
2.  点击顶部的 **导出**。
3.  打开 **视频** 标签页。
4.  在 **动态范围** 中选择 **SDR** 或 **HDR**。
5.  在 **分辨率** 中选择 **480p**、**720p**、**1080p** 或 **4K**。
6.  选择帧率、导出范围和保存位置，然后开始导出。

ChatCut 桌面端的视频导出会在本机渲染，并保存到你选择的文件夹。HDR 只会在当前电脑支持时启用；不支持时，HDR 选项会被禁用，面板会显示 **HDR export is not available on this computer**。

其他导出标签页、格式和网页端限制参见[导出](https://pr-444-preview.chatcut.dev/zh/docs/exporting)。

## 哪些部分仍然使用云端？

ChatCut 桌面端不是完全离线应用。账号登录、项目同步、ChatCut 内置智能体、在线生成模型以及其他服务端能力都需要网络。本地 Claude Code 或 Codex 在执行任务时，也可能连接各自服务商的在线服务。

桌面端真正的区别是：它可以从本地素材开始工作，并在本机完成受支持的视频渲染；这不代表每个工具都不会联网。