简短结论:安装开源技能包 cinecode 后,你用 Claude Code 制作视频不需要再为工具链付费:它负责写分镜、用无头 Chrome 逐帧绘制画面、设计音效并渲染 MP4。但运行它的 Claude Code 必须已有付费订阅(Pro、Max、Ultra、Team、Enterprise 或 Console 账号),所以“免费”指的是在现有套餐之上不再额外花钱。
用 Claude Code 做视频真的能免费吗?
可以,但前提是:视频工具链免费,驱动它的编程 Agent 需要订阅。
cinecode 是一个技能,即存放在本地文件夹里的指令与脚本,Claude Code 在你要求做短片时自动加载。官方 README 说明它可在 Claude Code(桌面端、VS Code 扩展或终端)或 Cursor 中运行,“不需要任何付费服务”。项目于 2026 年 11 月 3 日创建,截至 2026 年 11 月 11 日发稿,已有 2,000 多颗 Star。
整套技术栈的费用明细如下:
| 组成部分 | 费用 | 说明 |
|---|---|---|
| cinecode 工具包 | 0 美元 | MIT 开源许可证 |
| Node.js 22+、Python 3.9+、ffmpeg、Chrome | 0 美元 | 缺失依赖由 Agent 确认后安装 |
| 旁白配音(可选) | 0 美元至付费不等 | Gemini 免费层级、ElevenLabs 或本地语音 |
| 实拍图库与视频素材(可选) | 0 美元 | Pixabay 免费密钥与公共素材 |
| Claude Code | 付费套餐 | 官方要求“具备 Pro、Max、Ultra、Team、Enterprise 或 Console 账号” |
表格数据引自 Claude Code 安装文档(2026-11-09 核对)。免费 claude.ai 不含 Claude Code 权限,网页聊天也调不动你电脑上的 ffmpeg 或 Chrome;具体套餐以官方文档为准。
已有订阅的话,每条视频只消耗套餐常规额度。团队需要向 Agent 批量提报视频需求时,可以把它们放进 HiFox 的任务看板,做法见后文。
cinecode 是如何把一句话变成 MP4 视频的
cinecode 的画面全部由代码生成,不调用文生图或文生视频模型。每个镜头都是关于时间的纯函数,用 Canvas 2D 或 three.js 绘制,在无头 Chrome 中逐帧截图,再连同音轨交给 ffmpeg 合成。
好处有二:渲染不消耗图像模型积分,因为模型只写代码、不生成像素;每帧都是确定性函数,重复渲染结果一致,局部返工可控。
官方 README 把流程分成五步:
- 一句话想法:用一句描述主题即可起步。
- 回答几个问题:Agent 询问风格、时长、画幅、音效与配乐偏好,并标出推荐项。
- 确认分镜:给出精确到秒的节拍表和可逐行编辑的导演卡,先渲染两帧静态画面确认。
- 低清初稿与质检:自动检查首帧动态、响度、文字可读性和画面重复度。
- 全尺寸成片:输出最终视频,音频母带处理至 -14 LUFS,并附可贴进简介的署名清单。

如何在 Claude Code 中安装 cinecode
安装只需一行提示词,在 Claude Code 任意入口输入:
Install the cinecode skill from https://github.com/sarpstar/cinecode
或手动克隆:
git clone https://github.com/sarpstar/cinecode.git ~/.claude/skills/cinecode
只在一个路径安装,避免 Agent 扫到两份副本。装好后在空白文件夹新建对话,输入“I want to make a short film”即可启动。Cursor 用户克隆到 ~/.cursor/skills/cinecode,但守护钩子仅在 Claude Code 生效。
建议使用 Chrome 能调用 GPU 的电脑。没有 GPU 时 Chrome 会回退到 CPU 软渲染:跑测试没问题,渲染完整短片会明显变慢。
实测渲染与两种模式
我们在 Apple M1 Pro 上克隆仓库,用 init_film.py 建了一个快速模式示例工程,未改代码直接跑初稿渲染:
python3 ~/.claude/skills/cinecode/scripts/init_film.py my-film --quick --title "Test"
cd my-film && python3 tools/make.py draft
| 实测指标 | 实测结果 |
|---|---|
| 输出规格 | 8 秒,540 × 960 竖屏,24 fps,H.264 视频编码 + AAC 音频 |
| 文件大小 | 2.2 MB |
| 渲染耗时 | 实际挂钟时间约 21 秒 |
| 音频响度 | -13.2 LUFS,峰值 -3.1 dBFS |
| 是否通过交付质检? | 否(未放行) |
最后一行最值得注意:内置质量门禁拒绝交付默认模板,因为它检测到 94% 的帧接近全黑、8 秒内只有 2 个声音事件,且声音全由代码合成。初稿被存进 renders/,要求先做一轮修复,而不是把半成品交差。

