裝完之後 →加入 奇點研究所 × D11
CLAUDE CODE · 五個開源工具實裝手冊

五個
Claude Code 開源工具

中文圈幾乎沒人在講 但裝完當天就能用
每個工具都寫五個區塊:解決什麼問題、安裝指令、第一次怎麼跑、真實成本、什麼情況不要用。最後那一段通常比前面四段更省你時間。五個工具彼此獨立,可以只挑一個裝。
5
個 · 獨立工具
·
2
個 · 完全免費
·
3
種 · 組合用法
傑森所長 @jasonxtsai
這裡分享的東西只有一種:我自己真的裝過、跑過、踩過坑的 AI 工具與工作流。不寫沒驗證過的功能,不抄英文貼文的數字,遇到要花錢的地方會直接寫出來要花多少。
這份手冊怎麼用

建議的閱讀順序
不要全部一次裝

先做這件事
先看每個工具的「它解決什麼問題」,挑出跟你現在痛點對得上的那一兩個,再回頭看安裝。全部一次裝完的結果通常是全部都沒在用。
三個共同前提

這五個工具有三個共通的環境需求,先確認完再往下走,可以省掉一半的錯誤訊息。

你要有 Claude Code。其中三個工具(scroll-world、agency-agents、cognee)是掛在 Claude Code 上的擴充
確認 Node 與 Python 版本。OmniRoute 需要較新的 Node,cognee 需要 Python
認識三個資料夾。Claude Code 的擴充都放在使用者家目錄底下
先跑這兩行看版本
node -v
python3 --version
Node 版本太舊的話,建議用 nvm 管理,不要直接覆蓋系統的 Node。
記住這三個路徑,後面會一直出現
~/.claude/agents/     放 subagent 角色定義
~/.claude/skills/     放 skill
~/.claude/plugins/    放 plugin
在 Windows 上對應到 C:\Users\你的帳號\.claude\。
五個工具

展開任一個
安裝到成本全寫完

01scroll-world · 把品牌變成可以捲動穿越的 3D 世界要付費
它解決什麼問題:你看過 Apple 產品頁那種效果嗎。滑鼠往下捲,鏡頭就往前飛,穿過一個場景進到下一個場景,中間完全沒有剪接痕跡。這種頁面過去要一組 3D 動態設計團隊做,報價六位數起跳。scroll-world 把整套流程包成一個 skill:訪談你的品牌 → 生成場景圖 → 生成鏡頭飛行影片 → 把捲動位置對應到影片時間軸 → 輸出可以直接放進任何網站的前端程式碼。輸出是框架無關的。
安裝
最快:skills CLI 一行裝好
npx skills add oso95/scroll-world
或手動控制檔案位置
git clone https://github.com/oso95/scroll-world
cp -R scroll-world/skills/scroll-world ~/.claude/skills/
Codex 使用者路徑換成 ~/.codex/skills/ 即可。
依賴:這裡是重點

skill 本體是免費的,但它需要外部服務生成畫面。裝之前先確認這三樣:

  • 影片生成後端(二選一):Monid CLI 是預設後端,按每支影片以美金計費。或者用 Higgsfield CLI,需要先登入並儲值 credits
  • 影格處理工具:ffmpeg 與 ffprobe,用來抽影格、接縫、編碼,這個是免費的
  • Python 與 Pillow:處理手機直式畫布跟去背用
確認依賴
higgsfield auth login

ffmpeg -version
ffprobe -version

pip install Pillow
沒裝 ffmpeg 的話,macOS 用 brew install ffmpeg,Windows 到 ffmpeg 官網下載。
第一次怎麼跑
在 Claude Code 裡直接說
幫我做一個 scroll-through 的 3D 世界落地頁

接下來 Claude 會開始訪談你。這一段不要敷衍,它問的東西直接決定輸出品質。準備好這四個答案:

