ffmpeg-skill 教學:讓 Claude Code 一句話幫你剪片、上字幕

0
24 人次
廣告

  ffmpeg-skill 教學:讓 Claude Code 一句話幫你剪片、上字幕

想把一段橫式影片剪成 IG Reels,通常有兩條路。一條是打開剪輯軟體,拖時間軸、調比例、上字幕,再找輸出設定。另一條是用 FFmpeg 下指令,速度快、不用開軟體,可是那一長串參數,沒查資料幾乎寫不出來。

最近 GitHub 上有個很熱門的開源專案 ffmpeg-skill,走的是第三條路。你用一句話告訴 Claude Code 要剪成什麼樣子,它就會呼叫作者寫好的工具,用你電腦上的 FFmpeg 處理影片,剪完再把成品的長度、尺寸、音量量一次給你看。這篇阿正老師整理它要花多少錢、要先裝什麼、怎麼安裝,以及用之前要知道的限制。



一、ffmpeg-skill 是什麼?AI 是怎麼幫你剪片的

ffmpeg-skill 是開發者 kajisho5 在 2026 年 9 月開源的「Agent Skill」,可以把它想成裝給 AI 助手的技能包。裝好之後,Claude Code、Cursor、Codex 這類 AI 寫程式工具,就多了 42 個剪輯影片用的工具。還不熟 Skill 是什麼的讀者,可以先看這篇用公司組織比喻 Skill、MCP 的文章。

ffmpeg-skill 的官方網站首頁
圖片來源:ffmpeg-skill 官方網站,擷取於 2026-11-21

一般請 AI 寫 FFmpeg 指令,AI 常常是用猜的。它可能假設影片是 30 fps,或選了一個 MP4 裝不下的編碼格式,跑完也不會打開成品檢查一下,就回報「完成了」。ffmpeg-skill 的作者在 README 裡寫的,就是要解決這些問題,做法有下面三個重點。

  • 先讀影片資訊再動手:每次都先用 probe 工具讀出影片實際的長度、fps、解析度和音軌,再依真實數字決定怎麼剪。
  • AI 不直接寫 FFmpeg 指令:AI 只能填固定的選項,例如「比例 9:16、補黑邊」,指令由工具自己組出來。官方說明這些工具不經過 shell 執行,也不接受 AI 自己寫的濾鏡參數。
  • 剪完一定要驗證:成品寫出來後,工具會再讀一次檔案,核對長度、尺寸、音量是不是你要的。畫面有改動的話,還會拍一張多格縮圖給 AI 看。
示意圖:ffmpeg-skill 的剪片流程,讀取影片資訊、剪輯、檢查規格、驗證成品
示意圖:ffmpeg-skill 的剪片流程,讀取影片資訊、剪輯、檢查規格、驗證成品

FFmpeg 的影音處理在你的電腦上執行。Claude Code 的模型服務仍可能收到對話、工具回傳的資訊和交給模型檢查的縮圖。

官方網站 https://github.com/kajisho5/ffmpeg-skill
最新版本 4.3.0(發布日期:2026-11-21)
支援系統 Windows、macOS、Linux
費用 ffmpeg-skill 本身免費開源(MIT 授權);搭配的 Claude Code 需要付費方案
中文支援 工具與說明文件為英文;可以用中文對 Claude Code 下指令,效果待實測
需要環境 FFmpeg 6.1 以上、Python 3.10 以上;用 npx 安裝要 Node.js 16 以上
軟體下載 [本站下載點]

二、費用與事前準備

ffmpeg-skill 是 MIT 授權的開源專案,本身不用錢,也不需要申請任何 API 金鑰。AI 工具的費用依你使用的服務而定。這篇以 Claude Code 為主,還沒用過的讀者,可以先看Claude Code 新手教學。

⚠️ Claude Code 不在免費方案裡。依 Anthropic 官方定價頁(2026-11-21 查閱),所有付費方案都包含 Claude Code。個人用的 Pro 方案月繳 20 美元,年繳一次付 200 美元,官方標示約每月 17 美元。以上為未稅標價。Claude Code 和網頁版聊天共用同一份用量額度,剪片時 AI 來回呼叫工具,也會吃掉額度。

