Claude Video Creator

AI 驱动的视频创作插件，专为 Claude Code 设计。通过 AI 语音合成、图像生成和 CapCut/剪映自动化，轻松创建 YouTube 风格的视频。

功能特点

• AI 语音合成：使用 MiniMax TTS API 生成自然流畅的配音
• AI 图像生成：使用 Seedream API 根据提示词生成高质量图像
• 剪映集成：自动将素材组装成剪映/CapCut 草稿
• 智能字幕：自动生成带智能分词的 SRT 字幕文件

系统要求

• Claude Code CLI 已安装
• Node.js 18.0.0 或更高版本
• Python 3.10 或更高版本
• 剪映专业版 或 CapCut（用于视频组装）
• API 密钥：
  • MiniMax API Token（用于语音合成）：获取地址
  • Seedream API Token（用于图像生成）

安装

安装分为两步：设置 MCP 服务器 和 安装 Claude Code 插件。

第一步：设置 MCP 服务器

# 安装 npm 包
npm install -g claude-video-creator

# 运行交互式安装向导
claude-video-creator setup

安装向导将：

1. 检查系统环境（Node.js、Python）
2. 收集您的 API 密钥
3. 配置剪映/CapCut 草稿文件夹路径
4. 安装并配置 MCP 服务器

第二步：安装 Claude Code 插件

在终端中运行以下命令：

# 添加插件市场
claude plugin marketplace add readonme/claude_video_plugin

# 安装插件
claude plugin install video-creator

第三步：重启 Claude Code

安装完成后，重启 Claude Code 使更改生效。

命令使用指南

安装完成后，请按顺序执行以下命令：

第一步：/video-creator:scene-and-prompt

生成视频脚本和 AI 图像提示词

将您的文本脚本转换为结构化的场景数据，并为每个场景生成 AI 图像提示词。

/video-creator:scene-and-prompt <文本文件路径> <项目文件夹>

示例：

/video-creator:scene-and-prompt ~/scripts/toxic_love.txt ~/projects/toxic_love

模式选择： 命令会询问您选择图像模式：

• 单图模式：每个句子生成一张图片（速度快，适合简单视频）
• 多图模式：根据句子长度自动生成多张图片（更动态，适合长句子）

输出文件：

• script_output.json - 包含脚本和提示词的 JSON 文件

第二步：/video-creator:audio

批量生成 TTS 语音文件

从 script_output.json 读取脚本内容，使用 MiniMax TTS API 批量生成高质量配音。

/video-creator:audio <项目文件夹>

示例：

/video-creator:audio ~/projects/toxic_love

可选参数：

• --voice / -v：音色 ID（默认：English_Gentle-voiced_man）
• --speed / -s：语速 [0.5-2.0]（默认：1.2）

输出文件：

• audio/audio_001.mp3, audio_002.mp3, ... - 音频文件
• audio/audio_metadata.json - 音频元数据（包含时长信息）

第三步：/video-creator:image

批量生成 AI 图像

从 script_output.json 读取提示词，使用 Seedream API 批量生成高质量图像。

/video-creator:image <项目文件夹>

示例：

/video-creator:image ~/projects/toxic_love

输出文件：

• images/image_001.png, image_002.png, ... - 图像文件
• images/image_metadata.json - 图像元数据

多图命名规则：

• 单图场景：image_001.png
• 多图场景：image_001_01.png, image_001_02.png, image_001_03.png

第四步：/video-creator:jianying_draft

创建剪映/CapCut 草稿

将所有生成的素材（脚本、音频、图像）组装成完整的剪映草稿，自动添加转场、动画和字幕。

/video-creator:jianying_draft <项目文件夹>

示例：

/video-creator:jianying_draft ~/projects/toxic_love

可选参数：

• --test / -t：测试模式，仅创建前 3 个场景
• --name / -n：草稿名称前缀

分辨率选择： 命令会询问您选择视频分辨率：

• YouTube 横屏：1920x1080（16:9）
• TikTok/抖音 竖屏：1080x1920（9:16）

输出：

• 剪映草稿文件（自动保存到剪映草稿文件夹）
• subtitles.srt - 字幕文件

完整工作流程

1. 准备文本脚本
   └── 创建 .txt 文件，每行一个句子

2. 生成场景和提示词
   └── /video-creator:scene-and-prompt script.txt ./my_project

3. 生成配音（可与步骤4并行）
   └── /video-creator:audio ./my_project

4. 生成图像（可与步骤3并行）
   └── /video-creator:image ./my_project

5. 创建视频草稿
   └── /video-creator:jianying_draft ./my_project

6. 在剪映中编辑和导出
   └── 打开剪映专业版，找到草稿，进行最终编辑

项目文件夹结构

执行完所有命令后，项目文件夹结构如下：

<project_folder>/
├── script_output.json          # 脚本和提示词
├── audio/                      # 音频文件
│   ├── audio_001.mp3
│   ├── audio_002.mp3
│   ├── ...
│   └── audio_metadata.json
├── images/                     # 图像文件
│   ├── image_001.png
│   ├── image_002.png
│   ├── ...
│   └── image_metadata.json
└── subtitles.srt               # 字幕文件

CLI 管理命令

# 交互式安装向导（设置 MCP 服务器）
claude-video-creator setup

# 更新 API 密钥
claude-video-creator configure

# 检查 MCP 安装状态
claude-video-creator status

# 卸载 MCP 服务器
claude-video-creator uninstall

插件管理命令

# 添加插件市场
claude plugin marketplace add readonme/claude_video_plugin

# 安装插件
claude plugin install video-creator

# 卸载插件
claude plugin uninstall video-creator

# 查看已安装的插件
claude plugin marketplace list

卸载

完整卸载需要三步：

# 1. 卸载 MCP 服务器
claude-video-creator uninstall

# 2. 卸载 Claude Code 插件
claude plugin uninstall video-creator

# 3. 卸载 npm 包
npm uninstall -g claude-video-creator

常见问题

MCP 服务器无响应

1. 重启 Claude Code
2. 确认 Python 3.10+ 已安装
3. 验证 API 密钥设置正确
4. 运行 claude-video-creator status 检查状态

剪映草稿未显示

1. 确认剪映草稿文件夹路径正确
2. 确保运行命令前已关闭剪映
3. 在剪映中刷新项目列表

图像生成失败

1. 检查 Seedream API Token 是否有效
2. 确认网络连接正常
3. 查看 images/image_metadata.json 中的错误信息

音频生成失败

1. 检查 MiniMax API Token 是否有效
2. 确认脚本文本不为空
3. 查看 audio/audio_metadata.json 中的错误信息

支持的音色

英文音色（推荐）

• English_Gentle-voiced_man - 温和男声（默认）
• English_Trustworthy_Man - 可信赖男声
• English_Graceful_Lady - 优雅女士
• Arnold - 浑厚男声
• Rudolph - 活力男声

中文音色

• female-tianmei - 甜美女声
• male-qn-qingse - 清晰男声

许可证

MIT License - 详见 LICENSE

致谢

• CapCutAPI by sun-guannan
• MiniMax API 提供语音合成服务
• Seedream API 提供图像生成服务