【免费下载链接】claude-video-visionGive Claude the ability to watch and understand videos — Claude Code plugin with frame extraction and multimodal audio analysis项目地址https://gitcode.com/gh_mirrors/cl/claude-video-vision点击查看免费下载claude-video-vision 是一款让 Claude 具备看视频、听音频能力的 Claude Code 插件它通过 ffmpeg 抽帧、配合多种音频后端Gemini API、本地 Whisper、OpenAI API实现多模态视频理解。如果你在安装 claude-video-vision时遇到 MCP 连接失败、依赖缺失或配置报错本文逐一给出这 7 个最常见配置问题的完整解决方案帮你一次装对。先跑通安装3 步快速安装回顾在排查问题前先确认标准安装流程获取插件本地开发方式git clone https://gitcode.com/gh_mirrors/cl/claude-video-vision claude --plugin-dir /path/to/claude-video-vision运行交互式配置向导在 Claude Code 中逐条执行/claude-video-vision:setup-video-vision向导会依次引导你选择音频后端、Whisper 配置、抽帧参数并自动校验依赖详见 commands/setup-video-vision.md。验证效果/watch-video path/to/video.mp4如果第 2 步之后 MCP 服务器显示 failed或第 3 步报错往下对号入座即可。问题 1Windows 上 MCP 服务器连接失败报Unknown command: claude-video-visionlatest症状claude mcp list中服务器显示 failed手动运行启动命令后输出Unknown command: claude-video-visionlatest并提示npm help。原因这不是插件本身的 bug——插件用npx -y claude-video-visionlatest启动 MCP 服务器。这个报错说明你的npx版本过旧或损坏把包名当成了子命令。解决步骤在 PowerShell 中检查版本与路径npx --version npm --version where.exe npx两个版本号应一致7 或更新且where.exe npx应指向 Node.js 安装目录内的npx.cmd。升级 npm 或重装 Node.js 24 LTSnpm install -g npmlatest仍然失败的绕行方案全局安装后手动注册服务器npm install -g claude-video-vision claude mcp add --scope user claude-video-vision -- claude-video-vision此时插件自带的服务器条目会一直显示 failed可以忽略。注意全局安装不会自动更新需重新执行npm install -g claude-video-vision获取新版本。问题 2出现EBADENGINE警告——Node.js 版本过旧症状首次使用时npx报EBADENGINE警告或 MCP 服务器启动异常。原因自 v1.4.0 起MCP 服务器要求Node.js 24engines.node: 24。Node 20 已于 2026-04-30 停止维护Node 22 用户会触发EBADENGINE警告详见 CHANGELOG.md 升级说明。解决方案升级到 Node.js 24 LTS官方安装包或版本管理器均可然后重启 Claude Code。安装前可先用node --version确认当前版本。问题 3ffmpeg / ffprobe 未安装无法抽取视频帧症状配置向导第 4 步依赖检查提示缺少ffmpeg或/watch-video报找不到 ffmpeg。原因所有后端无论云端还是本地都依赖 ffmpeg 抽帧、ffprobe 读取元数据它是唯一绕不开的核心依赖。ffprobe 随 ffmpeg 一起安装不需要单独处理。解决方案按操作系统选择与 mcp-server/src/utils/installer.ts 中向导给出的建议一致系统安装命令macOSbrew install ffmpegLinux (Debian/Ubuntu)sudo apt install ffmpegWindowswinget install ffmpeg安装后重启 Claude Code重新运行/setup-video-vision校验即可。问题 4后端未配置或 API Key 未设置症状音频转写报错或结果中没有transcription字段直接运行插件提示后端未配置。原因默认配置中backend为unconfigured见 mcp-server/src/config.ts 的defaultConfig必须显式选择并配置一种音频后端后端需要的配置成本Gemini API推荐环境变量GEMINI_API_KEY免费申请免费额度 1500 请求/天免费额度内 0 元Local (Whisper)安装 whisper.cpp 或 openai-whisper完全免费离线OpenAI API环境变量OPENAI_API_KEY按量计费解决方案运行向导/claude-video-vision:setup-video-vision在第 1 步选择后端向导会自动写入配置或手动设置环境变量Linux/macOS 可写入 shell 配置文件Windows 在系统环境变量中添加然后重启 Claude Code。所有配置最终保存在~/.claude-video-vision/config.json可随时查看核对。问题 5Local 后端报命令找不到whisper-cli / whisper 缺失症状选择 Local 后端后转写报错whisper-cli: command not found或whisper: command not found。原因Local 后端有两种引擎命令名不同whisper.cpp引擎 → 调用whisper-cliPythonopenai-whisper引擎 → 调用whisper引擎没装对应工具或选错引擎都会报找不到命令。解决方案# macOSwhisper.cpp 引擎推荐更快更省内存 brew install whisper-cpp # Python 引擎 pip install openai-whisper如果你只装了 Python 版却选的是 cpp 引擎或反之在向导第 2 步重新选择对应引擎即可选择会即时写入配置whisper_engine字段。问题 6Whisper 模型自动下载失败或选错模型症状首次使用 Local 后端时模型下载超时、校验失败或转写极慢。原因模型会在首次使用时自动下载到~/.claude-video-vision/models/并做 SHA-256 完整性校验。国内网络直接下载可能较慢模型选得比内存大则会导致明显卡顿。解决方案在向导中根据内存选模型tiny75MB快、small500MB均衡、large-v3-turbo1.5GB8GB 内存推荐、large-v32.9GB16GB 推荐或直接选auto让插件按硬件自动挑选下载失败时重试即可已下载部分会走校验机制避免损坏文件想手动清理重新下载删除~/.claude-video-vision/models/目录后重启。问题 7传 YouTube URL 无反应或下载失败症状/watch-video https://www.youtube.com/watch?v...报错或提示缺少工具。原因YouTube URL 支持依赖yt-dlp下载视频插件会保留源元数据与字幕作为上下文这是一个可选依赖——本地文件分析完全不需要它只有传 URL 时才必须。解决方案# macOS brew install yt-dlp # Linux pip install -U yt-dlp # Windows winget install yt-dlp安装后重试。提示YouTube 视频的字幕优先级为「手动英文字幕 → 自动字幕 → 音频后端转写」结果中的transcription_source字段如youtube_subtitles会标明来源手动字幕的证据权重更高。快速自查清单安装不出错的最后一步按顺序核对一遍90% 的安装问题都能在这张表里定位#检查项命令 / 位置期望结果1Node.js 版本node --versionv24 及以上2npx 可用性npx --version与 npm 版本一致≥73ffmpegffmpeg -version正常输出版本4后端配置~/.claude-video-vision/config.jsonbackend非unconfigured5API Key云端后端环境变量GEMINI_API_KEY/OPENAI_API_KEY已设置且重启过 Claude Code6Whisper 工具Local 后端whisper-cli --help或whisper --help与所选引擎对应7yt-dlp用 URL 才需要yt-dlp --version正常输出版本全部通过后运行/watch-video 任意视频.mp4做冒烟测试能返回抽帧结果与转写文本即代表配置成功。总结claude-video-vision 的安装链路可以概括为「装插件 → 跑向导 → 验依赖」三步Windows 用户重点排查 npx 与 Node 版本问题 1、2所有用户必须保证 ffmpeg 就位问题 3然后按所选后端补上 API Key 或 Whisper 工具问题 4、5、6需要看 YouTube 再加装 yt-dlp问题 7。遇到问题时/claude-video-vision:setup-video-vision向导的依赖检查对应 mcp-server/src/tools/video-setup.ts 的video_setup工具会直接告诉你缺什么、怎么装是最高效的排查入口。祝配置顺利让 Claude 真正看懂你的视频 赞分享【免费下载链接】claude-video-visionGive Claude the ability to watch and understand videos — Claude Code plugin with frame extraction and multimodal audio analysis项目地址https://gitcode.com/gh_mirrors/cl/claude-video-vision点击查看免费下载相关推荐Apache Parquet Java性能优化秘籍5个关键技巧提升读写速度300%Apache Parquet Java性能优化秘籍5个关键技巧提升读写速度300% Apache Parquet Java是处理大数据列式存储的 终极解决方案ConsistentID安装问题集conda环境配置常见错误解决方案ConsistentID安装问题集conda环境配置常见错误解决方案 你是否在配置ConsistentID的conda环境时遇到过包版本冲突、CUDA依赖错误cascade深度解析揭秘流畅高度动画的实现原理cascade深度解析揭秘流畅高度动画的实现原理 cascade是一款为Android平台打造的嵌套弹窗菜单库专注于实现具有流畅高度动画效果的用户界面组件。创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考