📌 本文重點
claude-video把影片轉成可問答知識庫- 下載影片、抽幀、語音轉文字全自動
- 多模態上下文交給 Claude 做各種分析
- 10 分鐘跑起來,適合教學、課程、demo、監控
一句話定位:claude-video 讓 Claude 真的「看見」影片,從下載、抽幀、語音轉文字到多模態分析,全包成一個指令搞定。
GitHub 專案連結:https://github.com/bradautomates/claude-video
核心功能:一個指令,讓影片變成可問答的知識庫
claude-video 的核心做的只有一件事:把「影片」轉成 Claude 能理解的多模態上下文。實際拆開來有 3 個關鍵步驟,每一個你都能拿來做自動化。
💡 關鍵: 透過影格+逐字稿+影片資訊的打包,任何影片都能變成可搜尋、可摘要、可問答的結構化知識來源。
1. 自動下載影片 + 抽幀
你只要給一個網址(目前主要是 YouTube),工具會:
- 下載原始影片檔
- 依照設定好的間隔抽出代表性的影格(frames)
- 這些影格會作為「圖片上下文」送給 Claude
能做什麼:
- 只看技術教學影片的關鍵畫面(程式碼、投影片、操作步驟)
- 分析產品 demo 畫面上的 UI 元素、錯誤提示、流程
行動建議:
- 想節省時間,把你常看的教學頻道某一支影片的 YouTube 連結先存起來,待會在「怎麼開始」小節直接拿來測試。
2. 語音轉文字,變成完整逐字稿
工具會對影片做語音轉文字,把講者說的內容轉成文字,和影格一起送給 Claude。
常見效果:
- 自動生成逐字稿(含時間點)
- 把講者的講解內容和畫面對應起來,更容易做重點歸納
行動建議:
- 準備一支你想要「變成文字教材」的影片,比如線上課程、內訓錄影,後面你可以直接用它跑出教學大綱和筆記。
3. 打包成多模態上下文交給 Claude
最後,工具會把:
- 抽出來的影格(圖片)
- 語音轉文字的逐字稿
- 影片的基礎資訊(標題、描述等)
全部打包成一個多模態 prompt,交給 Claude 分析。你可以自訂要 Claude 做什麼:摘要、生成教學、抓重點、產生 QA 題庫等。
行動建議:
- 先想好你最常對影片做的「重複動作」,例如:
- 幫我整理重點
- 幫我寫 SOP
- 幫我做中文摘要
稍後你可以把這段常用指令寫進腳本裡,變成一個固定 workflow。
適合誰用:4 個實際場景示範
情境 1:YouTube 教學影片秒變重點筆記
場景:你常看 Python / 前端 / 設計 / No-Code 教學影片,但看完就忘。
用法示例:
- 把影片連結丟給
claude-video - 設定 Claude 指令:
- 濃縮成 10 條重點
- 列出關鍵程式碼片段
- 把操作步驟寫成 checklist
結果:你得到一份可以直接放進筆記軟體的整理稿,比自己邊看邊記快很多。
實際行動:
- 找一支你最近收藏但還沒看的教學影片,稍後用它做第一次測試,順便讓工具幫你「看完」。
情境 2:線上課程變成可搜尋的知識庫
場景:公司或個人買了一整套線上課程,內容很多但不容易查找。
用法示例:
- 把每一堂課的影片都用
claude-video跑一次 - 要 Claude:
- 將每支影片整理成「課程筆記 + 關鍵字標籤」
- 產出 5–10 個 QA 題目,當作測驗
結果:你可以把整理好的文字放到 Notion / Obsidian / 任意知識庫裡,之後用關鍵字就能查到課程中的重點片段。
💡 關鍵: 只要每支課程影片都跑過一次,整套課程立刻升級成可搜尋、可測驗的知識庫,大幅降低複習與查找成本。
實際行動:
- 選 1–2 支課程影片做試驗,先建立最小可用的「課程知識庫」,再看要不要自動化整套課程。
情境 3:產品 demo 影片自動轉成文件說明
場景:團隊常錄 demo 影片給客戶、內部成員,但文件補不上。
用法示例:
- 用
claude-video處理 demo 錄影 - 指定 Claude 任務:
- 把操作流程寫成逐步教學文件
- 把畫面上的按鈕、表單欄位整理成功能說明
- 生成「常見問題」和解答
結果:每一支 demo 可以在幾分鐘內變成:使用說明、FAQ、給新人的入門文件。
實際行動:
- 把你最近一次 demo 錄影拿來跑,看看產出的文件是否已經可以直接發給客戶或新同事。
情境 4:監控 / 內訓影片做檢索與稽核
場景:公司有大量監控影片或內部訓練錄影,想快速查某一段內容是否出現。
用法示例:
- 用
claude-video跑監控或內訓影片 - 詢問 Claude:
- 某時間段內是否有特定事件(例如:某動作、某流程有沒有照 SOP 做)
- 把違反規範的段落列出,附時間碼
結果:你得到可以檢索的文字紀錄與標註,比逐段人工看影片省時間。
實際行動:
- 先選一支 5–10 分鐘的內訓影片,測試「違規行為摘要」或「流程是否照 SOP」的任務。
怎麼開始:10 分鐘跑起來教學
下面是最短路徑:從零到跑出第一個影片分析結果,大致 10 分鐘內可完成。
步驟 1:環境準備與 clone 專案
需求:
- Python 3.10+(建議)
- 一個終端機環境(macOS / Linux / Windows 都可)
指令:
# 1. 下載專案
git clone https://github.com/bradautomates/claude-video.git
cd claude-video
# 2. 建議建立虛擬環境
python -m venv .venv
source .venv/bin/activate # Windows 用 .venv\Scripts\activate
# 3. 安裝依賴
pip install -r requirements.txt
行動建議:
- 如果你常跑 Python 專案,建議專門開一個資料夾放各種 AI 工具腳本,
claude-video也一起放進去,日後好維護。
步驟 2:設定 Claude API Key
你需要一組 Anthropic Claude 的 API Key(可到官方註冊後取得):
- Claude 官網:https://www.anthropic.com/
設定方式通常是:
export ANTHROPIC_API_KEY="你的_API_Key"
# 或在 Windows PowerShell:
setx ANTHROPIC_API_KEY "你的_API_Key"
有些版本會使用 .env 檔,你可以在專案根目錄建立:
ANTHROPIC_API_KEY=你的_API_Key
行動建議:
- 先確認你目前的方案是否有多模態權限(支援圖片 + 文字),不然影片影格送進去會失敗或被降級成文字模式。
步驟 3:跑第一個影片分析任務
以 YouTube 影片為例,專案通常提供類似 /watch 的指令或腳本(具體以 repo 當前 README 為準)。假設有一個 CLI:
python watch.py "https://www.youtube.com/watch?v=你的影片ID"
這一步會:
- 下載影片
- 抽幀與語音轉文字
- 把結果送進 Claude,依照預設 prompt 報告分析結果
輸出可能是:
- 一段純文字摘要
- 搭配時間碼的段落整理
- 對影片內容的 QA 回答
行動建議:
- 用你一開始準備的「教學影片」做第一次測試,觀察 Claude 對畫面與講解內容是否理解到位。
步驟 4:改成你自己的 workflow 步驟
跑成功一次之後,接下來就看你想把它接到哪個流程裡。以下給一個常見範例:接到影片連結就自動生成「中文摘要+切片提綱」。
你可以:
- 修改專案裡的 prompt 或新增一個配置檔,例如
prompts/summary_zh.txt:
“`text
你是一位教學內容整理助理。
請根據提供的影片影格與逐字稿,輸出: - 以繁體中文撰寫 300–500 字摘要
- 列出 8–12 個重點段落,每段附上時間碼
- 對每個重點段落寫 1 句適合當剪輯標題的文案
“` - 在主程式中改成讀這個 prompt,並將輸出寫入檔案:
bash
python watch.py "https://www.youtube.com/watch?v=影片ID" \
--prompt prompts/summary_zh.txt \
--output output/影片ID_summary.md - 再往前接:
- 用表單或簡單網頁,讓同事貼影片連結
- 後端直接呼叫這個腳本
- 完成後把 Markdown 檔推到 Notion、Git repo 或寄信通知
行動建議:
- 先把「中文摘要+切片提綱」這種需求寫成一個固定 prompt,試跑幾支影片調整語氣與格式,穩定後再接到你的自動化流程裡。
小結
claude-video 做的事情很直接:讓 Claude 真正能看懂影片,而不只是看標題和描述。
只要你願意花 10 分鐘:
- clone 專案
- 寫好 API Key
- 跑一支 YouTube 教學影片
你就能把「看影片、整理重點」這件事交給 Claude 處理,自己只負責看整理好的結果。接下來要擴展到線上課程、產品 demo、監控影片,都只是在同一套流程上微調 prompt 而已。
🚀 你現在可以做的事
- 打開終端機,依照教學 clone
claude-video並設定好ANTHROPIC_API_KEY- 找一支你常看的 YouTube 教學影片,實際跑一次
python watch.py "影片連結"看結果- 建立一個
prompts/summary_zh.txt,把你想要的「中文摘要+重點」格式寫進去,開始打造自己的影片整理 workflow


發佈留言