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-videoclaude-video是一款让 AI 能看视频的开源工具/watch命令会自动下载视频、抽取帧画面、提取字幕把画面和音频内容一起交给 AI 分析。它有两个必装依赖——ffmpeg负责抽帧和yt-dlp负责下载视频。这篇 claude-video 依赖安装攻略将带你用最短路径完成 macOS、Linux、Windows 三大平台的安装配置。 为什么必须安装 ffmpeg 和 yt-dlp/watch的完整流水线是yt-dlp 下载视频 → ffmpeg 按自动速率抽帧 → 拉取字幕或调用 Whisper 转写 → AI 逐帧观看后回答你的问题。两个依赖各司其职依赖作用缺少后的后果yt-dlp下载视频、拉取平台原生字幕无法解析任何 URLffmpeg/ffprobe抽取帧画面为 JPEG、提取音频无法生成任何画面好消息是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而是打印出精确命令你复制执行即可# ffmpegDebian/Ubuntu 用 aptFedora 用 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——推荐 Groqwhisper-large-v3更便宜更快OpenAIwhisper-1作为备选完全不想配 key加--no-whisper参数无字幕视频只返回帧画面检查机制很轻量每次/watch调用前执行一次静默预检setup.py --check全部就绪时无任何输出耗时不到 100ms不会拖慢日常使用缺依赖时才打印一行修复指引。退出码约定2 缺二进制3 缺 API key4 两者都缺。✅ 验证安装是否成功安装完成后在终端确认两个命令都能输出版本号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— 前置检查 安装向导幂等可反复执行不会覆盖你已填的 keyhooks/scripts/check-setup.sh— Claude Code 会话启动时的状态钩子一行提示当前缺什么总结平台依赖安装自动化程度macOSbrew install ffmpeg yt-dlp⭐⭐⭐ 向导自动执行Linuxapt/dnf install ffmpegpipx install yt-dlp⭐⭐ 打印精确命令Windowswinget install Gyan.FFmpegwinget install yt-dlp.yt-dlp⭐⭐ 打印精确命令记住核心原则依赖装好 → 有字幕的视频直接免费用 → 无字幕再配 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考