企业官网建设流程全解析

claude-video依赖安装攻略：ffmpeg和yt-dlp三大平台完整安装法

【免费下载链接】claude-videoGive Claude the ability to watch any video. /watch downloads, extracts frames, transcribes, hands it all to Claude.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-video

claude-video是一款让 AI 能"看视频"的开源工具：/watch命令会自动下载视频、抽取帧画面、提取字幕，把画面和音频内容一起交给 AI 分析。它有两个必装依赖——ffmpeg（负责抽帧）和yt-dlp（负责下载视频）。这篇 claude-video 依赖安装攻略将带你用最短路径完成 macOS、Linux、Windows 三大平台的安装配置。

🎬 为什么必须安装 ffmpeg 和 yt-dlp？

/watch的完整流水线是：yt-dlp 下载视频 → ffmpeg 按自动速率抽帧 → 拉取字幕或调用 Whisper 转写 → AI 逐帧"观看"后回答你的问题。

两个依赖各司其职：

好消息是：claude-video 内置了安装向导。首次调用/watch时，系统会自动运行前置检查脚本 scripts/setup.py，缺什么就会提示你装什么，macOS 上甚至会自动装好，全程零配置。

🍎 macOS 安装：Homebrew 一条命令（支持全自动）

macOS 是体验最好的平台——安装向导检测到缺少依赖时，会自动执行brew install ffmpeg yt-dlp，你只需要确认即可。

如果希望提前手动装好，在终端执行：

brew install ffmpeg yt-dlp

⚠️ 前提是你已安装 Homebrew。如果没有 brew，会看到"Homebrew is not installed"的提示，先按官方指引装好 brew 再重跑 setup 即可。

🐧 Linux 安装：apt/dnf + pipx 组合拳

Linux 上安装向导不会自动装（避免乱用 sudo），而是打印出精确命令，你复制执行即可：

# ffmpeg：Debian/Ubuntu 用 apt，Fedora 用 dnf sudo apt install ffmpeg sudo dnf install ffmpeg # yt-dlp：推荐 pipx（隔离环境，不污染系统 Python） pipx install yt-dlp # 或者用 pip 装到用户目录 pip install --user yt-dlp

💡 小提示：pipx没有的话可以pip install pipx。用--user安装后，确认~/.local/bin在 PATH 中，否则终端找不到yt-dlp。

🪟 Windows 安装：winget 一键搞定

Windows 上安装向导打印的是 winget / pip 命令：

# ffmpeg 官方构建 winget install Gyan.FFmpeg # yt-dlp winget install yt-dlp.yt-dlp # 或者 pip install --user yt-dlp

⚠️ 特别注意：Windows 上运行 claude-video 脚本时请使用python而不是python3——后者的默认命令是 Microsoft Store 的占位程序，跑不了脚本。

⚙️ 首次运行检查与 .env 配置

三大平台装好依赖后，剩下的就是配置一个可选的 Whisper API key。安装向导会创建配置文件~/.config/watch/.env（权限自动设为 0600，只有你本人可读），里面有两个占位项：

GROQ_API_KEY= OPENAI_API_KEY=

配置逻辑很简单：

• 有原生字幕的视频：yt-dlp 直接免费拉取字幕，什么都不用配就能用，覆盖绝大多数公开视频
• 无字幕的视频（本地文件、部分 TikTok 等）：回落到 Whisper API 转写，此时填一个 key——推荐 Groq（whisper-large-v3，更便宜更快），OpenAI（whisper-1）作为备选
• 完全不想配 key：加--no-whisper参数，无字幕视频只返回帧画面

检查机制很轻量：每次/watch调用前执行一次静默预检（setup.py --check），全部就绪时无任何输出，耗时不到 100ms，不会拖慢日常使用；缺依赖时才打印一行修复指引。退出码约定：2= 缺二进制，3= 缺 API key，4= 两者都缺。

✅ 验证安装是否成功

安装完成后，在终端确认两个命令都能输出版本号：

ffmpeg -version yt-dlp --version

然后直接发起一次真实调用（项目克隆地址：git clone https://gitcode.com/GitHub_Trending/cl/claude-video ~/.claude/skills/watch）：

/watch ~/Movies/demo.mp4 这个视频讲了什么？

如果 AI 能逐帧描述画面并引用字幕时间戳，说明依赖已就位。

📦 相关源码速览

想了解安装逻辑细节，可以翻这两个文件：

• scripts/setup.py— 前置检查 + 安装向导（幂等，可反复执行，不会覆盖你已填的 key）
• hooks/scripts/check-setup.sh— Claude Code 会话启动时的状态钩子，一行提示当前缺什么

总结

记住核心原则：依赖装好 → 有字幕的视频直接免费用 → 无字幕再配 Whisper key。三步走完，Claude 就能真正"看"懂任何视频了。

【免费下载链接】claude-videoGive Claude the ability to watch any video. /watch downloads, extracts frames, transcribes, hands it all to Claude.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-video