品牌是什麼,賣什麼——一句話講完
視覺方向——等距黏土泥塑風?超寫實建築攝影風?賽博龐克?這一句話的差異會讓整組場景長得完全不同
場景順序——建議四到六個。例如飲料品牌:農場 → 製作廚房 → 門市 → 外送 → 顧客手上
每個場景要傳達什麼訊息——會變成疊在畫面上的文案
⚠️ 真實成本:這是整份手冊裡唯一要花錢的工具。一組六場景的完整輸出,上游大約需要十幾次付費生成。每次生成的單價依你選的後端與模型而定,官方 repo 的 README 有寫明計費方式。建議先跑三場景的縮小版測試,確認風格對了再跑完整版。想先看效果再決定要不要花錢,repo 裡有兩個現成 demo 可以直接看。
什麼情況不要用
  • 你的頁面主要目的是轉換而不是展示。這種頁面載入重、行動網路上體驗會打折
  • 你需要頁面內容常常更新。改一個場景等於重新生成一段影片
  • 你只想要一般的捲動動畫。那用 GSAP ScrollTrigger 就好,免費而且輕很多
02OmniRoute · 額度滿了自動跳下一家本體免費
它解決什麼問題:你正在跑一個很長的 Claude Code 任務,跑到一半跳出額度限制。任務中斷,上下文散掉,你要重來。

OmniRoute 是一個跑在你自己電腦上的 AI 閘道器,在你的工具跟各家 AI 供應商中間開一個 OpenAI 相容的 endpoint。核心機制是四層降級:訂閱額度 → API Key → 便宜模型 → 免費模型。前面那層滿了,毫秒內切到下一層,你的任務不會斷。
安裝
npm 全域安裝並啟動
npm install -g omniroute

omniroute
啟動後 API 跟儀表板會同時起來,都在 port 20128。儀表板網址:http://localhost:20128/dashboard
偏好容器化部署
docker pull diegosouzapw/omniroute
第一次怎麼跑
接上供應商。儀表板 → Providers。已有的訂閱走 OAuth 登入,有 API Key 的直接貼 Key。建議至少掛三層:一個付費主力、一個便宜備援、一個免費墊底
把工具指過去。在你的 IDE 或 CLI 裡把 base URL 改成下面那行,API Key 欄位隨便填一個字串就行,本機不驗證
設定降級順序。儀表板 → Combos,把供應商從最好的排到最便宜的
(選用)接成 MCP。讓 Claude Code 直接呼叫 OmniRoute 的工具集
base URL
http://localhost:20128/v1
接成 MCP
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
幾個實用細節
  • 儀表板會顯示每個模型剩餘的免費額度,這比自己記各家的重置時間實際得多
  • 內建 token 壓縮,透明作用在每個請求上,不需要改客戶端。程式碼區塊、URL、JSON 會被保護不動
  • 有內建的 log 儀表板,request、proxy、audit、console 四個分頁,debug 的時候很好用
⚠️ 真實成本:OmniRoute 本體免費開源,但要注意兩件事。第一,免費層的額度數字會變,各家供應商隨時可能調整或關閉免費方案,repo 裡的 docs/reference/FREE_TIERS.md 有維護一份現況表,看那份比看任何二手文章準。第二,掛上付費 API Key 之後就是真的在花錢,儀表板有預算控制跟成本追蹤,設定好上限再開始跑。
什麼情況不要用
  • 你只用一個供應商而且從來沒撞到額度。那多這一層只是多一個故障點
  • 你的工作流對延遲極度敏感。中間多一跳就是多一點延遲
  • 你在公司環境且有資安規範。這東西會經手你所有的 API Key,先問過再裝
03voicebox · 語音克隆、聽寫、TTS,全部跑在自己電腦上完全免費
它解決什麼問題:做 podcast、做短影音口播、或需要大量語音素材的人,過去只有兩個選擇:付月費給雲端服務,或接受品質差一截的本機方案。

voicebox 是本機優先的語音工作站。輸出端:7 個 TTS 引擎、23 種語言,零樣本克隆,幾秒鐘的參考音檔就能建出一個聲音檔案。輸入端:全域聽寫,在任何應用程式的任何輸入框裡按住熱鍵講話,放開之後逐字稿貼進游標所在位置。中間層:內建本機 LLM 潤稿。整個流程沒有一個位元組離開你的電腦。
安裝

