ZCode 是什麼？Z.ai 開源 coding agent harness，對台灣中小企業的實際意義

ZCode 是 Z.ai 開源的 AI 程式開發工作台：讓 AI 直接讀你的專案檔案、改檔、跑指令。

桌面、瀏覽器、終端機三種介面都有，整套骨架原始碼公開在 GitHub。

ZCode 是什麼？和 Claude Code 有什麼不一樣？

ZCode 是 Z.ai 公開在 GitHub 上的 AI 程式開發工作台，桌面、瀏覽器、終端機三種介面都給了，原始碼包含桌面客戶端、後端服務、共享 UI，以及 Agent CLI 與執行時（GitHub: zai-org/ZCode）。和 Claude Code 最直接的差別在於：ZCode 把整套骨架的原始碼攤在公開儲存庫裡。

先講清楚兩個名詞。coding agent 指的是能自己拆任務、寫程式、跑測試、看到錯誤再改的 AI 程式；harness（執行骨架） 是包在模型外面那一層工程，負責給模型檔案讀寫權限、執行終端機指令、管理對話上下文、把工具呼叫的結果餵回去。模型是引擎，harness 是底盤跟方向盤。過去大家只開源引擎，這次連底盤圖紙一起給。

比較項	ZCode	Claude Code
原始碼	公開在 GitHub，含客戶端、後端、Agent 執行時	官方文件未見以開源形式公布骨架原始碼，本文未逐一查證
介面形態	Electron 桌面版、Web 瀏覽器版、終端機 TUI；Web 與 TUI 共用 zcode 指令啟動，Electron 桌面版另有獨立建置流程（pnpm dev:desktop、pnpm bundle:desktop），不經 zcode 指令啟動	以官方文件為準，本文未逐一查證
模型來源	可用 ZCODE_BUILTIN_PROVIDER_CONFIG_FILE 指定本地 Provider 設定檔，未設定時走內建設定	使用 Anthropic 的 Claude 模型，細節以官方文件為準
自架與區網存取	Web 模式預設監聽 127.0.0.1，可用 --host 0.0.0.0 開放區網，非本機位址時自動產生存取權杖	以官方文件為準
版本成熟度	撰稿時儲存庫顯示 2 個 commit、2.3k stars、573 forks	以官方文件為準，本文未逐一查證

時間脈絡先交代清楚：本文撰稿日為 2026 年 9 月 21 日，上表數字為該時點 GitHub 頁面所示。ZCode 的正式發布日期與成長曲線，README 未標明，官方也未公布。commit 數這麼少，說明它處在剛公開的階段，不代表程式碼量少——可能是大型單一提交把整個 monorepo（多個套件共用同一個儲存庫）一次推上去；這是我們的推測，儲存庫並未說明。

一套「coding agent harness」開源，為什麼值得注意？

因為難做的部分從來就不只是模型。要讓 AI 真的把一個功能寫完，得處理權限、指令執行、錯誤回饋、上下文管理、遠端工作區、介面呈現——這些工程細節以前散在各家公司內部，外人只能猜。

ZCode 的儲存庫裡直接放了 AGENTS.md、DESIGN.md、CONTEXT.md 三份文件，以及 .agents/skills 目錄（儲存庫檔案列表）。這幾個檔名對做 agent 的人來說訊息量很大：它把「agent 要遵守什麼規則」「上下文怎麼組」「技能怎麼掛」的設計決策一起公開了。

競爭重心正在往這個方向移。比模型跑分的階段大家都熟了，接下來拚的是誰的骨架能讓同樣一顆模型少犯錯、少燒 token、少需要人盯著。這是我們的判斷，README 沒有這樣寫；但 ZCode 願意把骨架開源，本身就是往這個方向下的注。

ZCode 開源了哪些東西？自己裝起來要什麼條件？

三個入口：Electron（用網頁技術包成桌面程式的框架）桌面應用（pnpm dev:desktop）、Web 與終端機工作台（pnpm dev:web）、Agent CLI（pnpm --filter @zcode/cli dev）。Agent CLI 同時也是桌面版與 Web 版共用的執行時。