剪片需要 FFmpeg 和 Python。用 npx 安裝或執行健康檢查時,也需要 Node.js。

  • FFmpeg 6.1 以上:真正處理影片的程式。找不到 FFmpeg 時,下一節的安裝指令會嘗試用系統套件管理工具安裝。
  • Python 3.10 以上:42 個工具都是 Python 寫的,只用 Python 內建的功能,不用另外安裝套件。
  • Node.js 16 以上:執行本文的 npx 指令時需要。用 Claude Code 外掛的方式安裝就不用。

不確定自己有沒有裝,可以打開終端機(Windows 是「終端機」或 PowerShell,Mac 是「終端機」App),輸入下面兩行。有顯示版本號,就代表裝好了。

python3 --version
node --version

Windows 如果找不到 python3,可以改用 python --version,或試試 py --version。看見版本號後,再和上面的最低版本比對。


三、安裝教學:Windows 與 Mac

官方提供好幾種安裝方式,一般人用第一種就好。

方法一:用 npx 安裝技能包

在終端機輸入下面這行。

npx ffmpeg-skill setup

這行指令會做三件事。第一,找出電腦上裝了哪些 AI 工具(Claude Code、Cursor、Codex),把技能包裝進去;一個都找不到時,預設裝給 Claude Code。第二,如果找不到 FFmpeg,就嘗試安裝;已在 PATH 上但版本太舊時,請自行更新。第三,最後跑一次健康檢查。

方法一:用 npx 安裝技能包-ffmpeg-skill 教學:讓 Claude Code 一句話幫你剪片、上字幕

⚠️ 自動安裝 FFmpeg 時,它會在 Mac 上執行 brew install ffmpeg-full,在 Windows 上執行 winget install --id Gyan.FFmpeg -e,在有 apt-get 的 Linux 上用 sudo apt-get install -y ffmpeg(以 root 執行時省略 sudo)。想略過 FFmpeg 自動安裝,可以改打 npx ffmpeg-skill setup --no-ffmpeg,FFmpeg 自己裝。

方法二:在 Claude Code 裡用外掛安裝

Claude Code 2.1.275 以上的版本,可以直接在 Claude Code 裡輸入下面這行。這種方式不需要 Node.js,之後用 claude plugin update 就能更新。

/plugin install ffmpeg-skill --marketplace kajisho5/ffmpeg-skill

用 Codex CLI、Gemini CLI 的讀者,官方 README 也有對應的外掛安裝指令。其他支援 MCP 的程式(例如 Claude Desktop),可以改用 MCP 伺服器的方式連接,設定方法請看 README 的 MCP 章節。

Mac 怎麼讓終端機找到 ffmpeg-full

Homebrew 的 ffmpeg-full 提供上字幕、加文字所需的濾鏡。若 PATH 上已有 Homebrew 一般版,ffmpeg-skill 會優先使用同一個 Homebrew 目錄下的完整版。若終端機找不到 FFmpeg,或你想讓終端機優先使用完整版,可將下面這行加進 shell 設定檔(例如 zsh 的 ~/.zshrc),再重開終端機。

export PATH="$(brew --prefix ffmpeg-full)/bin:$PATH"

裝完先做健康檢查

輸入 npx ffmpeg-skill doctor,它會檢查 FFmpeg 和每個工具需要的元件齊不齊全。

裝完先做健康檢查-ffmpeg-skill 教學:讓 Claude Code 一句話幫你剪片、上字幕

看到結果顯示 ok: false 先別緊張。只要有任何一個工具缺元件,這裡就會顯示 false,可是其他工具通常還是能用。結果裡會列出缺了什麼,照著補裝就好。


四、它能做什麼?功能分類一次看

42 個工具官方分成 6 類。不用記工具名稱,跟 Claude Code 描述你想要的結果,它會自己挑。下表每類只挑幾個一般人會用到的。

示意圖:ffmpeg-skill 的 6 大功能分類,分析、剪輯、音訊、畫面、輸出與檢查、整合流程
示意圖:ffmpeg-skill 的 6 大功能分類,分析、剪輯、音訊、畫面、輸出與檢查、整合流程
分類 可以做的事(舉例)
分析與檢視 讀出影片資訊、拍多格縮圖、找出換鏡頭的位置
剪輯 剪掉或保留片段、合併影片加轉場、刪除沒講話的空白、橫式轉直式、防手震、在指定範圍打馬賽克
音訊 降噪、背景音樂在講話時自動變小聲、音量標準化、對齊另外收音的麥克風
畫面 上字幕(可逐字跳出、卡拉 OK 效果)、加標題卡和人名條、疊 Logo、綠幕合成、調色
輸出與檢查 依平台規格輸出、檢查成品符不符合平台要求、產生小尺寸預覽檔
整合流程 把多個步驟寫成一份專案一次跑完、批次處理整個資料夾、多機位切換

