1. 项目缘起为什么我要把视频处理这件事“工具化”做内容这行时间长了绕不开一个现实视频处理是个体力活。剪辑、转码、加字幕、批量压缩、生成演示动画每一步单拎出来都不难但一旦量上来纯靠手点软件就是灾难。我最早是手动用剪辑软件一个个导出后来发现同样的操作重复三十遍人就开始怀疑人生。于是我开始琢磨能不能把“视频使用”这件事抽象成一套可复用的流程让代码去干重复的活我只负责创意和决策。这个项目我给它起名video-use核心思路很简单把视频从“素材”到“成品”的全链路拆成几个标准环节每个环节用最合适的工具去承接。Claude Code负责编排和生成逻辑ffmpeg负责底层的转码、裁剪、拼接、推流Remotion负责用 React 写视频Manim负责数学和工程类的动画演示。这四个东西凑在一起基本覆盖了我日常 90% 的视频处理需求。你可能会问为什么不直接用剪映或者 Premiere答案很直接批量、可编程、可版本控制。剪映做一条视频很快但做一百条结构相同的视频它就是瓶颈。而用代码驱动我可以把视频模板写成函数把参数抽出来改一个变量就能生成一百条不同的成品。这对做教程、做数据可视化、做产品演示的人来说价值是碾压性的。这篇文章适合谁看如果你是开发者、技术博主、教育内容创作者或者任何需要批量生产视频的人这套东西能帮你省下大量重复劳动。如果你只是想剪个 vlog那可能用不上但了解一下思路也没坏处。接下来我会把整个 video-use 的设计思路、工具选型、实操步骤、踩坑经验全部摊开讲尽量让你看完就能上手。2. 整体设计与工具选型为什么是这四个东西2.1 核心架构编排层、执行层、渲染层三层分离我把 video-use 分成三层。最上面是编排层用 Claude Code 来做。它的角色是“导演”负责理解需求、生成脚本、调度下面的工具。中间是执行层ffmpeg 是绝对主力所有涉及视频文件的读写、转码、裁剪、合并、推流都归它管。最下面是渲染层Remotion 和 Manim 负责从零生成视频内容一个偏 UI 和动态图形一个偏数学和工程动画。这三层分离的好处是每一层都可以独立替换。比如你不想用 Claude Code换成自己写的 Python 脚本也行不想用 Remotion换成纯 ffmpeg 拼接图片序列也行。架构不绑死工具只是当前最优解。为什么把 Claude Code 放在编排层因为视频处理里有很多“脏活”比如根据一段文字描述生成 ffmpeg 命令、根据素材列表自动生成拼接脚本、根据报错信息推断问题所在。这些活以前得我自己查文档、试参数现在可以让 Claude Code 先出一版我再改。它不是替代我而是把我从查文档的重复劳动里解放出来。2.2 ffmpeg视频处理的“瑞士军刀”没有替代品ffmpeg 这个工具做视频的人迟早会碰到。它就是一个命令行程序但功能覆盖了视频处理的几乎所有方面格式转换、编码解码、裁剪、缩放、加水印、加字幕、推流、录制。它的学习曲线陡但一旦掌握效率是图形界面软件的十倍以上。我选 ffmpeg 做执行层理由有三个。第一它是事实标准几乎所有视频平台和工具底层都在用它遇到问题查资料容易。第二它支持脚本化一条命令可以处理一批文件配合 shell 或 Python 就是批量流水线。第三它足够稳定我处理过几万个视频文件ffmpeg 崩的次数屈指可数而且崩了也能从日志里找到原因。ffmpeg 的安装在不同系统上略有差异。Windows 用户去官网下载ffmpeg-master-latest-win64-gpl.zip解压后把bin目录加到环境变量 PATH 里就行。Ubuntu 用户直接sudo apt install ffmpeg但要注意源里的版本可能偏旧如果需要新特性得自己编译或者用静态构建。macOS 用户用 Homebrew 最省事brew install ffmpeg。安装完在终端敲ffmpeg -version能输出版本号就说明成了。注意Windows 上如果提示ffmpeg invalid argument大概率是路径里有空格或者中文把 ffmpeg 放在纯英文无空格的目录下能解决大部分玄学问题。2.3 Remotion用 React 写视频程序员的剪辑方式Remotion 的思路很特别它让你用 React 组件来描述视频的每一帧。你写一个组件接收当前帧号作为参数返回这一帧应该显示什么。Remotion 负责把这些帧渲染成视频文件。这意味着你可以用写网页的方式写视频用 CSS 做动画用 JavaScript 做逻辑用 npm 包做特效。我为什么需要它因为有些视频内容本质上是“数据驱动的动态图形”比如产品数据看板、排行榜动画、代码演示。这些用传统剪辑软件做很别扭但用 Remotion 就是写几个组件的事。而且 Remotion 支持参数化同一个组件传不同数据就能生成不同视频批量生产极其方便。Remotion 的安装需要 Node.js 环境。先装 Node然后npx create-videolatest就能创建一个项目模板。它的开发体验很好有一个预览窗口可以实时看效果改代码即时刷新。渲染的时候用npx remotion render命令可以指定输出格式、码率、并发数等参数。2.4 Manim数学动画的天花板但别用它做普通视频Manim 是 3Blue1Brown 那个频道用的动画引擎专门做数学和工程类的可视化。它用 Python 写你描述一个场景比如“画一个圆然后把它变成正方形”Manim 会生成平滑的动画。它的强项是精确、优雅、可重复特别适合做公式推导、几何变换、算法演示。但我要泼一盆冷水Manim 不适合做普通视频。它的渲染速度慢学习曲线陡而且做出来的东西风格很“学术”。如果你只是想加个转场或者字幕用 ffmpeg 或者 Remotion 就够了。Manim 应该用在它真正擅长的地方比如解释傅里叶变换、展示神经网络结构、演示物理仿真。Manim 的安装稍微麻烦一点因为它依赖 Python 和一些系统库。官方推荐用 pip 安装pip install manim。但在此之前你需要装好 Python、ffmpeg、以及一些开发库比如 Ubuntu 上的libcairo2-dev、libpango1.0-dev。装完之后用manim -pql scene.py SceneName就能渲染一个低质量预览版确认没问题再渲染高质量版。2.5 Claude Code把“查文档”这件事自动化Claude Code 是我最近半年用得最多的工具之一。它本质上是一个命令行里的 AI 编程助手可以读你的项目文件、执行命令、生成代码。在 video-use 这个项目里我主要用它做三件事生成 ffmpeg 命令、写 Remotion 组件、排查报错。举个例子我需要把一批视频统一转成 1080p、H.264 编码、AAC 音频以前我得翻 ffmpeg 文档确认参数现在直接跟 Claude Code 说“把这目录下所有 mp4 转成 1080p H.264音频 AAC 128k输出到 output 目录”它就能生成一条可用的命令。我再根据实际情况微调比如加上-crf 23控制质量加上-preset fast加快速度。Claude Code 的安装方式取决于你的系统。macOS 和 Linux 用户可以用 npm 安装npm install -g anthropic-ai/claude-code。Windows 用户建议在 WSL 里装体验更接近 Linux。装完之后在项目目录里运行claude就能启动。它需要配置 API 密钥这个在官方文档里有说明。提示Claude Code 在某些地区可能不可用如果遇到连接问题检查一下网络环境是否符合官方支持范围。另外它支持接入其他模型后端比如 DeepSeek具体配置方式在官方文档的“模型配置”章节有详细说明。3. 核心细节解析每个环节的关键参数与实操要点3.1 ffmpeg 转码CRF、preset、码率到底怎么选ffmpeg 转码最核心的三个参数是-crf、-preset和-b:v。很多人搞不清楚它们的关系我用自己的理解解释一下。-crf是“恒定质量”模式值越小质量越高文件越大。范围是 0 到 51默认 23。我的经验是18 到 23 之间是视觉无损区间再低就是浪费空间再高就开始有可见的块效应。做教程视频我用 20做归档我用 18做预览我用 28。-preset控制编码速度和压缩率的平衡。可选值从ultrafast到veryslow越慢压缩率越高但编码时间越长。我实测下来fast和medium的差距在文件大小上大概 5% 到 10%但编码时间差一倍。所以日常用fast就够了除非你要归档大量视频才值得用slow。-b:v是固定码率模式和-crf互斥。什么时候用固定码率当你需要精确控制文件大小或者推流带宽的时候。比如直播推流你得根据上行带宽设定码率这时候-b:v 2500k就比 CRF 更合适。下面这条命令是我最常用的转码模板ffmpeg -i input.mp4 -c:v libx264 -crf 20 -preset fast -c:a aac -b:a 128k -movflags faststart output.mp4-movflags faststart这个参数很多人忽略但它很重要。它把视频的元数据移到文件开头这样网页播放器可以边下边播不用等整个文件下载完。如果你要把视频放到网上一定要加这个参数。3.2 批量处理用 shell 循环还是 Python 脚本批量处理视频最简单的办法是 shell 循环for f in *.mp4; do ffmpeg -i $f -c:v libx264 -crf 20 -preset fast -c:a aac -b:a 128k output/${f%.mp4}_out.mp4 done这个写法在 Linux 和 macOS 上没问题但在 Windows 的 cmd 里语法不一样。如果你跨平台建议用 Python 的subprocess模块import subprocess from pathlib import Path for f in Path(.).glob(*.mp4): out Path(output) / f{f.stem}_out.mp4 cmd [ ffmpeg, -i, str(f), -c:v, libx264, -crf, 20, -preset, fast, -c:a, aac, -b:a, 128k, str(out) ] subprocess.run(cmd, checkTrue)Python 版本的好处是跨平台、容易加逻辑比如跳过已处理的文件、记录日志、并发执行。我现在的批量任务基本都用 Python 写shell 只用来做一次性快速操作。注意批量处理时一定要加错误处理。我踩过的坑是某个视频文件损坏ffmpeg 报错退出整个循环就断了。用 Python 的try/except包一下或者 shell 里加|| true让循环继续跑最后再统一检查哪些失败了。3.3 Remotion 组件设计把视频当成函数Remotion 的核心概念是“视频即组件”。你写一个 React 组件它接收frame参数返回这一帧的 JSX。Remotion 会从第 0 帧渲染到最后一帧把每一帧拼成视频。一个最简单的 Remotion 组件长这样import { AbsoluteFill, useCurrentFrame } from remotion; export const MyVideo () { const frame useCurrentFrame(); const opacity Math.min(1, frame / 30); return ( AbsoluteFill style{{ backgroundColor: black, justifyContent: center, alignItems: center }} h1 style{{ color: white, opacity }}Hello Video/h1 /AbsoluteFill ); };这个组件做了一件事前 30 帧里文字从透明渐变到不透明。useCurrentFrame()返回当前帧号你用这个值驱动任何动画。这种“帧驱动”的思路和传统剪辑软件的关键帧很像但更灵活因为你可以用任何 JavaScript 逻辑来计算每一帧的状态。Remotion 的参数化能力是它最大的优势。你可以定义一个composition接收props然后根据 props 渲染不同内容。比如做一个排行榜视频props 里传一个数组组件根据数组渲染排名、名字、分数。改数据就能生成新视频不用改代码。3.4 Manim 场景编写从“画一个圆”开始Manim 的编程模型是“场景”和“动画”。你定义一个场景类在construct方法里描述要画什么、怎么动。比如from manim import * class CircleToSquare(Scene): def construct(self): circle Circle() square Square() self.play(Create(circle)) self.wait(0.5) self.play(Transform(circle, square)) self.wait(0.5)这段代码做了三件事画一个圆、等半秒、把圆变成正方形。self.play()是播放动画self.wait()是暂停。Manim 会自动处理中间帧生成平滑的过渡。Manim 的学习曲线主要在“坐标系”和“变换”上。它的坐标系是数学坐标系原点在屏幕中心y 轴向上。这和网页开发的坐标系不一样刚开始容易搞混。另外Manim 的Transform是“变形”ReplacementTransform是“替换”两者行为不同用错了动画会很奇怪。提示Manim 渲染高质量视频很慢建议先用-ql低质量预览确认动画逻辑没问题再用-qh高质量渲染最终版。-p参数可以在渲染后自动播放方便快速检查。3.5 Claude Code 编排让 AI 帮你写命令和排查问题Claude Code 在 video-use 里的角色是“副驾驶”。我常用的几个场景第一生成 ffmpeg 命令。我描述需求它出命令我改参数。比如“把视频裁剪成 9:16 竖屏居中裁剪输出 1080x1920”它会生成类似ffmpeg -i input.mp4 -vf cropih*9/16:ih,scale1080:1920 output.mp4的命令。我再根据实际画面调整裁剪位置。第二写 Remotion 组件。我描述动画效果它生成组件代码我在预览窗口里看效果不满意就让它改。这比我自己从零写快很多尤其是涉及复杂 CSS 动画的时候。第三排查报错。ffmpeg 的报错信息有时候很晦涩比如Invalid argument或者Error while opening encoder。我把报错贴给 Claude Code它通常能指出是参数问题、编码器缺失还是文件损坏。这省了我大量搜索时间。Claude Code 的安装和配置在不同系统上略有差异。Ubuntu 用户可以用 npm 全局安装Windows 用户建议在 WSL 里操作macOS 用户直接 npm 安装即可。安装后需要配置 API 密钥具体步骤在官方文档里有。如果你在 VS Code 里工作也可以装 Claude Code 的 VS Code 扩展直接在编辑器里调用。4. 实操过程从零搭建一条视频处理流水线4.1 环境准备一次性把工具装齐我假设你用的是 Ubuntu 或者 macOSWindows 用户建议用 WSL。先把基础环境搭好。第一步装 ffmpeg。Ubuntu 上sudo apt update sudo apt install ffmpegmacOS 上brew install ffmpeg。装完ffmpeg -version确认。第二步装 Node.js。去 Node 官网下载 LTS 版本或者用nvm管理。装完node -v和npm -v确认。第三步装 Python。Ubuntu 自带 Python3macOS 用 Homebrew 装。装完python3 --version确认。第四步装 Manim。pip install manim如果报错缺依赖按提示装系统库。Ubuntu 上可能需要sudo apt install libcairo2-dev libpango1.0-dev。第五步装 Claude Code。npm install -g anthropic-ai/claude-code然后配置 API 密钥。第六步创建 Remotion 项目。npx create-videolatest my-video按提示选模板。这套装下来大概半小时取决于网速。装完之后你就有了一个完整的视频处理工具箱。4.2 第一个任务用 ffmpeg 批量转码并生成缩略图我拿一个实际场景来演示你有一批手机拍的视频想统一转成 1080p、H.264、AAC同时给每个视频生成一张缩略图。先建目录结构mkdir -p input output thumbnails把原始视频放进input然后写一个 Python 脚本import subprocess from pathlib import Path input_dir Path(input) output_dir Path(output) thumb_dir Path(thumbnails) for f in input_dir.glob(*.mp4): out_video output_dir / f{f.stem}_1080p.mp4 out_thumb thumb_dir / f{f.stem}.jpg # 转码 subprocess.run([ ffmpeg, -i, str(f), -vf, scale1920:1080:force_original_aspect_ratiodecrease,pad1920:1080:(ow-iw)/2:(oh-ih)/2, -c:v, libx264, -crf, 20, -preset, fast, -c:a, aac, -b:a, 128k, -movflags, faststart, str(out_video) ], checkTrue) # 生成缩略图取第 1 秒的帧 subprocess.run([ ffmpeg, -i, str(f), -ss, 00:00:01, -vframes, 1, -vf, scale640:-1, str(out_thumb) ], checkTrue) print(f处理完成: {f.name})这个脚本做了两件事转码和截图。scale和pad的组合保证视频保持比例并居中填充到 1920x1080不会变形。缩略图取第 1 秒的帧缩放到 640 宽高度自动。跑完之后检查output和thumbnails目录确认文件都在。如果某个视频失败脚本会抛异常你可以根据报错定位问题。4.3 第二个任务用 Remotion 做一个数据驱动的排行榜视频假设你有一组数据想生成一个动态排行榜视频。数据长这样[ { name: Alice, score: 95 }, { name: Bob, score: 87 }, { name: Charlie, score: 82 } ]在 Remotion 项目里创建一个组件import { AbsoluteFill, useCurrentFrame, interpolate, spring, useVideoConfig } from remotion; export const Leaderboard ({ data }) { const frame useCurrentFrame(); const { fps } useVideoConfig(); return ( AbsoluteFill style{{ backgroundColor: #1a1a2e, padding: 80 }} {data.map((item, index) { const delay index * 10; const progress spring({ frame: frame - delay, fps, config: { damping: 200 } }); const translateX interpolate(progress, [0, 1], [500, 0]); const opacity interpolate(progress, [0, 1], [0, 1]); return ( div key{item.name} style{{ display: flex, justifyContent: space-between, color: white, fontSize: 48, marginBottom: 30, transform: translateX(${translateX}px), opacity }} span{index 1}. {item.name}/span span{item.score}/span /div ); })} /AbsoluteFill ); };这个组件用spring做弹性入场动画每一项延迟 10 帧出现从右侧滑入并淡入。interpolate把 spring 的进度映射到位移和透明度。渲染的时候用npx remotion render Leaderboard out/leaderboard.mp4 --props[{name:Alice,score:95},...]改 props 就能生成不同数据的视频。这就是 Remotion 的威力视频变成数据的函数。4.4 第三个任务用 Manim 做一个算法演示动画假设你要演示冒泡排序的过程。用 Manim 写一个场景from manim import * class BubbleSort(Scene): def construct(self): nums [5, 2, 8, 1, 9] bars VGroup(*[ Rectangle(width0.8, heightn/10, fill_opacity0.8, fill_colorBLUE) for n in nums ]).arrange(RIGHT, buff0.2) labels VGroup(*[ Text(str(n), font_size24).next_to(bar, DOWN) for n, bar in zip(nums, bars) ]) self.play(Create(bars), Write(labels)) self.wait(0.5) # 演示一次交换 self.play( bars[0].animate.shift(RIGHT * 1.0), bars[1].animate.shift(LEFT * 1.0), labels[0].animate.shift(RIGHT * 1.0), labels[1].animate.shift(LEFT * 1.0), ) self.wait(0.5)这个场景画了五个柱子代表数字然后演示前两个交换位置。实际做完整排序动画需要更多逻辑但核心思路就是这样用animate描述对象的变化Manim 自动补间。渲染命令manim -pqh bubble_sort.py BubbleSort-q是高质量-p是渲染后播放。输出文件在media/videos/目录下。4.5 第四个任务用 Claude Code 编排整个流程前面三个任务都是手动写脚本。现在用 Claude Code 把它们串起来。我在项目根目录启动 Claude Code然后给它一个指令“写一个 Python 脚本扫描 input 目录下的视频用 ffmpeg 转码成 1080p然后用 Remotion 生成一个排行榜视频最后用 ffmpeg 把所有视频拼接成一个合集。”Claude Code 会生成一个脚本框架包含转码、调用 Remotion、拼接三个步骤。我再根据实际情况调整路径和参数。这个过程中它可能会犯一些错误比如 Remotion 的命令格式不对或者拼接时的编码参数不匹配。我把报错贴回去它就能修正。这种“人机协作”的模式比我自己从零写快很多也比完全依赖 AI 可靠。我的经验是让 AI 出第一版我来做审查和微调。它擅长生成模板代码和处理重复逻辑我擅长判断业务需求和边界情况。5. 常见问题与排查技巧实录5.1 ffmpeg 报错速查表报错信息可能原因解决方法Invalid argument参数拼写错误或路径含特殊字符检查参数路径用引号包裹避免中文和空格Error while opening encoder编码器未安装或参数不兼容确认 ffmpeg 编译时包含该编码器换用 libx264No such filter滤镜名称错误或未编译用ffmpeg -filters查看支持的滤镜Conversion failed输入文件损坏或格式不支持用ffprobe检查文件信息尝试重新下载Permission denied输出目录无写权限检查目录权限或换到有权限的目录5.2 Remotion 渲染慢怎么办Remotion 默认会并发渲染多帧但并发数太高会导致内存不足。我遇到过一次渲染到一半卡死查下来是并发数设太高。解决办法是在remotion.config.ts里设置Config.setConcurrency(4)根据机器配置调整。另外降低预览质量、减少不必要的 DOM 节点、避免在每一帧里做重计算都能提升渲染速度。5.3 Manim 渲染出来是黑屏Manim 黑屏通常是因为场景里没有添加任何对象或者对象在画面外。检查construct方法里有没有self.add()或self.play()。另外Manim 的默认背景是黑色如果你的对象也是黑色就看不见。用self.camera.background_color WHITE改背景色或者给对象设置明显的颜色。5.4 Claude Code 生成的命令不能直接用Claude Code 生成的 ffmpeg 命令有时候会缺少关键参数比如忘记加-c:a aac导致音频编码不兼容或者忘记加-movflags faststart导致网页播放卡顿。我的做法是把它生成的命令当成草稿自己过一遍参数。重点检查编码器、码率、输出格式、文件路径这四个地方。另外它可能会用一些冷门参数如果不确定效果先用短片段测试。5.5 批量处理时如何避免重复劳动我踩过的坑是脚本跑了一半崩了重新跑的时候已经把成功的文件又处理了一遍浪费时间。解决办法是在脚本里加一个“已完成”标记比如检查输出文件是否存在存在就跳过。或者用一个日志文件记录已处理的文件名下次跑的时候先读日志。import json from pathlib import Path log_file Path(processed.json) processed json.loads(log_file.read_text()) if log_file.exists() else [] for f in Path(input).glob(*.mp4): if f.name in processed: continue # 处理逻辑... processed.append(f.name) log_file.write_text(json.dumps(processed))这个模式看起来简单但能省下大量重复时间。尤其是处理几百个文件的时候一次中断可能意味着几小时的重复劳动。5.6 推流延迟高怎么排查用 ffmpeg 推流到 SRS 或者其他流媒体服务器时延迟高是常见问题。原因通常有三个编码参数导致缓冲区太大、网络带宽不足、服务器配置问题。我的排查顺序是先用-tune zerolatency降低编码延迟再用-preset ultrafast加快编码速度然后检查-b:v是否超过上行带宽。如果还不行检查服务器的 GOP 设置和缓冲区配置。实测下来-tune zerolatency -preset ultrafast -g 30这套组合能把延迟压到 1 秒以内。6. 我在这套流程里踩过的坑和总结的经验第一个坑是编码参数不统一。我早期做批量转码的时候有的视频用 CRF 20有的用 CRF 23结果拼接的时候发现画面质量不一致切换的时候有明显跳变。后来我定了一个规矩同一个项目里所有视频用同一套编码参数包括分辨率、码率、帧率、色彩空间。这样拼接和后续处理都不会出问题。第二个坑是音频采样率不匹配。ffmpeg 拼接视频时如果两个视频的音频采样率不同比如一个 44100Hz一个 48000Hz拼接会失败或者音画不同步。解决办法是在转码时统一加-ar 48000强制所有音频用 48kHz 采样率。第三个坑是Remotion 的字体问题。Remotion 渲染时用的是系统字体如果你在本地预览正常但渲染服务器上没有对应字体出来的视频字体会变。解决办法是在项目里用remotion/google-fonts加载网络字体或者把字体文件打包进项目用staticFile()引用。第四个坑是Manim 的版本兼容性。Manim 更新比较频繁不同版本的 API 有差异。我遇到过升级后Transform的行为变了动画效果完全不对。建议在项目里锁定 Manim 版本用pip install manim0.18.0这样的方式安装避免自动升级带来的意外。第五个坑是Claude Code 的上下文限制。Claude Code 处理大项目时如果文件太多它可能读不全上下文生成的代码会引用不存在的文件或函数。我的做法是把任务拆小一次只让它处理一个模块比如“只写转码脚本”或者“只写 Remotion 组件”不要让它一次性生成整个项目。最后分享一个我常用的调试技巧用短片段测试。不管是 ffmpeg 命令还是 Remotion 渲染先用前 5 秒的素材跑一遍确认参数和效果没问题再跑完整版。这能省下大量等待时间尤其是渲染高质量视频的时候。这套 video-use 的流程我用了大半年处理了上千个视频文件从批量转码到数据可视化再到算法演示基本覆盖了我的日常需求。工具本身不难难的是把流程串起来并且形成自己的参数模板和排查习惯。希望这些经验能帮你少走弯路。