一般使用者直接下載打包好的應用程式(voicebox.sh/download)。macOS 分 Apple Silicon 跟 Intel 兩個版本,Windows 是 MSI 安裝檔,有 NVIDIA 顯卡會自動設定 CUDA。

Linux 需要從原始碼建置
git clone https://github.com/jamiepine/voicebox.git
cd voicebox
just setup
just dev

# 沒裝 just 的話
brew install just
第一次怎麼跑
克隆你自己的聲音。準備一段 5 到 30 秒的乾淨錄音(沒有背景音樂、沒有環境噪音、沒有其他人講話)。錄音品質決定克隆品質,這件事沒有捷徑——用手機貼近嘴巴在安靜房間裡錄,效果會比用爛麥克風在有回音的空間錄好很多
設定全域聽寫。Settings → Dictation,開啟 Global Hotkey。macOS 預設是 Option + Space,需要授予「輔助使用」跟「輸入監控」兩個權限。Whisper 模型建議選 Turbo,速度跟準確度的平衡點最好
接上 Claude Code。REST API 在 http://localhost:17493,完整 API 文件在 /docs
用 curl 測一下生成
curl -X POST http://localhost:17493/generate \
  -H "Content-Type: application/json" \
  -d '{"text": "測試一下這個聲音", "profile_id": "你的profile_id", "language": "zh"}'
列出你所有的聲音檔案
curl http://localhost:17493/profiles
幾個實用細節
  • 多段參考音檔可以提升克隆品質。不要只丟一段,丟三段不同語氣的效果更好
  • Captures 分頁會保留每一次聽寫的原始音檔跟逐字稿,可以重跑不同大小的 Whisper 模型比較,也可以把任何一段 capture 直接升級成參考樣本
  • Voice Personality:可以幫每個聲音檔案寫一段人設描述,本機 LLM 會依照那個人設改寫你輸入的文字再唸出來
  • Apple Silicon 走 MLX 後端,推論速度比 PyTorch 快好幾倍
真實成本
零。模型下載完之後完全離線,沒有訂閱、沒有按字計費、沒有生成次數上限。唯一的成本是硬碟空間跟第一次下載模型的時間。
⚠️ 什麼情況不要用:你要克隆的不是自己的聲音——用別人的聲音做內容涉及肖像權跟聲音權,這是法律問題不是技術問題。另外,電腦很舊而且沒有獨立顯卡的話,純 CPU 推論會慢到不實用;需要即時串流語音的也不行,目前的架構是生成完再播放。
04cognee · 給 agent 一份關掉視窗也不會消失的記憶吃 token
它解決什麼問題:每次開新的 Claude Code session,你都要重新解釋一次專案結構、重新講一次你的偏好、重新貼一次上次的決策。

cognee 是一個記憶層,把你的文件、對話、決策紀錄,透過 ECL pipeline(Extract, Cognify, Load)處理成知識圖譜,存在你自己的機器上。跟一般向量檢索的差別在於它同時保留關聯性:純向量檢索能回答「這份文件講什麼」,知識圖譜能回答「哪個決定影響了哪個模組」這種需要跨越多個節點的問題。
安裝
Python 套件,一行裝好
pip install cognee
本機儲存用的是 SQLite、LanceDB、Kuzu 三個輕量方案,不需要另外架資料庫。要上規模的時候可以換成 Neo4j、Qdrant、PostgreSQL。
第一次怎麼跑

cognee 的核心是四個動作:記住、回想、忘記、改善。

最小可跑範例 · 存成 test_cognee.py
import cognee
import asyncio

async def main():
    # 第一步:把資料丟進去
    await cognee.add("這個專案用 Next.js 14 App Router,狀態管理用 Zustand,不用 Redux。")

    # 第二步:建立知識圖譜
    await cognee.cognify()

    # 第三步:查詢
    results = await cognee.search("這個專案的狀態管理用什麼")

    for result in results:
        print(result)

if __name__ == '__main__':
    asyncio.run(main())
也可以直接用 CLI,不寫程式
cognee-cli add "你要記住的內容"
cognee-cli cognify
cognee-cli search "你的問題"
接上 Claude Code(對內容創作者最實用的部分)

