如何5分钟上手capcut-cli:3条命令生成第一个可编辑的剪映/CapCut草稿

原创2026-10-23 18:56:452,204 阅读

如何5分钟上手capcut-cli:3条命令生成第一个可编辑的剪映/CapCut草稿

capcut-cli 是一款独立开源的剪映 / CapCut 命令行编辑工具:无需 API、不起服务,直接读写本地的剪映草稿文件(draft_content.json / draft_info.json),3 条命令就能生成第一个可在应用里继续编辑的视频草稿。

capcut-cli 本地视频剪辑草稿命令行工具概览

一、开始之前: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 <草稿>

六、参考资料与文档路径

温馨提示:capcut-cli 是 MIT 许可的独立社区项目,与字节跳动无隶属或背书关系。

登录后查看全文
capcut-cli