42 個工具裡,有 12 個是官方標為「穩定版」的核心工具(讀取資訊、縮圖、剪切、轉比例、刪空白、音訊、音量、字幕、文字圖卡、輸出、檢查、整合輸出),其他 30 個是 beta 版。

比較實用的是內建的社群平台範本,包括 TikTok、Instagram Reels、YouTube Shorts、YouTube、X、LinkedIn、Facebook 和 Podcast,也有把音檔做成波形影片的 Audiogram 範本。以 TikTok 範本為例,官方說明它會裁成 9:16、把字幕放在 TikTok 說明文字區的上方、避開右邊的按讚欄,音量調到 −14 LUFS(衡量音訊整體有多響的單位),最後再檢查一次成品符不符合規格。

如下圖,可以直接在Claude軟體的「Code」模式,直接問Claude要如何使用,如果需要另外安裝套件(如生成字幕需要的whisper),它也會直接提示,幫你安裝。

四、它能做什麼?功能分類一次看-ffmpeg-skill 教學:讓 Claude Code 一句話幫你剪片、上字幕


五、實際操作:用一句話剪出 Reels

裝好之後,在影片所在的資料夾打開 Claude Code,直接用一般說話的方式描述需求就好。官方 README 舉了一個例子,阿正老師翻成中文如下。

「把 interview.mp4 的 0:45~1:20 和 5:00~5:25 留下來,做成一支 60 秒的 Reels。」

依官方說明,AI 會先讀取影片資訊,接著剪出兩段、轉成 9:16、用 Reels 的設定輸出,再檢查規格、拍縮圖確認畫面,最後回報成品的長度、解析度、fps 和音訊格式。

情境 A:橫式影片轉成直式短影音

情境 A:橫式影片轉成直式短影音-ffmpeg-skill 教學:讓 Claude Code 一句話幫你剪片、上字幕

原本的橫式影片與轉好的 9:16 直式影片對照

情境 A:橫式影片轉成直式短影音-ffmpeg-skill 教學:讓 Claude Code 一句話幫你剪片、上字幕(圖 2)

情境 B:自動刪掉沒講話的空白

錄解說影片最常見的問題,就是講話中間停頓太久。刪空白的工具預設找出低於 −35 dBFS、持續至少 0.6 秒的停頓,剪掉中間並在兩端各留 0.2 秒。如果它什麼都沒找到,會提示你調整門檻。

情境 B:自動刪掉沒講話的空白-ffmpeg-skill 教學:讓 Claude Code 一句話幫你剪片、上字幕

情境 C:AI 自動上中文字幕

自動產生字幕要另外裝一套在本機跑的語音辨識引擎,ffmpeg-skill 本身沒有內建。官方建議最簡單的是 faster-whisper,在終端機輸入 pip install faster-whisper 就能安裝,第一次執行會下載辨識模型。依官方 SKILL.md,英文以外的語言都要用 Whisper 類的引擎,請 AI 上字幕時記得講清楚影片說的是中文。沒有裝引擎的話,工具會拒絕執行並列出安裝指令,不會自己亂編字幕。想多了解本機語音辨識,可以看本機離線語音轉文字工具推薦。

字型方面,官方說明遇到中文、日文、韓文等文字時,工具會自動找電腦上能顯示的字型;只有漢字的字幕可以指定 --lang zh-TW,提示工具選用繁體中文字型。字幕的繁簡仍要看辨識結果。

情境 C:AI 自動上中文字幕-ffmpeg-skill 教學:讓 Claude Code 一句話幫你剪片、上字幕

剪完可以叫出「審閱頁」

剪完之後,可以跟 AI 說「給我看審閱頁」。它會在電腦上產生一個 HTML 網頁,左邊是原始素材和每一步的檢查結果,中間是原始畫面、成品和時間軸,方便你確認 AI 到底做了哪些事。