cognee 有官方的 Claude Code 整合,會掛上生命週期 hook,在 session 開始、工具呼叫後、送出提示前、壓縮上下文前、session 結束時自動記憶跟回想,不需要你手動下指令。

一個重要的預設行為:cognee 會依照不同的 MCP 客戶端自動建立分開的資料集。Claude Code 的記憶存在 claude_code_memory,Cursor 的存在 cursor_vscode_memory,彼此不會互相污染。
希望所有工具共用同一份記憶,關掉隔離
export COGNEE_MCP_AGENT_SCOPED=false
幾個實用細節
  • cognify() 會呼叫 LLM 做實體與關係抽取,這一步是有 token 成本的。丟一整個資料夾進去之前先估算一下
  • 記憶會隨著使用變準。當 agent 對某個回答給出評價,那個回饋會更新圖譜裡的邊權重
  • 支援自訂 ontology。如果你的領域有固定的概念結構(例如「選題 → 腳本 → 素材 → 成品」),可以定義成 schema 讓抽取更準
  • 依賴很重。40 多個核心套件,第一次安裝會跑一陣子,建議開獨立的虛擬環境
⚠️ 真實成本:自架版本本身免費開源,實際成本來自兩個地方。第一,cognify() 的 LLM 呼叫——這個可以用本機模型(Ollama)跑掉,完全免費,代價是抽取品質會差一些。第二,雲端託管版本的計價方式在官方定價頁。
什麼情況不要用
  • 你的專案很小、上下文塞得進單一 session。那多這一層是過度工程
  • 你不想處理 Python 環境問題。這是五個工具裡安裝最麻煩的一個
  • 你需要記憶內容完全可預測。知識圖譜的抽取結果會隨模型而變,不是確定性的
05agency-agents · 一整間 AI 公司的專家角色完全免費
它解決什麼問題:你請 Claude「寫一個 React 元件」,它會寫。但它是用一個通才的視角在寫,不會主動幫你檢查無障礙、不會提醒你 Core Web Vitals、不會質疑你的元件拆分方式。

agency-agents 是一批寫好的專家角色定義,每一個都是一份 Markdown,包含身分設定、工作流程、可交付成果、成功指標、溝通風格。目前超過 230 個角色,橫跨二十多個部門。對做內容的人來說行銷部門特別有用。
安裝:三種方式
方式一 · 桌面應用(最簡單,會自動更新)
brew install --cask msitarzewski/agency-agents/agency-agents
方式二 · 命令列選擇性安裝(推薦)
git clone https://github.com/msitarzewski/agency-agents
cd agency-agents

# 看看有哪些部門跟各自的角色數量
./scripts/install.sh --list teams

# 只裝你要的部門,這是最重要的一步
./scripts/install.sh --tool claude-code --division marketing,design

# 或者精準到單一角色
./scripts/install.sh --tool cursor --agent instagram-curator,seo-specialist

