台灣團隊怎麼試 OpenClaude：本機先跑通，雲端金鑰再接，資料邊界自己守

OpenClaude 是什麼：一套終端機工作流，後面的模型自己換

Claude Code 是在終端機裡幫你改程式的助理：你下指令，它自己讀檔、搜尋、動手改。OpenClaude 沿用這套手感，但背後的模型換成你自己選。它不是模型，也不是雲端服務，而是要裝在自己電腦上的命令列工具（CLI，在黑色視窗打指令的那種程式）。

好處是不必被綁在同一家 AI 公司：今天用 OpenAI、明天換 Gemini，或跑在公司自己的機器上，操作都一樣。官方文件寫能接 40 個以上後端，含 Ollama、LM Studio 等本機模型，也支援自訂的 OpenAI 相容端點（規格跟 OpenAI 一樣就能接）。

依 GitHub API 2026 年 9 月 6 日資料，Gitlawb/openclaude 約 32，752 顆星、9，066 次 fork；npm 套件 @gitlawb/openclaude 最新版 0.30.0。名稱有 Claude，但跟 Anthropic 沒關係，官方明講是獨立社群專案、未經背書。

它跟 Claude Code、OpenCode、Pi Agent 差在哪

• Claude Code：Anthropic 官方，模型綁自家生態，整合度最高。
• OpenCode：另一套開源寫程式助理，獨立實作，不是同一份程式改的。
• Pi Agent：走極簡路線，只給少數工具，哲學跟 OpenClaude 相反。
• OpenClaude：README 直言從 Claude Code 程式碼改出來再接多後端，要那套斜線指令與工具迴圈手感，但不想只綁一家；這既是賣點也是風險。

名稱容易撞：openclaudia.com 是另一個產品，查資料請認明 Gitlawb 與 npm 上的套件名。

不寫程式的人該不該碰？先看三個現實條件

它終究是終端機工具，安裝要下指令，也要 Node.js 環境。README 要求 Node 22 以上，安裝文件卻寫 20 以上，兩份文件打架。設定檔預設在 ~/.openclaude，刻意不讀 Claude Code 的 ~/.claude，別把舊登入憑證整包複製過去。授權條款寫明底層衍生程式仍屬 Anthropic 著作權，本專案未取得 Anthropic 授權散布其專有原始碼，這段只轉述，不做法律結論，也不建議當公司正式產線預設工具。

判斷很簡單：只想「用 AI 幫忙寫點東西」，現成的雲端服務就夠。若你是團隊裡負責技術的人，想要手感固定、模型能自己換，甚至接公司內部的自架模型，值得花一個下午試；完全不想碰指令列，它就不是為你設計的。

三條後端路線：本機 Ollama、自訂相容端點、雲端大廠金鑰

OpenClaude 最值錢的是把「用哪顆大腦」變成隨時能換的選項。官方列出超過 40 個後端（來源：openclaude.gitlawb.com，2026 年），台灣團隊真正要選的只有三條：自己電腦、公司自架伺服器、別人的雲。操作幾乎一樣，差別在資料往哪裡走。

第一條：本機 Ollama，資料不離開你的電腦

先裝好 Ollama、拉下模型，再讓 OpenClaude 指過去；它走 Ollama 原生對話介面，不是假裝成 OpenAI，填本機位址加模型名稱即可。

常見的坑：上下文預設要開 32768，否則讀大專案會像看不到後半段程式碼，可用 OPENCLAUDE_OLLAMA_NUM_CTX 覆蓋，往下調前先確認顯示記憶體撐得住。好處是程式碼一行都沒離開電腦，對要求資料不出國的客戶是唯一能直接回答的路；代價是速度與品質看顯卡，筆電通常慢到讓人放棄。

第二、三條：自架相容端點與雲端金鑰，差在資料邊界

第二條是自訂 OpenAI 相容端點：對方介面做得跟 OpenAI 一樣，OpenClaude 就當它是 OpenAI。LM Studio、公司用 vLLM 架的服務、私有閘道都算，設一組網址加金鑰即可。第三條直接填雲端大廠金鑰：OpenAI、Gemini、Grok、OpenRouter、GitHub Models，以及 Bedrock、Vertex、Azure；最快能開始改程式，但資料送到對方機房，金鑰要照資安規範保管。

三條路共用設定目錄 ~/.openclaude，不讀另一套工具的 ~/.claude，別把舊憑證整包複製過來。環境變數捷徑沿用舊名，看到 CLAUDE_CODE_USE_OPENAI=1 不用懷疑。設定怪就先跑檢查指令，看目前設定與連線狀態。

猶豫的話：先在本機 Ollama 跑一次小專案，確認手感與指令背得起來，再接公司既有的雲端金鑰。不採用也只花一個下午，沒送出任何一行程式碼。

實機走一遍：安裝、下任務、看 diff