剪完可以叫出「審閱頁」-ffmpeg-skill 教學:讓 Claude Code 一句話幫你剪片、上字幕


六、限制與注意事項

  • 它負責執行,不負責決定:官方寫得很清楚,ffmpeg-skill 不會判斷哪一段比較精彩、成品能不能交差。剪哪裡還是要你自己決定,或交給 AI 判斷再由你確認。
  • 沒有時間軸可以拖拉:所有操作都靠對話。想逐格微調轉場或字幕位置,用剪輯軟體還是比較直覺,可以參考免費影片剪輯軟體推薦。只想快速無損剪一段的話,LosslessCut 更簡單。
  • 改版非常頻繁:專案 2026 年 9 月才建立,到 11 月已經發布到 v4.3.0,官方說常常一週發好幾版。裝好的技能包不會自己更新,要更新請再跑一次 npx ffmpeg-skill@latest setup。本文的指令以撰寫當下為準,實際請對照官方 README。
  • 只有 12 個工具是穩定版:另外 30 個 beta 工具的參數,可能在小版本更新時改名或移除。
  • 原始檔有保護:輸出檔名和來源檔相同時,工具會拒絕執行;要覆蓋已經存在的檔案,必須另外加 --overwrite。即使如此,阿正老師還是建議先複製一份影片再交給 AI 處理。
  • 專案很新:主要由作者一人維護,GitHub 在 2026-11-21 已有約 8,900 顆星,熱度很高,但後續維護狀況還需要時間觀察。

七、常見問題

Q:ffmpeg-skill 要錢嗎?
技能包本身免費開源。用 Claude 帳號登入 Claude Code,需要有包含 Claude Code 的付費方案。也可以透過 Anthropic Console 帳號按 API 用量付費。

Q:可以用中文下指令嗎?
可以用中文跟 Claude Code 對話。作者公布的測試裡也包含中文提示詞。實際效果請看第五章的實測。

Q:Windows 能用嗎?
可以。官方在 Windows、macOS、Linux 上都有自動測試。Windows 要注意 Python 指令可能是 python 而不是 python3。

Q:影片會被上傳嗎?
ffmpeg-skill 在你的電腦上用 FFmpeg 處理影片。依官方流程,畫面有改動時,AI 會檢視產生的縮圖。若 Claude Code 把工具回傳的資訊或縮圖交給雲端模型分析,這些內容就可能離開你的電腦。影片有敏感畫面時,可以先用不含這些畫面的副本。

Q:可以在 Claude 網頁版或 Claude Desktop 的聊天裡直接用嗎?
官方列出的安裝方式是 Claude Code、Cursor、Codex、Gemini CLI,以及 MCP 伺服器。官方沒有說明能不能上傳成 Skill 給網頁版使用。這套工具要在你的電腦上執行 Python 和 FFmpeg,建議照官方列出的方式安裝。

Q:怎麼移除?
在終端機輸入 npx ffmpeg-skill --uninstall。


八、阿正老師的總結

ffmpeg-skill 不是要取代剪輯軟體,它把「剪片」變成一件可以用說的事,而且每一步都留下可以核對的數字。阿正老師會建議,同一支影片要轉成好幾個平台版本的時候,最值得試試看,用內建範本一句話就能處理。

已經在用 Claude Code,常要把影片轉成 Reels、Shorts

→ ffmpeg-skill。用內建的平台範本,一句話就能裁比例、調音量、檢查規格。

想用 AI 做動畫片頭、文字動畫

→ Claude + Remotion。它是用程式碼生成動畫,請看Claude + Remotion 教學。

完全不想碰終端機,只想自己動手剪

→ 一般剪輯軟體。Shotcut、Kdenlive 這類有時間軸的軟體,操作看得到、摸得到。

想看看 AI 用 Skill 處理影片的其他玩法,也可以參考讓 Claude 幫你看完 YouTube 影片的 claude-video,以及obsidian-skills 教學。


用說的剪片,剪完還會自己檢查

ffmpeg-skill 讓 Claude Code 用你電腦上的 FFmpeg 剪片、轉直式、上字幕,剪完再把數字量給你看。它還在快速改版,指令和功能請以官方 GitHub 的 README 為準。你會想讓 AI 幫你剪哪一種影片呢?

歡迎在下面留言跟阿正老師分享!

留下回覆

請輸入你的評論!
請在這裡輸入你的名字