cinecode 是什么:Claude Code 用代码拍片的 Skill

一句话说想拍什么,Claude Code 写剧本、用代码画出每一帧、配好声音,最后交给你一个 MP4,全程不调用任何视频生成模型。土耳其开发者 Sarp Yıldız 11 月 3 日开源的 cinecode 就是这样一个 Skill:短片、广告、音乐视频、竖屏科普,到十分钟以上的纪录片都覆盖。它和站内写过的 lemo-opuscar 同属「代码拍片」路线,风格库就直接用了后者的 51 套配方,多出来的是一整套导演流程和关卡。本文按 英文 README 和 SKILL.md 整理它能做什么、怎么装、两种模式怎么选。
它是什么
| 项目 | 信息 |
|---|---|
| 仓库 | github.com/sarpstar/cinecode |
| 作者 | Sarp Yıldız(与 Claude 在 Claude Code 和 Cursor 里合作完成) |
| 许可证 | MIT;风格库 styles/ 中 51 套来自 lemo-opuscar(MIT),另有 7 套自带,共 58 套 |
| 热度 | GitHub 约 1,200 星、222 fork(2026-11-08 查询);2026-11-03 建库 |
| 运行环境 | Claude Code(桌面端 Code 标签、VS Code 扩展、终端)或 Cursor;Node.js 22+、Python 3.9+、ffmpeg、Chrome / Chromium / Edge |
| 最近提交 | 67f9807,2026-11-03 23:21(北京时间) |
| 文档语言 | 土耳其语、英语、简体中文、日语 |
不调视频模型,靠代码出画面
cinecode 让 Agent 写一个程序把视频画出来,模型本身不生成任何画面。快速模式里整支片子就是一个自包含的 film.html:每个场景是时间的函数,画面用 Canvas 2D 或 three.js / WebGL,声音用 Web Audio 离线渲染,场景氛围底、音效、混响、编曲表都写在同一个文件里。capture.mjs 在无头 Chrome 里逐帧截图,mix.py 混音,master_audio.py 把响度压到 −14 LUFS。
代码画不出来的真实事物,长片会去开放档案里找:维基共享资源、互联网档案馆、NASA、博物馆,再加上 Pixabay 的图库(需要你自己的免费 key)。每一份素材的许可都记进 LICENSES.csv,成片旁边留一个 -credits.txt,贴到视频简介里就行。你自己给的参考片只用来定基调,README 写明不会进画面。
画面的成本在代码里,几乎不花模型钱;真正的开销是 Agent 一步步写、渲染、检查时消耗的对话轮数。
快速模式和电影模式怎么选
| 快速模式 | 电影模式 | |
|---|---|---|
| 适合 | 1 分钟以内的品牌片、社交短视频、科普、3 分钟以内的作品;短片初稿 | 多场景长片、带研究或档案素材的纪录片、旁白作品、参赛短片 |
| 确认次数 | 约 3 次 | 逐阶段约 6–8 次,一路直通约 3 次 |
| 画面 | 一个 film.html,Canvas 2D 或 three.js | three.js 场景,8 种观感预设,逐镜头渲染 |
| 声音 | 同一文件里的 Web Audio 设计 | 分层声音:环境底、拟音、重点时刻、旁白、配乐 |
| Agent 分工 | 主会话包办,后台做研究,另有独立观看者审每一版草稿 | 声音、旁白、研究、审片、长片各章节交给并行的帮手 |
快速模式的流程大致是:问几个问题(媒介、时长和画幅、风格、声音、参考),给出文字计划(逐秒节拍表、带镜头描述的导演卡),先出两个场景的静帧让你看,再出半尺寸草稿,最多两轮修改,最后全尺寸渲染。快速模式的片子以后也能转进电影模式,节拍表直接变成路线图。
电影模式面向十分钟以上的纪录片和视频随笔:脚本里涉及真实人物或事件的每一条说法都要带出处;第一分钟埋一个悬念;旁白不会直接用 TTS 引擎原声,而是做过声音处理;按章节配乐。8 种观感预设包括写实电影感、日式赛璐璐、粉彩绘本、黏土、剪纸拼贴、复古合成波、商业亮面、手绘墨线。
安装和第一支片子
# 在 Claude Code 里直接说:
# Install the cinecode skill from https://github.com/sarpstar/cinecode
# 或手动克隆:
git clone https://github.com/sarpstar/cinecode.git ~/.claude/skills/cinecode
# Cursor 用户放这里:
git clone https://github.com/sarpstar/cinecode.git ~/.cursor/skills/cinecode
# 新建空目录开始拍
mkdir my-film && cd my-film && claude
# 然后输入:I want to make a short film
README 提醒只装一份,别让 Agent 看到两个副本。缺的依赖 Agent 会先检查机器、征得你同意后再装;capture.mjs --probe 会看 Chrome 能不能用上 GPU,没有 GPU 就退回 CPU 渲染,测试够用,整片会慢。快速模式把帧直接写进 MP4,几百 MB 磁盘就够;电影模式渲染时每支片要几 GB。
旁白是可选的:用你自己的 Gemini key(有免费额度)、ElevenLabs,或系统语音。key 只需要输入一次,存在 ~/.cinecode/keys.env,以后每支片共用。保存过的片子格式、口味记录也在 ~/.cinecode/,Skill 自己的目录不会被写入。
几个要先知道的限制
- 用量不小。README 写明每一步都会重读整段对话,大部分走缓存,但对话越长每一步越贵;所以一个阶段做完、对话变长时,它会建议你开新会话接着做,进度记在
STATE.md里。 - 防呆钩子只在 Claude Code 里生效。SKILL.md 里挂了 UserPromptSubmit、Stop、PreToolUse 钩子,用来拦「还没给你看剧本就往下走」「草稿没给你看」这类失误;Cursor 里
make.py、qc.py检查照样跑,钩子不跑。 - Windows 整片流程作者还没完整走过。README 说测试会在 Windows 和 Linux 上每次推送都跑,macOS 在每次改动前跑。
- 土耳其语优先。免费旁白音色都是土耳其语模型,英文旁白走 Gemini 或 ElevenLabs。
如果你只想要一个现成风格库、自己掌控流程,lemo-opuscar 更轻;想要一个替你走完「问需求 → 计划 → 静帧 → 草稿 → 成片」并在每一关停下来等你点头的导演,cinecode 更合适。做 HTML 视频的另一条路线可以看 HyperFrames。
最后
先用快速模式拍一支 15 秒的竖屏短片:在空目录里说出一句想法,按推荐选项(标 ★ 的那个)一路确认,看看两张静帧和第一版草稿是否接近你想要的样子,再决定要不要上电影模式。