環境門檻寫在 README 裡：Git、Node.js 24.14.0、pnpm 10.33.2，版本以儲存庫內的 mise.toml 為準。初始化跑 pnpm bootstrap，會安裝 workspace 依賴、準備桌面本地執行資源，再執行建置。Agent CLI 的原始碼放在 apps/zcode-cli/，跟著儲存庫一起 clone，不需要額外拉 Git submodule。

發行包的用法很直觀：

情境	指令	行為
終端機互動	zcode	無參數直接進 TUI（純文字終端機介面）
瀏覽器工作台	zcode --web	本機啟動 Web 介面，自動挑空閒埠並開瀏覽器
指定專案與埠號	zcode --web --workspace /path --port 3030 --no-open	不自動開瀏覽器
區網共用	zcode --web --host 0.0.0.0	監聽非本機位址，預設產生存取權杖

兩種模式都在本機跑，不需要 Electron。遠端功能支援 SSH（遠端登入另一台機器）與 WSL（Windows 內建的 Linux 環境）：先跑 pnpm bootstrap:with-remote 準備遠端資源，連遠端專案時資源走「本機下載後上傳」，開發態透過 SFTP（走 SSH 的檔案傳輸）傳到遠端。

ZCode 能自架嗎？資料會不會外流？

能自架，而且預設設定偏保守。Web 模式預設工作目錄為當前目錄、監聽 127.0.0.1、預設不啟用存取權杖；一旦監聽非本機位址，預設就會產生權杖，得用終端機輸出的帶權杖連結才連得進去（README 說明）。

要調整的話有三個旋鈕：--token 指定權杖、--no-token 關閉權杖驗證、環境變數 ZCODE_SERVER_AUTH_TOKEN 設定 API 與 WebSocket 驗證。應用資料寫在 ZCODE_DATA_BASE_DIR 底下的 .zcode/ 目錄。

模型走哪裡是另一回事。ZCODE_BUILTIN_PROVIDER_CONFIG_FILE 讓你指定本地的 Provider（模型供應商）設定檔，未設定時使用內建設定；內建設定實際指向哪些服務、預設會不會把程式碼送到 Z.ai 的伺服器，README 摘錄未列明，得自己讀 config/README.md 跟 .env.example 確認。在確認之前，別拿含客戶資料或營業機密的專案去試。 授權條款同理：儲存庫裡有 LICENSE、NOTICE.md、THIRD-PARTY-NOTICES.md 三個檔案，具體授權類型請以儲存庫根目錄的 LICENSE 檔案為準，商用前務必看完。

這對台灣中小企業意味著什麼？

意味著「客製化 AI 開發工具」這件事的底價正在往下掉，而你談外包時手上多了一把可以量的尺。

老闆不需要自己養 AI 工程團隊，但要知道一件事實：過去廠商報「我們幫你做一套 AI 開發助理」，你沒有參考基準，報價多少只能聽他的。現在骨架有公開版本可以對照，議價的結構就變了。這不表示成本歸零——骨架可自由取用之後，錢會集中到別的地方去。

成本項目	開源骨架出現前	開源骨架出現後
Agent 執行骨架	廠商自研或黑箱，計入報價	有公開版本可比對，議價空間變大
模型用量	綁廠商方案	可自選 Provider，但仍是持續支出
系統整合	混在總價裡	成為主要成本，也是真正的技術門檻
驗收與維運	常被略過不談	必須寫進合約的項目
資安與資料落地	少人問	中小企業最該把關的一關

實務判斷：骨架的原始碼公開可自由取用，把它接上你公司實際的流程、資料、人，才是要付錢的部分。 能不能拿去商用是另一回事，得看儲存庫裡的授權條款，見下方 Q1。廠商若把報價的大頭放在「開發 agent 框架」，你可以直接問他跟公開版本差在哪。

要找廠商導入 AI 開發，該問哪幾個問題？

四個問題問完，大致就知道對方有沒有底：骨架是自研還是基於開源、模型鎖哪家能不能換、能不能部署在你自己的機器上、驗收標準怎麼寫成可測的條件。以下逐題說明該聽到什麼答案。

第一，你們的 agent 骨架是自研還是基於開源專案？ 基於開源沒什麼好遮掩，說不清楚的才要小心。用公開骨架代表你未來換廠商的成本較低。