需要说明:我们是在 Claude Code 会话外直接跑底层脚本,终端打印了“GUARD OFF”,验证的是渲染流水线和质量门禁本身。用自然语言做第一部短片时,Agent 会先走完提问和分镜确认再渲染。
快速模式对比电影模式
启动时 cinecode 会询问模式并给出推荐:
| 对比维度 | 快速模式(Quick mode) | 电影模式(Film mode) |
|---|---|---|
| 适用场景 | 约 3 分钟以内的短视频切片、广告与产品演示 | 纪录片、带旁白的叙事短片、影展短片 |
| 人工确认次数 | 约 3 次 | 分阶段打磨约 6 至 8 次,连贯直出约 3 次 |
| 画面实现方式 | 单个自包含的 film.html 文件 |
基于 three.js 的 3D 场景,内置 8 套视觉预设 |
| 返工修改粒度 | 初稿阶段最多 2 轮整体修订 | 修改意见仅作用于涉及的单个镜头 |
可以先用快速模式跑通创意,再升级到电影模式,原有节拍表会转成正式分镜路线图。
“免费”制作背后的 Token 额度消耗
工具包免费,Token 不免费。README 指出,30 到 60 秒的快速模式短片通常需要 100 到 250 个执行步,每一步都会重读整段对话历史;缓存能挡住大部分,但上下文仍会随步数膨胀。
消耗直接计入套餐限额,长片有可能吃掉一整个 5 小时会话窗口的额度;不同套餐口径不同,以你所在套餐为准,见 Claude Code 成本文档。cinecode 有三项优化:
- 模型只看缩小后的多格预览拼图,而非全尺寸单帧;
- 在关键检查点开新会话,状态都在本地工程文件里;
- 自带
tools/usage.py,可随时查看 Token 总数。
README 还建议做视频时关掉暂时不用的技能与连接器,降低每步上下文开销。
把视频制作需求变成看板上的 Agent 任务
偶尔做一条视频,装好 cinecode 就够。团队每周都要出功能演示短片时,才需要一个统一的地方提报需求、跟踪审批、归档成片。
在面向人与 Agent 协作的 HiFox 里可以这样搭:
- 导入并绑定 cinecode:在技能页从 Runtime 导入,再绑定给执行任务的 Agent。导入后是 HiFox 管理的独立副本,本地目录改动不会自动同步。
- 用任务卡片写需求单:cinecode 支持一次性给出节拍、文案、时长、画幅,Agent 会跳过提问直接生成初稿,任务描述正好沉淀这些信息。
- 指派给运行 Claude Code 的 Agent:在运行设置里配置「指定已有目录」,让视频工程落在固定文件夹。接入方式见 HiFox 快速上手。
- 在任务对话里审批:cinecode 会在分镜和静态预览帧停下来等确认。按 Agent 任务执行文档,Agent 可把对话置为等待人工回复或审阅,提醒会出现在「对话」模块。
- 查收 MP4:按与 Agent 对话文档,Agent 可直接通过附件发回视频。
我们还没通过线上 Agent 跑完整部长片,可以先拿简单短片试手。HiFox 公网 SaaS 目前免费,无席位费、不限人数,Agent 和电脑不占席位(2026-11-11 核对,见 HiFox 怎么收费);模型消耗仍走电脑上原有的 Claude Code 套餐。
其他替代方案
还有几条路线适合不同场景:
- OpenMontage:多阶段 Agent 视频流水线,适合需要分阶段编排与审批的任务。
- Remotion:用 React 组件写视频,适合把模板维护在前端代码库的团队(商用前留意许可证)。
- 原生 ffmpeg 加脚本:只加字幕、做图片轮播或裁剪录屏时,让 Claude Code 直接写 ffmpeg 命令即可。
- ChatGPT Images 做循环动图:只需几秒循环动图时,可参考使用 ChatGPT Images 2.6 免费制作 GIF 动图指南。
总结与常见问题
只要已在用 Claude Code 付费套餐,借助 cinecode 做视频就不需要再掏额外费用:一行命令装好技能、输入一句话创意、确认分镜与预览帧,就能拿到做好响度母带并附署名清单的 MP4;内置质量门禁还会拦下画面过暗或音轨单薄的初稿。
如果视频制作正在变成团队的常态需求,不妨在 HiFox 创建空间,把下一条视频脚本写进任务卡片,由人工在关键节点把关。接入第一台电脑的步骤见快速上手文档。
cinecode 是免费的吗?
是。工具包采用 MIT 许可,不绑定付费第三方服务;但运行它仍需 Claude Code 订阅或 Cursor。
只用免费的 claude.ai 账号能通过 Claude Code 做视频吗?
不能。免费 claude.ai 不含 Claude Code 权限,需要 Pro、Max、Ultra、Team、Enterprise 或 Console 账号。
渲染一条视频需要多久?
M1 Pro 实测 8 秒示例初稿约 21 秒。30 秒快速模式短片通常可在一次会话内完成,但 30 到 60 秒片要 100 到 250 个执行步,时间主要花在人工确认和修改上。
底层调用了 AI 图像或视频生成大模型吗?
默认不用,画面全部由代码实时绘制;只有你主动接入外部生成器并要求使用时才会调用。
生成的视频可以商用吗?
内置字体来自开源字体库,具体以各字体附带的许可证为准;商用前请核对。外部素材需自行确认版权。
能在 Cursor 里使用吗?
可以,克隆到 ~/.cursor/skills/cinecode 即可;实时拦截错误的守护钩子仅在 Claude Code 生效。



