一句话让 Claude Code 帮你剪口播视频

你会得到什么

剪口播最费时间的，往往不是创意，而是掐停顿、删口误、加字幕这些体力活。editonny 是一个免费开源、给 Claude Code 和 Codex 用的视频剪辑技能：你用大白话说要什么，它在你自己的电脑上转写、剪辑、渲染，视频不用上传到任何地方。这篇带你装好它，并剪出第一条片子。

它能帮你做这些事：

• 去掉停顿、气口、口误、说错重来和重复的话，保留完整的词和你有意留的停顿。
• 加字幕，有几种字体风格，还能逐词高亮。
• 修音频：把人声音量拉平。
• 改画幅：竖屏 9:16、横屏 16:9、方形 1:1、4:5，主体保持居中。
• 把你说的一部分话做成动画画面，比如三步骤、前后对比、突出一个数字。

图片来自项目仓库 README，是项目自己做的示意动画。

第 1 步：先看你需要什么

你要先有 Claude Code 或 Codex，并且已经能正常用。另外需要这几样，缺什么 Agent 会帮你补，补之前会告诉你：

需要	说明
Python	启动器要 3.9 以上；引擎要 3.10 到 3.13，通过 uv 管理
FFmpeg 和 ffprobe	要能在命令行里找到
Node.js	22.13 以上或 24 以上
本地文字识别	macOS 用系统自带的 Apple Vision，其他系统用 Tesseract，用来检查字幕有没有错

不需要任何大模型的 API 密钥：转写和渲染都在本机跑。你的 Claude Code 或 Codex 订阅是另外的。

第 2 步：一句话安装

打开 Claude Code 或 Codex，在任意文件夹里粘贴下面这句：

Install the editonny skill from https://github.com/soumatheusgomes/editonny. Read skills/editonny/SKILL.md and follow its setup.

Agent 会自己把技能下载下来，按里面的安装步骤检查系统、准备好渲染器、浏览器、转写模型和文字识别，最后用一段合成的测试素材验证。第一次要下载软件和模型文件，需要一点时间和硬盘空间；你的视频不参与这一步。

装完后重启 Agent。以后想更新，再粘贴同一句就行，它会比对版本、告诉你改了什么，再问你要不要更新。

第 3 步：把素材交给它

在 Claude Code 里输入 /editonny，在 Codex 里输入 $editonny，然后说清楚素材在哪、要什么结果。比如：

你说中文，它就用中文跟你沟通；视频里说的是什么语言，字幕默认就是什么语言，除非你要求翻译。

第 4 步：看"设置卡"，说一句同意

这是它最特别的地方：每次新剪辑，它都会先看素材，然后列出一张设置卡，等你回复确认才动手，就算你的要求写得很详细也一样。卡片会分十项写清楚：

项目	它会告诉你
目标	剪多长、节奏怎样
视频	用哪些素材、什么顺序
画面	默认保持原样，不自动加滤镜、调色或"增强"
格式	尺寸、画幅、帧率、编码
语言	对话语言、识别到的口语语言、字幕语言
字幕	风格、一次几个词、位置
剪辑	哪些停顿要保留
声音	人声音量、降噪、是否加音乐
画面特效	动画场景、转场、运镜
审核和交付	谁来检查样片、文件放哪

每一项都会标明来源：你说的、从视频里读到的、还是它的建议。有拿不准的（比如某个素材缺颜色信息），会放在最上面让你选 A 或 B。

默认设置是这样的：保持原画面和帧率，标准清理（去停顿、气口、口误、重复），字幕开启、一次最多三个词，人声音量拉平到社交平台常用的标准，降噪、音乐、音效、动画场景和运镜全部关闭。它不会因为你说"做得有节奏一点"就偷偷加背景音乐，加音频必须你明确要求。

看完回复 ok，或者直接改，比如"加背景音乐""不要字幕""保留 0:42 那处停顿"。改完它会把整张卡再给你看一遍。

图片来自项目仓库 README，是项目自己做的示意动画，不是客户素材的渲染。

第 5 步：看样片，再导出

确认后，它才建立工作文件夹，开始转写和剪辑。成片和工程文件都放在 ~/Downloads/editonny/日期-标题/ 里：成品视频在 exports/，剪辑工程在 project/。

它会先出一段 8 到 15 秒的样片检查，通过后再导出完整的 MP4（需要字幕文件的话也一起出）。想自己把关，可以在设置卡里选"由我审核样片"，这样它会停下来等你看。

想改画幅，直接说"再导一个横屏版本"。

图片来自项目仓库 README，是项目自己做的示意动画。

想要动画画面

它自带 145 个动画场景和 79 段原创素材，加上 54 个示例请求。你可以直接说"把这三个步骤做成动画"。注意两点：

• 场景里的示例数字、优惠、评价和品牌都只是示意，要换成你自己提供的真实内容。
• 生成的画面不能当作证据。

项目还有一个官网指南，能帮你拼出剪辑请求、浏览场景。它不会接收或上传你的素材。想在本机运行，要克隆仓库后执行 python3 editonny.py guide（需要 Node.js 22.13 以上）。

注意

• 系统： 作者验证过的环境是 macOS Apple Silicon。Windows 和 Linux 需要各自验证，可能会遇到问题，Agent 应该把失败如实告诉你。
• 隐私： 转写和渲染在本机。安装时会下载软件和模型文件。可选的外部生成服务要先经过你同意才会用，涉及费用或上传素材的都会先问你。
• 更新： 每次使用它都会检查本地环境和 GitHub 上有没有新版本，但不会自动更新。
• 许可： 作者自己的代码和文档是 MIT 许可证；第三方库、模型、字体、音频和素材各有各的许可，使用和分发前看清楚。
• 别拿别人的视频当素材。 用你自己拍的或有权使用的素材。

参考

• editonny 项目主页，MIT 许可证（第三方资源另有许可）
• 安装和故障恢复说明