第二，模型鎖哪一家、能不能換？ ZCode 這類專案把 Provider 設定獨立成設定檔，意思是換模型不必重寫系統。廠商若答「只能用我們指定的」，那是綁約，價格要重談。

第三，能不能部署在我們自己的機器上？資料落在哪裡？ 資料敏感的產業（會計、醫療、法務、製造圖檔）這題不能含糊。ZCode 的 Web 模式預設只監聽本機、Provider 設定檔可自訂，是可以拿來對照的參考點。

第四，驗收標準怎麼寫？ AI 專案最容易爛尾在這裡。要求對方把「做完長什麼樣」寫成可測的條件；「導入 AI 提升效率」這種句子進不了驗收單。

想把這幾題落到自己公司的流程上，免費 AI 推薦度健檢就是幹這件事的——先把你現在的流程拆開看哪一段值得交給 AI，再談要不要花錢找人做。

現在該不該投入 ZCode？

分兩種人回答。有工程能力的團隊：現在就值得 clone 下來讀設計文件。沒有工程團隊的中小企業：不用自己裝，把它當談外包時的議價基準與判斷依據就夠了。

技術團隊或有工程能力的公司：值得現在就 clone 下來讀。 要讀的是 AGENTS.md 跟 DESIGN.md 這類設計文件——別人實戰過的 agent 工程決策，讀一遍省你幾個月摸索。當日常工具還太早，撰稿時只有 2 個 commit，穩定性沒有紀錄可查。

沒有工程團隊的中小企業：不用自己裝，但要知道它存在。 它對你的價值落在議價資訊與判斷基準這一層，別當成生產工具。談專案時能講出「現在 agent 骨架已經有開源版本」這句話，對方的報價邏輯就得換一套。

我們的立場很明確：agent 骨架的開源化會持續，而且會越來越快。中小企業該押的標的只有一個——「流程有沒有拆到 AI 接得上」。工具三個月換一輪，拆好的流程三年後還在。先把流程弄清楚，工具便宜到什麼程度都是你賺。

常見問題

Q1：ZCode 是免費的嗎？可以商用嗎？

原始碼公開在 GitHub 上，任何人都能 clone。但「公開」與「可自由商用」是兩件事，實際權利義務要看儲存庫內的 LICENSE 與 NOTICE.md 檔案，README 摘錄未列明授權類型。商用前請先讀完授權條款，必要時讓法務確認，特別是把它包進對外交付的產品時。

Q2：ZCode 和 Claude Code 哪個比較好用？

撰稿時無法給公允比較。ZCode 儲存庫只有 2 個 commit，屬剛公開階段，穩定性與實戰紀錄都還沒有；Claude Code 的功能與成熟度本文未逐一查證，以官方文件為準。最確定的差別是原始碼公開與否，以及 ZCode 可自選 Provider 設定檔。想比好不好用，等它跑幾個月再說。

Q3：沒有工程師的公司，裝得起來嗎？

環境門檻擺在那裡：Git、Node.js 24.14.0、pnpm 10.33.2，初始化與建置都是命令列操作。沒有人會用終端機的公司，硬裝的投報率很低。建議的做法是把它當議價與判斷的參考資訊，導入交給有能力的廠商，你負責問對問題、訂好驗收標準。

Q4：用 ZCode 開發，程式碼會被傳到中國伺服器嗎？

README 摘錄未列明內建 Provider 設定指向哪些服務，無法直接回答。可確認的是 Web 模式預設只監聽 127.0.0.1，Provider 設定檔可自訂。用在敏感專案前請先讀 config/README.md 與 .env.example，指定你信任的 Provider。

Q5：ZCode 是什麼時候開源的？

官方未公布正式發布日期，README 也沒有標明時間。本文撰稿日為 2026 年 9 月 21 日，當時 GitHub 頁面顯示 2.3k stars、573 forks、2 個 commit。任何關於「幾天衝到幾顆星」的說法，目前都沒有官方來源可以佐證，我們不採用。

Q6：中小企業現在該做什麼準備？

做流程盤點，不是選工具。把公司裡重複、規則明確、輸出可驗收的工作列出來，標好誰在做、一次多久、錯了誰負責。這份清單無論最後導入哪套工具都用得上，也是跟廠商談價時最有力的東西——你講得出要什麼，對方就沒辦法用模糊的套裝報價含混過去。