ChatCut 智慧體外掛是公開的 npm 包 @chatcut/skill（目前是 v0.2.1），它會安裝一個名為 “chatcut” 的 Claude Code 技能，以及一個命令列工具 chatcut，可以根據一段文字 prompt 和一組素材 URL 或本地檔案路徑來建立 AI 剪輯影片。
如何安裝？
執行 npm install -g @chatcut/skill（pnpm add -g 和 yarn global add 效果相同），然後重啟 Claude Code。必須進行全域性安裝 —— 該技能會呼叫 PATH 上裸的 chatcut 二進位制檔案，所以 npx @chatcut/skill submit 是不可行的。安裝過程的 postinstall 步驟會把 SKILL.md 複製到 ~/.claude/skills/chatcut/SKILL.md，讓 Claude Code 自動識別這個技能；這個註冊步驟是盡力而為的，不會導致 npm 安裝失敗，如果之後 Claude Code 沒有識別到這個技能，執行 chatcut install 手動註冊即可。
執行它需要什麼？
chatcut CLI 需要 Node.js 18 或更高版本（package.json 中 engines.node >=18）。
這個 CLI 能做什麼？
chatcut 命令提供九個子命令：install（帶 --link 選項）、update、login、logout、pick、submit、status <jobId>、watch <jobId> 和 help。核心命令是 submit，它需要必填的 --prompt <text>、一個或多個可重複的 --asset <source:type> 標誌（type 為 audio、gif、image 或 video），以及可選的 --name <string>、--resolution <480p|720p|1080p>、--format <audio|video>、--codec <h264|mp3|prores|vp8>、--max-turns <n> 和 --model <name> 標誌。如果你手頭還沒有素材路徑，chatcut pick 會開啟一個原生檔案選擇對話方塊，並打印出 path:type 格式的行，可以直接餵給 submit --asset。
chatcut submit 是如何生成影片的？
把 prompt 和素材交給 submit，它會替你跑完整條流水線：你用自然語言描述這次剪輯，並以公開 URL 或本地絕對檔案路徑的形式提供素材 —— 兩者接受方式完全相同 —— CLI 會在本地轉檔並上傳，ChatCut 的智慧體在服務端組裝時間軸，影片在雲端渲染，最後你會拿到一個帶簽名的下載 URL。如果你沒有設定 --resolution 或 --format，CLI 會自動在你的 prompt 後追加一條匯出指令，預設匯出 1080p 影片。提交一個任務是付費操作，所以如果智慧體在提交前改動了你的措辭，它必須先停下來，把最終的 --prompt 文字展示給你確認。
需要多久，進度在哪裡看？
chatcut submit 會一直阻塞，直到任務完全完成 —— 轉檔、上傳、智慧體的編輯迴圈、雲端渲染都跑完之後才會返回 —— 期間會持續向 stderr 輸出人類可讀的進度資訊。在後臺，它每 3 秒輪詢一次任務狀態，如果任務在 40 分鐘內沒有完成，就會以超時錯誤放棄。
結果最終在哪裡？
每次 chatcut submit 執行都會建立一個新的 ChatCut 專案 —— 用 --name 命名，或者接受預設名 —— 執行結束後會在 stdout 列印一行 JSON，包含該專案的 projectId、任務的 jobId，以及渲染檔案的帶簽名 outputUrl。
需要先執行 chatcut login 嗎？
不需要 —— 如果 submit 沒有找到已儲存的 API key，它會自動開啟瀏覽器讓你登入，登入完成後繼續執行任務，所以首次 submit 之前不需要單獨一步 chatcut login。這個登入流程會開啟一個指向 ChatCut 登入頁的瀏覽器視窗；你確認後，CLI 會在後臺把結果換成一個長期有效的 API key，整個流程如果 5 分鐘內沒有完成就會超時。
這和 “Codex 外掛” 是同一個東西嗎？
就目前釋出的版本而言不是 —— @chatcut/skill 只是一個 Claude Code 技能：CLI 註冊在 ~/.claude/skills/chatcut 下，包裡沒有任何東西與 OpenAI Codex 整合。
如何安裝並登入 ChatCut 智慧體外掛？
用 npm install -g @chatcut/skill 全域性安裝外掛 —— pnpm add -g 和 yarn global add 效果相同 —— 然後重啟 Claude Code。它需要 Node.js 18 或更高版本。安裝過程還會把 SKILL.md 註冊到 ~/.claude/skills/chatcut/，讓 Claude Code 自動識別這個技能；如果這一步沒有發生（比如用了 --ignore-scripts），執行 chatcut install 手動完成註冊。必須全域性安裝 —— 在 Claude Code 裡用 npx @chatcut/skill 是不行的。
你不需要單獨的登入步驟：第一次 chatcut submit 會開啟瀏覽器進行基於 PKCE 的授權交換，如果 5 分鐘內沒有完成，流程會超時。如果想提前登入，執行 chatcut login。
另見：如何登入 ChatCut。
ChatCut 智慧體外掛能做什麼，有哪些限制？
ChatCut 智慧體外掛 —— 也就是作為 Claude Code 技能的 chatcut CLI —— 會建立一個專案、上傳你的素材、執行一次自然語言 AI 剪輯任務，並在一條命令裡返回一個帶簽名的下載 URL。chatcut submit 接受一段 prompt 加素材（URL 或本地檔案路徑）；只有當編解碼器不相容瀏覽器、影格率超過 30fps，或位元速率超過 8Mbps 時，它才會在本地轉檔影片，並把輸出限制在最長邊 1920px 以內 —— 否則會原樣上傳檔案。之後它會一直阻塞，直到 ChatCut 服務端的智慧體完成編輯和雲端渲染，期間向 stderr 輸出進度，最後向 stdout 輸出一行包含 jobId/projectId/outputUrl 的 JSON。
限制：submit 每 3 秒輪詢一次，40 分鐘後超時。chatcut status <jobId> 只檢查一次任務狀態；chatcut watch <jobId> 最多輪詢 20 分鐘。CLI 每 24 小時檢查一次是否有新版本（結果會快取），並且只會提示，從不阻塞命令執行。