前一章談模型放哪裡，這章直接把 OpenClaude 裝起來跑個小任務，看它做了什麼、錢花在哪、出事怎麼退回。macOS、Linux、Windows 都適用，差別只在終端機長相。

安裝，還有那個會讓你卡住的 Node 版本

OpenClaude 是用 Node.js 跑的終端機工具（Node.js 是讓這類工具在你電腦執行的引擎），所以要先裝 Node。這裡有坑：GitHub README 寫需 Node 22 以上，官網的安裝文件卻寫「Node 20 或更新」，兩份打架。以 README 與實際安裝回報為準，先裝 22 以上最保險。

安裝只有一行，在終端機貼上：

npm install -g @gitlawb/openclaude@latest

裝完先確認版本與環境：

• openclaude --version：確認真的裝起來、版本對不對。
• /doctor：進到工具後輸入，逐項檢查還缺什麼。最常見是少 ripgrep（指令 rg），它負責翻遍整個專案找檔案，缺了就照你的系統方式補裝。

存好模型設定，下第一個任務，看懂它做了什麼

進到要改的專案資料夾，輸入 openclaude 啟動。先用 /provider 把模型設定存成一份設定檔（官方叫 profile），例如本機的 Ollama，或公司自己的相容端點。設定檔預設放在 ~/.openclaude，跟 Claude Code 用的資料夾分開，千萬不要把另一套的憑證整包複製過來。

接著用白話下任務，例如請它讀某個檔案、修掉一個錯誤。畫面會一段一段串流輸出：先說打算怎麼做，再顯示呼叫了哪些工具（讀檔、搜尋、執行指令），每動一次檔案就給你看一次 diff。敏感的動作，例如刪檔或對外連線，會先停下來問你，這個「先問再動」就是權限閘門，不確定就按拒絕。

收尾三個指令：/diff 看這次改了哪些行、/rewind 退回修改前的狀態、/cost 看燒掉多少用量。接自動化用 --print，不進互動畫面、直接印出結果；要跑久一點用 --bg 丟到背景，再用 ps 看它還在不在、logs 看它做了什麼、kill 把它停掉。背景工作是這台電腦上的子行程，關掉終端機它就跟著走，不是裝在伺服器上永遠活著的服務。

替代方案有限公司觀點：先本機跑通，雲端金鑰再接，資料邊界自己守

台灣中小企業最常問：不想被綁一家雲端、程式不想出國、團隊已會 Claude Code 指令。OpenClaude 這款終端機 coding agent CLI 對上第三句，也給前兩句一條路：官方文件（2026 年 9 月）寫可接 40 個以上後端（OpenAI、Gemini、Ollama、LM Studio、OpenRouter），也支援自訂 OpenAI 相容端點。但能換不等於該馬上換，先在本機跑通，再接雲端金鑰，資料邊界第一天自己畫。

先在本機跑通，再談雲端金鑰

本機路線是模型裝自己電腦、用 Ollama 提供服務，程式碼與提示不出門。設定本機位址 OPENAI_BASE_URL=http://localhost:11434/v1 加模型名稱；Ollama 預設要 32768 的 context，記憶體不夠用 OPENCLAUDE_OLLAMA_NUM_CTX 調小。好處是免帳號、程式碼留在家，也能先確認團隊吃不吃得下這套手感。

兩個坑：設定目錄預設 ~/.openclaude，刻意不讀 Claude Code 的 ~/.claude，README 明講別整包複製憑證；環境變數捷徑沿用舊名 CLAUDE_CODE_USE_OPENAI=1，很容易設錯家，設定完用 /doctor 檢查。

「預設閘道」也別以為非得走廠商雲：合作名單有 GitLawb、小米 MiMo、Atlas Cloud、Novita，預設閘道之一是 Gitlawb Opengateway，這些是付費轉接服務，請求經過第三方；自架本機 Ollama 則資料不出門、要自己顧機器。兩條路可並存，重點是你知道現在走哪條。金鑰一律放本機環境變數，不進專案檔、不進 git。

我們的公司觀點：可以試，不要當預設

OpenClaude 現階段適合個人或小組先試，不適合當公司正式產線預設。三個現實：GitHub 專案 LICENSE 自述底層衍生程式仍屬 Anthropic 著作權、本專案沒取得 Anthropic 授權散布其專有原始碼，使用者與貢獻者應自行評估法律立場（2026 年 9 月讀取）；官方文件打架（README 要 Node 22 以上，安裝文件寫 Node 20 或更新）；台灣繁中獨立評測沒找到。優點是安裝路徑清楚、Windows 有寫、本機 Ollama 有專段、設定目錄跟 Claude Code 切開。LICENSE 我們只轉述，不做商用結論。

給台灣中小企業的三步路：一、找不碰正式機密的開發機，用本機 Ollama 讀開源 repo，跑通 /provider、/diff、/cost；二、挑不含客戶資料的內部小專案，接公司現有雲端金鑰，比較本機與雲端的品質和成本；三、才討論要不要擴大。資料邊界是「哪類程式碼可送出去、哪類永遠留本機」的白紙黑字，先寫下來，工具換誰都不怕。

