claude-code-video-toolkit

用大白话描述视频创意，自动生成带配音和画面的成片

claude-code-video-toolkit 是一个面向 Claude Code 的 AI 原生视频制作工具包，旨在通过自然语言指令自动化完成视频生产流程。它解决了传统视频制作中工具链割裂、操作繁琐的问题，将脚本生成、语音合成、画面渲染和最终剪辑整合为一条流水线。核心能力包括：基于 Qwen-TTS 和 ElevenLabs 的多音色语音合成，支持程序化视频渲染（通过 Playwright 捕获网页动画），以及可扩展的插件架构，允许用户自定义视频风格和内容模板。项目使用 Python 编写，深度集成 Claude Code 的 Agent 能力，让用户只需描述创意，即可自动生成带配音和视觉元素的完整视频。目前处于成长阶段，社区活跃，适合开发者快速上手定制自己的 AI 视频工作流。

开源 free 音频音乐

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2112

维护状态活跃

是否开源是

定价模式 free

项目数据

分类音频音乐

开发团队digitalsamba

所属国家

官网地址

GitHubhttps://github.com/digitalsamba/claude-code-video-toolkit

定价模式free

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai-video-generator,claude-code,developer-tools,elevenlabs,open-source,openclaw,playwright,programmatic-video,qwen-tts,remotion,text-to-speech,video-editing,video-production

GitHub 星标★ 2112

30天Star增速

HF 下载量

上线时间2025-12-09 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：进阶约 15 分钟部署方式：命令行工具 7 步

环境要求

Node.js 18 及以上
已安装 Claude Code（claude 命令可用）
推荐安装 uv（会自动装好 Python 3.10+）
FFmpeg 可选
云端 GPU 账号（Modal 或 RunPod，用于运行 AI 工具）

安装与启动步骤

1克隆项目仓库

把工具包仓库下载到本地，任选一个存放目录执行。
```
git clone https://github.com/digitalsamba/claude-code-video-toolkit.git
```
2进入项目目录

后续所有命令都在仓库根目录下执行。
```
cd claude-code-video-toolkit
```
3安装 uv（可选）

用于管理 Python 依赖并自动安装 Python 3.10+；已有 uv 可跳过。Windows 用 powershell -c "irm https://astral.sh/uv/install.ps1 | iex"。
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
4同步 Python 依赖

可选项，仅在使用 AI 配音、图像生成、音乐、moviepy 示例时需要，会创建 .venv/ 并从锁文件安装。
```
uv sync
```
5启动 Claude Code

在工具包目录里打开 Claude Code，后续通过斜杠命令操作。
```
claude
```
6运行 /setup 配置

在 Claude Code 中交互式配置云端 GPU、文件传输、语音，约 5 分钟，大部分免费。
```
/setup
```
7生成第一个视频

用 /video 从模板创建项目，并按引导走完整个制作流程。
```
/video
```

关键配置

配置项	必填	说明	示例
`--cloud`	否	指定运行 AI 工具的云 GPU 提供商，8 个 AI 工具均可使用	`modal`

如何确认成功

/setup 交互流程走完后执行 /video 能生成带配音的 MP4；或跑 examples/hello-world 直接渲染出 MP4。

常见问题

Q：不想做云配置，能直接渲染吗？

A：可以。执行 cd examples/hello-world && npm install && npm run render，无需任何 API Key，会立刻输出一个 MP4 文件。

Q：Modal 和 RunPod 怎么选？

A：Modal 是推荐方案，每个工具从 docker/modal-*/app.py 部署，Starter 计划每月 30 美元免费算力，典型用量约 1~2 美元/月；RunPod 使用 ghcr.io/conalmullan/video-toolkit-* 预构建镜像，按秒计费、无最低消费。

Q：哪些环节是免费的？

A：配音 Qwen3-TTS、图像 FLUX.2、音乐 ACE-Step 等开源模型部署到你自己的云 GPU 上按成本运行；Cloudflare R2 免费额度 10GB 且零出口流量。

Q：RunPod 怎么创建端点？

A：对任意工具执行 uv run tools/.py --setup 即可创建端点，具体见 docs/runpod-setup.md。

Q：没有 uv 能用吗？

A：可以先安装：macOS/Linux 执行 curl -LsSf https://astral.sh/uv/install.sh | sh，Windows 执行 powershell -c "irm https://astral.sh/uv/install.ps1 | iex"。

注意事项

uv sync 是可选的，只影响 AI 配音、图像生成、音乐和 moviepy 示例。
AI 工具按量计费：配音约 $0.01、图像约 $0.02、音乐约 $0.05、LTX-2 视频约 $0.23、SoulX 约 $0.0024/秒。
Cloud GPU 使用 modal 或 runpod 两种方式，可在任意工具上加 --cloud modal 或 --cloud runpod。
FFmpeg 为可选依赖，不装也能完成基础渲染示例。

核心亮点

深度集成 Claude Code，自然语言驱动全流程，降低视频制作门槛
内置多种 TTS 引擎（Qwen-TTS、ElevenLabs），支持多音色和情感表达
基于 Playwright 的程序化渲染，可精准控制画面元素，适合生成教程和演示视频

不足之处

依赖外部 API（如 ElevenLabs），可能产生额外费用且受网络影响
文档/社区待观察

适用场景

快速生成产品功能演示视频，用于营销或内部培训
自动化制作数据报告解说视频，定期更新内容
为教育内容创建多语言配音的教学视频

替代项目

Remotion、Motion Canvas、FFmpeg 结合 AI 脚本

项目介绍

claude-code-video-toolkit 是视频领域的开源项目，由 digitalsamba 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（2,112）位列前 30%，在视频分类的 472 个项目里位列前 12%。

近 45 天，它的 GitHub 星标从 1,914 增加到 2,112，净增 198。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：快速生成产品功能演示视频，用于营销或内部培训。同类可对比的替代方案包括 Remotion、Motion Canvas、FFmpeg 结合 AI 脚本。

上一篇：UniVidX_ComfyUI

下一篇：podcast-maker