capcut-cli

环境要求

• Node.js 18 或更高版本（仅用内置模块，无原生依赖）
• 剪映（JianYing）或 CapCut 客户端，用于打开生成的本地草稿工程
• 可选：Whisper 用于 caption 语音转字幕命令
• 可选：FFmpeg（render 命令）与 ffprobe（自动读取媒体元数据）
• 可选：ANTHROPIC_API_KEY 环境变量，用于 translate 翻译命令

安装与启动步骤

1. 1检查 Node 版本

   确认本机已装 Node 且版本不低于 18，否则后续全局安装会失败。

   node -v

   复制

2. 2全局安装 CLI

   通过 npm 全局安装 capcut-cli，安装后即可使用 capcut 命令。

   npm install -g capcut-cli@latest

   复制

3. 3运行环境自检

   执行 doctor 检查本机环境，确认命令可用及可选工具（Whisper／FFmpeg）的缺失情况。

   capcut doctor

   复制

4. 4生成首个工程

   在素材目录下执行 quickstart，用视频与 SRT 字幕生成一个可编辑的本地草稿工程。

   capcut quickstart my-first --video clip.mp4 --srt captions.srt

   复制

5. 5查看工程信息

   读取刚生成的工程，确认轨道、字幕等结构是否符合预期；-H 以可读形式输出。

   capcut info ./my-first/ -H

   复制

6. 6在剪辑软件中打开

   用剪映或 CapCut 打开生成的本地草稿，检查轨道仍可编辑，再手动调整与导出。

关键配置

如何确认成功

capcut doctor 正常输出无报错，且 capcut info ./my-first/ -H 能列出工程轨道信息，剪映打开后轨道可编辑。

常见问题

注意事项

• 本项目为独立社区项目，与 CapCut、剪映、字节跳动无隶属或背书关系。
• experimental 的 caption --cloud 会上传待转写音频到字节跳动服务器，涉及素材隐私请谨慎选用，默认走本地处理。
• 也可用 npx capcut-cli <command> 免安装临时运行，或 git clone 源码后 npm install && npm run build && npm link 从源码构建。
• Windows 与 macOS 的草稿目录路径不同，请以剪映／CapCut 客户端设置中显示的草稿位置为准。