Claude Code plugin for AI-powered video creation with TTS, image generation, and CapCut integration
npm install claude-video-creatorAI 驱动的视频创作插件,专为 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 插件。
``bash安装 npm 包
npm install -g claude-video-creator
安装向导将:
1. 检查系统环境(Node.js、Python)
2. 收集您的 API 密钥
3. 配置剪映/CapCut 草稿文件夹路径
4. 安装并配置 MCP 服务器
$3
在终端中运行以下命令:
`bash
添加插件市场
claude plugin marketplace add readonme/claude_video_plugin安装插件
claude plugin install video-creator
`$3
安装完成后,重启 Claude Code 使更改生效。
---
命令使用指南
安装完成后,请按顺序执行以下命令:
---
$3
生成视频脚本和 AI 图像提示词
将您的文本脚本转换为结构化的场景数据,并为每个场景生成 AI 图像提示词。
`bash
/video-creator:scene-and-prompt <文本文件路径> <项目文件夹>
`示例:
`bash
/video-creator:scene-and-prompt ~/scripts/toxic_love.txt ~/projects/toxic_love
`模式选择:
命令会询问您选择图像模式:
- 单图模式:每个句子生成一张图片(速度快,适合简单视频)
- 多图模式:根据句子长度自动生成多张图片(更动态,适合长句子)
输出文件:
-
script_output.json - 包含脚本和提示词的 JSON 文件---
$3
批量生成 TTS 语音文件
从
script_output.json 读取脚本内容,使用 MiniMax TTS API 批量生成高质量配音。`bash
/video-creator:audio <项目文件夹>
`示例:
`bash
/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 - 音频元数据(包含时长信息)---
$3
批量生成 AI 图像
从
script_output.json 读取提示词,使用 Seedream API 批量生成高质量图像。`bash
/video-creator:image <项目文件夹>
`示例:
`bash
/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---
$3
创建剪映/CapCut 草稿
将所有生成的素材(脚本、音频、图像)组装成完整的剪映草稿,自动添加转场、动画和字幕。
`bash
/video-creator:jianying_draft <项目文件夹>
`示例:
`bash
/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. 在剪映中编辑和导出
└── 打开剪映专业版,找到草稿,进行最终编辑
`项目文件夹结构
执行完所有命令后,项目文件夹结构如下:
`
/
├── 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 管理命令
`bash
交互式安装向导(设置 MCP 服务器)
claude-video-creator setup更新 API 密钥
claude-video-creator configure检查 MCP 安装状态
claude-video-creator status卸载 MCP 服务器
claude-video-creator uninstall
`插件管理命令
`bash
添加插件市场
claude plugin marketplace add readonme/claude_video_plugin安装插件
claude plugin install video-creator卸载插件
claude plugin uninstall video-creator查看已安装的插件
claude plugin marketplace list
`卸载
完整卸载需要三步:
`bash
1. 卸载 MCP 服务器
claude-video-creator uninstall2. 卸载 Claude Code 插件
claude plugin uninstall video-creator3. 卸载 npm 包
npm uninstall -g claude-video-creator
`常见问题
$3
1. 重启 Claude Code
2. 确认 Python 3.10+ 已安装
3. 验证 API 密钥设置正确
4. 运行
claude-video-creator status 检查状态$3
1. 确认剪映草稿文件夹路径正确
2. 确保运行命令前已关闭剪映
3. 在剪映中刷新项目列表
$3
1. 检查 Seedream API Token 是否有效
2. 确认网络连接正常
3. 查看
images/image_metadata.json 中的错误信息$3
1. 检查 MiniMax API Token 是否有效
2. 确认脚本文本不为空
3. 查看
audio/audio_metadata.json 中的错误信息支持的音色
$3
- English_Gentle-voiced_man - 温和男声(默认)
- English_Trustworthy_Man - 可信赖男声
- English_Graceful_Lady - 优雅女士
- Arnold - 浑厚男声
- Rudolph - 活力男声$3
- female-tianmei - 甜美女声
- male-qn-qingse` - 清晰男声MIT License - 详见 LICENSE
- CapCutAPI by sun-guannan
- MiniMax API 提供语音合成服务
- Seedream API 提供图像生成服务