如何5分钟上手capcut-cli:3条命令生成第一个可编辑的剪映/CapCut草稿
如何5分钟上手capcut-cli:3条命令生成第一个可编辑的剪映/CapCut草稿
capcut-cli 是一款独立开源的剪映 / CapCut 命令行编辑工具:无需 API、不起服务,直接读写本地的剪映草稿文件(draft_content.json / draft_info.json),3 条命令就能生成第一个可在应用里继续编辑的视频草稿。
一、开始之前:3 件必须知道的事
- 直接读写本地草稿:剪映/CapCut 的每个项目都以 JSON 文件形式保存在你的电脑上,capcut-cli 直接读取并修改它——不上传、不联网,数据始终留在本地
- 产物是可编辑的真实工程:视频、字幕、音频各自保留在独立轨道上,而不是压扁的导出文件,之后随时在应用里微调
- 一个二进制兼容两端:剪映(国内版)与 CapCut(国际版)共用同一套命令,加
--jianying参数即可切换到剪映的资源命名空间
⚠️ 版本提醒:剪映 5.9.x 是最后一个广泛使用的明文草稿版本,也是配合本 CLI 的推荐版本;剪映 6.0 起草稿加密,写入护栏会拒绝修改。详见 version-support.md。
二、一分钟安装与环境预检
前置要求只有 Node ≥ 18(纯内置模块,无原生依赖):
npm install -g capcut-cli
安装完成后,运行第一条命令做预检:
capcut doctor
doctor 会自动检测 Node 版本、FFmpeg / Whisper 等可选环境,并探测本地草稿存储目录(Windows 与 macOS 的候选路径自动识别,也可用 --drafts 显式指定)。输出没有错误提示,就可以进入下一步。
三、核心 3 条命令:生成第一个可编辑草稿
命令 1:capcut doctor 环境预检 ✅
上面已介绍。它确保 Node 版本、草稿目录探测正常,是整个流程的"体检"环节。
命令 2:capcut quickstart 一步生成草稿 🚀
capcut quickstart 我的第一个草稿 --video 素材.mp4
这一条命令连续完成 4 件事:创建草稿 → 添加素材 → lint 检查 → 打印"在应用里打开"的收尾步骤。如果手里已有字幕文件,再加一个 --srt captions.srt 参数,就能直接生成带字幕的草稿。
命令 3:capcut info 查看草稿详情 🔍
capcut info ./我的第一个草稿/ -H
info 输出草稿概览:版本、时长、轨道与片段清单。所有命令默认输出 JSON(方便管道给脚本或 AI Agent),加 -H 即可切换为人类可读的表格视图。
四、在剪映 / CapCut 中打开,继续编辑
草稿生成后,用剪映或 CapCut 打开它:审阅、微调时间轴、加转场,最后导出渲染。自动化工具只负责做到"草稿"这一步,最后的发布按钮永远由人来点。
安全机制同样省心:
- 每次写入都是原子操作,先留
.bak备份再落盘,出错可用capcut restore按步撤销 - 检测到桌面端应用正在运行时,会拒绝写入,避免文件损坏
- 超出已验证版本范围的草稿(如剪映 6.0+ 加密时代)会被写入护栏拒绝
五、草稿生成后,常用的下一步命令
| 你想做的事 | 命令 |
|---|---|
| 导入 SRT 字幕 | capcut import-srt <草稿> 字幕.srt |
| 语音识别字幕(需本机 Whisper) | capcut caption <草稿> --audio 音频.wav |
| 检查草稿问题(退出码可进 CI) | capcut lint <草稿> |
| 撤销上一次写入 | capcut restore <草稿> |
六、参考资料与文档路径
- 剪映快速上手指南(中文):docs/quickstart.zh-CN.md
- 命令参考(简体中文):docs/command-reference.zh-CN.md
- 端到端示例(旁白、长视频切短视频、自动化):examples/
- 草稿文件格式注解(轨道、关键帧、特效):docs/draft-schema/
- Python 封装(
pip install capcut后以库形式调用):python/README.md
温馨提示:capcut-cli 是 MIT 许可的独立社区项目,与字节跳动无隶属或背书关系。
登录后查看全文