深入探討：試用時容易踩到的坑與成熟度訊號

前面幾章談的是 OpenClaude 能做什麼，這一章換個角度，把它還沒做好的地方攤開來講。對一般人來說，決定要不要花時間試一套工具，看的不是首頁寫得多漂亮，而是「踩到坑的時候有沒有人先提醒你」。

試用前先摸清楚的坑

第一個坑是文件自己打架。README 要求 Node 22 以上，安裝文件卻寫 Node 20 或更新，兩份都掛在官網上，照哪一份都可能出事。實務上以 README 與套件本身的 engines 欄位為準。Node 是跑這類工具的執行環境，版本不對，連安裝都會失敗。

第二個坑是環境變數名稱。它到今天還延用舊專案的名字，CLAUDE_CODE_USE_OPENAI=1，光看字面會以為自己裝的是另一套工具，網路上查到的教學也常貼成那套的設定。它預設的設定目錄是 ~/.openclaude，不會去讀 Claude Code 的 ~/.claude，把舊憑證整包複製過去，輕則失效，重則讓不該外流的金鑰住進新設定檔。

第三個坑是連線預設值。預設與推薦的閘道之一是合作方的雲端服務 Gitlawb Opengateway。閘道是幫你轉送模型請求的中間服務，對「程式不要出國」的團隊來說，這條路必須主動改掉，換成本機 Ollama 或公司自架端點，否則等於默默把程式碼送到別人家。

成熟度訊號：星數以外的觀察

GitHub 專案頁在 2026-09-06 的數字約 32，752 星、9，066 個 fork。星數代表關注，fork 代表有人整包搬回去改。這個比例偏高，通常意味著不少人拿去改裝或重新包裝，品質自然參差，jscpd 掃到的大量重複程式碼行也是同一個方向的訊號。這些都算成熟度指標，不是品質保證。

授權得單獨講。GitHub API 的 license 欄位是 NOASSERTION，實際打開 LICENSE 檔，裡頭寫的是：底層衍生程式仍屬 Anthropic 著作權，本專案沒有 Anthropic 授權散布其專有原始碼，使用者與貢獻者應自行評估法律立場。我們只轉述專案自己寫的句子，不做法律判斷，也不建議把它當公司正式產線的預設工具。

和上週寫的 Pi Agent、Hermes 系列相比，三者不是同一題。Pi 走極簡四工具，哲學是能少就不要多；Hermes 是給團隊用的 Bot，重點在同事與沙箱；OpenClaude 唯一的鉤子是「留下 Claude Code 那套指令手感，後面的模型自己換」。如果你要的正是這個，它值得花一個下午在本機試；如果你要的是能上正式產線的穩定度，可以先等等。

常見問題 FAQ

Q：裝了 OpenClaude，公司程式碼會不會自己傳出去？
看你在後面接哪個模型。如果先用本機的 Ollama，走的是自己電腦上的 http://localhost:11434/v1，資料就留在機器裡，不會出門；等你覺得順了，再決定要不要接既有的雲端金鑰，這時候資料才會送到那家雲。文章建議的落地順序就是「先本機跑通、雲端金鑰再接」，金鑰跟資料邊界自己講清楚。另外它的設定目錄預設是 ~/.openclaude，不會去讀 Claude Code 的 ~/.claude，官方也提醒不要整包複製 Claude Code 的憑證過來。

Q：它跟我平常用的聊天 AI 差在哪？
平常聊天是你打字、它回話；OpenClaude 是在終端機裡直接動手的 coding agent。你在專案資料夾打 openclaude，它就照一個工作迴圈跑：讀你的 repo、用 bash、grep、檔案工具去改程式，過程會串流顯示工具呼叫跟 diff，比較敏感的操作會先停下來等你核准。它也能用 --print 跑非互動任務，或在背景開本機子行程。要換模型就下 /provider 存一組設定，官方說可接 40 個以上後端，也有自訂的 OpenAI 相容端點。

Q：可以直接拿來當公司正式工具嗎？
文章的看法是先當實驗，不要當公司正式產線的預設。原因是它的 LICENSE 自己寫明：底層衍生程式仍屬 Anthropic 著作權，本專案沒有取得 Anthropic 授權去散布那些專有原始碼，使用者和貢獻者要自己評估法律立場；它也是獨立社群專案，跟 Anthropic 無關也沒被背書。實務上要試的話，先用本機 Ollama 讀一個不敏感的 repo 熟悉手感，安裝用 npm install -g @gitlawb/openclaude@latest，Node 版本以 README 寫的 >=22 為準（安裝文件寫 20，兩份不一致）。

📩 有任何問題或需要協助，歡迎聯絡我們：[email protected]