# 不確定會裝到哪些東西,先空跑一次
./scripts/install.sh --tool claude-code --division marketing --dry-run
方式三 · 手動複製
cp marketing/*.md ~/.claude/agents/
⚠️ 為什麼強烈建議「不要全裝」(這是我踩過的坑):230 多個角色全部倒進 ~/.claude/agents/,每次啟動 Claude Code 都要載入全部的角色描述。結果是啟動變慢、上下文被佔掉一大塊、而且 Claude 在挑選角色時會猶豫,因為選項太多太相似。

實際上你用得到的大概五到十個。先挑一兩個部門,用一個月,看哪些真的有在叫,再決定要不要擴充。

另外有一個已知限制:某些工具的執行環境對角色數量有上限,超過會靜默丟棄後面的。安裝腳本在你的選擇會超過限制時會跳警告。
第一次怎麼跑
在 Claude Code 裡直接點名
啟動 Instagram Curator 模式,幫我看這組輪播的資訊結構有沒有問題
或用 subagent 的方式呼叫
用 SEO Specialist 這個 agent,分析這篇文章的關鍵字佈局
內容創作者值得先看的幾個角色
角色檔案位置適合什麼場景
Instagram Curatormarketing/marketing-instagram-curator.md視覺敘事、貼文節奏規劃
Carousel Growth Enginemarketing/marketing-carousel-growth-engine.md輪播貼文的結構與鉤子
Xiaohongshu Specialistmarketing/marketing-xiaohongshu-specialist.md小紅書的內容邏輯
SEO Specialistmarketing/marketing-seo-specialist.md長文的關鍵字與結構
Content Creatormarketing/marketing-content-creator.md多平台內容排程
Reality Checkertesting/testing-reality-checker.md交付前的事實查核與品質把關
Whimsy Injectordesign/design-whimsy-injector.md幫太嚴肅的內容加人味
最後那個 Reality Checker 我特別推薦。它的設定是預設要找出三到五個問題並且要求證據,對於避免自己的內容出現沒查證的數字很有效。
給其他工具用
轉換成十幾種工具的格式
./scripts/convert.sh

# 然後互動式安裝,它會自動偵測你裝了哪些工具
./scripts/install.sh
什麼情況不要用
  • 你已經有一套自己寫的 prompt 模板而且用得順手。那這些角色只會干擾
  • 你的任務很單純。叫一個「資深後端架構師」來幫你改一行 CSS 是浪費
  • 你介意角色定義的語氣。有些角色寫得很有個性,會影響輸出風格
五個都講完了

工具的價值來自你真的在用
不是裝在電腦裡

挑一個,用滿一個月,再看下一個。想把工具接成真的在產出的工作流,我在 Skool 帶你做、每週更新。

加入 奇點研究所 × D11 →
組合起來用

單獨裝已經有用
組合起來更明顯

COMBO 01
內容產出流水線
agency-agents+cognee

把 cognee 掛上 Claude Code,讓它記住你的品牌調性、禁用句型、過往選題。再裝 agency-agents 的行銷部門角色。結果是:你叫 Instagram Curator 幫你想選題時,它同時知道你的品牌規範跟你上個月發過什麼,不會重複也不會走鐘。

COMBO 02
長任務不中斷
OmniRoute+agency-agents

跑多角色協作的長任務時,最怕的是中途撞額度。OmniRoute 掛在前面,額度滿了自動換供應商,整條流程不會斷在一半。

COMBO 03
語音轉內容
voicebox+cognee

用 voicebox 的全域聽寫,把你的口播、會議、隨手想法都轉成文字。轉出來的逐字稿餵給 cognee 建成知識圖譜。一個月之後,你等於有一份自己講過的所有話的可查詢資料庫。寫貼文的時候問它「我之前對這個主題講過什麼」,答案就出來了。

安裝檢查清單

照這個順序
一次裝完不會亂

完成度0 / 0
幾件我想先講清楚的事

裝之前
先知道這四件

開源不等於免費。這五個工具的授權都是免費的,但 scroll-world 要付生成費用、cognee 的知識圖譜建立會消耗 LLM token、OmniRoute 掛上付費 Key 之後就在花錢。免費的只有 voicebox 跟 agency-agents。
星數不是品質指標。這幾個 repo 的星數都不低,但星數反映的是曝光跟話題度。裝之前看 issue 區跟最近的 commit 頻率,比看星數有用。
開源專案會變。這份手冊裡的指令、路徑、依賴,都是撰寫當下對照官方 README 確認過的。如果你照著跑出現錯誤,第一件事是回去看該 repo 的 README,不是懷疑自己。
不要一次全裝。拿到一份工具清單的直覺反應是全部裝起來。但工具的價值來自於你真的在用,不是來自於它裝在你電腦裡。挑一個,用滿一個月,再看下一個。
下一步

工具裝好了,接下來換我陪你把它變成產能

這五個裝起來只是第一步。要把它接成一條真的在幫你產出、幫你賺錢的工作流,那不該你一個人慢慢摸。
想用 AI + 自媒體建立個人品牌、創造收入的人
工具裝得起來、卻不知道怎麼接成系統的你
收藏了一堆工具清單,卻從來沒真的用滿一個月的人
進來你會拿到
AI + 自媒體的完整變現工作流
實測過、真的能用的工具教學與自動化流程,每週更新
一群跟你一樣、正在用 AI 翻身的人
加入 奇點研究所 × D11 →
裝完之後,回貼文底下留言告訴我你挑了哪一個