Codewhale：一個支援自帶模型的終端編碼代理
開源、社群驅動的代理工具。為什麼選擇 Codewhale：** **無鎖定。 ** DeepSeek、Claude、GPT、Kimi、GLM、30 多個提供者以及您自己的 vLLM、SGLang 或 Ollama，無需密鑰，透過一個運行時和一個工具集運行。
秒懂
- 它是什麼？
- 一個開源終端工具，可接入託管或本機模型，既可互動使用也可在腳本中執行，並用追加式帳本記錄艦隊工作。
- 適合誰用？
- Codewhale 是一個與模型無關的終端工具，具備感知權限的 TUI、無頭執行和可恢復的艦隊。README 未包含效能基準或生產保證，MIT 授權條款也不提供任何擔保。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫在最近一天內有新的提交。
- 用什麼語言寫的？
- 主要是 Rust（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月15日）與我們的分析，不構成法律意見。
開源專案深度解析
接受任何模型的終端代理
Codewhale 是一個開源編碼代理，在終端中執行，由你提供模型。給它一個提供者、一個模型和一個任務，它會讀取程式碼、編輯檔案、執行指令並檢查自己的工作，然後在任務完成或需要你介入時停止。該專案使用 Rust 編寫，採用 MIT 授權。它最初是 DeepSeek 的原生體驗，後來發展為社群驅動的工具，優先支援開放模型，無論是託管還是本機，都不給任何單一提供者特權。儲存庫中繼資料記錄了 40,468 個星標和 3,497 個 fork。
CodeWhale README 可核對的背景資料1：# Codewhale Codewhale is an open source coding agent for your terminal, built in Rust and improved in public with the people who use it. [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.md) · [한국어](README.ko-KR.md) · [Español](README.es-419.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Українська](README.uk.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [繁體中文](README.zh-TW.md) · [हिन्दी](README.hi.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · 。這些內容只描述 CodeWhale 已公開的介面與用途；README 沒有交代的部署細節、模型效果或權限行為，本文保留為未說明，不把推測寫成保證。
CodeWhale 核對項目1：依 README 的安裝命令處理依賴，檢查文件指定的設定檔與環境變數，再用文件中的輸入格式執行一次。請記錄終端輸出、產生的檔案、退出狀態與錯誤位置，並分開觀察首次執行和再次執行的差異。若這個專案沒有說明某個平台、資料源或權限情境，該情境就只能列為未驗證範圍，不能從相似工具推導結論。
安裝與從 deepseek-tui 遷移
README 給出了一條安裝指令：`npm install -g codewhale`。對於其他方式，它指向 docs/INSTALL.md，其中涵蓋 Cargo、Docker、Nix、Scoop、預建置封存、Android/Termux，以及為無法存取 GitHub 的使用者提供的 CNB 鏡像。README 也說明，從 `deepseek-tui` 遷移過來的使用者可以將設定和工作階段一起帶過來，細節見 docs/REBRAND.md。這些替代安裝方式的具體指令沒有寫在 README 中，需要查閱對應文件來確認。
CodeWhale README 可核對的背景資料2：[简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.md) · [한국어](README.ko-KR.md) · [Español](README.es-419.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Українська](README.uk.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [繁體中文](README.zh-TW.md) · [हिन्दी](README.hi.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md) [](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml) [](https://crates.io/crates/codewhale-cli) [](htt。這些內容只描述 CodeWhale 已公開的介面與用途；README 沒有交代的部署細節、模型效果或權限行為，本文保留為未說明，不把推測寫成保證。
CodeWhale 核對項目2：依 README 的安裝命令處理依賴，檢查文件指定的設定檔與環境變數，再用文件中的輸入格式執行一次。請記錄終端輸出、產生的檔案、退出狀態與錯誤位置，並分開觀察首次執行和再次執行的差異。若這個專案沒有說明某個平台、資料源或權限情境，該情境就只能列為未驗證範圍，不能從相似工具推導結論。
認證、TUI、無頭執行與本機網頁用戶端
提供者認證和 Codewhale 帳戶認證是分開的。`codewhale auth set --provider deepseek` 為本機執行階段設定提供者，也可以匯出 ANTHROPIC_API_KEY 等金鑰。`codewhale account login` 會開啟系統瀏覽器，在 app.codewhale.net 完成裝置流程，並把工作階段存入作業系統的憑證管理員。用 `codewhale` 啟動 TUI，用 `codewhale exec` 進行無頭執行，用 `codewhale web` 在 127.0.0.1 啟動本機瀏覽器用戶端。在 TUI 中，`/model` 同時切換提供者和模型，`/fleet` 執行一組 worker，`/restore` 復原一輪操作。當輸入框閒置時，Tab 在 Plan / Act / Operate 之間切換，Shift+Tab 在 Ask / Auto-Review / Full Access 權限模式之間切換。`!` 前綴透過正常審核路徑執行 shell 指令。帳戶子指令還提供 status、logout 和 keys，README 表示 token 和提供者金鑰值永遠不會被列印。
CodeWhale README 可核對的背景資料3： · [Español](README.es-419.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Українська](README.uk.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [繁體中文](README.zh-TW.md) · [हिन्दी](README.hi.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md) [](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml) [](https://crates.io/crates/codewhale-cli) [](https://www.npmjs.com/package/codewhale) [](https://discord.gg/37gfS3ksug) ## Install The first run helps you connect a provider or stay o。這些內容只描述 CodeWhale 已公開的介面與用途；README 沒有交代的部署細節、模型效果或權限行為，本文保留為未說明，不把推測寫成保證。
CodeWhale 核對項目3：依 README 的安裝命令處理依賴，檢查文件指定的設定檔與環境變數，再用文件中的輸入格式執行一次。請記錄終端輸出、產生的檔案、退出狀態與錯誤位置，並分開觀察首次執行和再次執行的差異。若這個專案沒有說明某個平台、資料源或權限情境，該情境就只能列為未驗證範圍，不能從相似工具推導結論。
模型與提供者涵蓋
README 列出了 DeepSeek、Claude、GPT、Kimi、GLM 以及 30 多個提供者，還有你自己的 vLLM、SGLang 或 Ollama 端點，這些無需金鑰。它們都透過同一個執行階段和同一套工具集運作。上下文限制和價格來自實際路由，未知價格顯示為未知，而不是 0。README 沒有列舉每一個提供者，也沒有比較模型行為；這些內容在 docs/PROVIDERS.md 中。
CodeWhale README 可核對的背景資料4：fr.md) · [Deutsch](README.de.md) · [繁體中文](README.zh-TW.md) · [हिन्दी](README.hi.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md) [](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml) [](https://crates.io/crates/codewhale-cli) [](https://www.npmjs.com/package/codewhale) [](https://discord.gg/37gfS3ksug) ## Install The first run helps you connect a provider or stay offline. Codewhale also supports Cargo, Docker, Nix, Scoop, prebuilt archives。這些內容只描述 CodeWhale 已公開的介面與用途；README 沒有交代的部署細節、模型效果或權限行為，本文保留為未說明，不把推測寫成保證。
CodeWhale 核對項目4：依 README 的安裝命令處理依賴，檢查文件指定的設定檔與環境變數，再用文件中的輸入格式執行一次。請記錄終端輸出、產生的檔案、退出狀態與錯誤位置，並分開觀察首次執行和再次執行的差異。若這個專案沒有說明某個平台、資料源或權限情境，該情境就只能列為未驗證範圍，不能從相似工具推導結論。
權限邊界與沙箱報告
Codewhale 在獲得允許之前是唯讀的。Plan 模式不能更改檔案，審核會攔截風險指令。當作業系統沙箱實際包住指令時，工具會明確說明：macOS 上在可用時使用 Seatbelt，Linux 上可選擇啟用 bubblewrap。儲存庫的 `constitution.json` 會編譯成即使 Full Access 也無法跳過的寫入限制。README 沒有具體說明哪些指令被視為風險指令，也沒有說明沙箱如何設定，只給出了文件連結。
CodeWhale README 可核對的背景資料5： [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md) [](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml) [](https://crates.io/crates/codewhale-cli) [](https://www.npmjs.com/package/codewhale) [](https://discord.gg/37gfS3ksug) ## Install The first run helps you connect a provider or stay offline. Codewhale also supports Cargo, Docker, Nix, Scoop, prebuilt archives。這些內容只描述 CodeWhale 已公開的介面與用途；README 沒有交代的部署細節、模型效果或權限行為，本文保留為未說明，不把推測寫成保證。
艦隊與可恢復工作
艦隊會把每一步記錄到追加式帳本中，`fleet resume` 可以讓你在上次中斷的地方繼續。TUI 中的 `/fleet` 指令會啟動一組 worker。README 沒有詳細描述 worker 編排、帳本格式或恢復行為，這些在 docs/FLEET.md 中。
CodeWhale README 可核對的背景資料6：l) [](https://crates.io/crates/codewhale-cli) [](https://www.npmjs.com/package/codewhale) [](https://discord.gg/37gfS3ksug) ## Install The first run helps you connect a provider or stay offline. Codewhale also supports Cargo, Docker, Nix, Scoop, prebuilt archives。這些內容只描述 CodeWhale 已公開的介面與用途；README 沒有交代的部署細節、模型效果或權限行為，本文保留為未說明，不把推測寫成保證。
貢獻、文件與 MIT 授權
專案歡迎 issue、pull request、重現步驟、日誌和功能請求。當 pull request 無法原樣合併時，維護者會保留其中可用的部分，並繼續在提交、變更日誌和 docs/CONTRIBUTORS.md 中保留作者署名。README 連結到 CONTRIBUTING.md、docs/CONTRIBUTORS.md 和 open issues 清單。文件位於 docs 目錄和 codewhale.net 上。授權為 MIT，版權歸 2024-2025 DeepSeek CLI Contributors 所有，授予使用、複製、修改、合併、發布、散布、再授權和銷售副本的權利。授權條款不提供任何擔保，也沒有關於安全或支援的說明。README 也指出該專案是一個獨立的社群專案，與任何模型提供者無關。
CodeWhale README 可核對的背景資料7：built in Rust and improved in public with the people who use it. [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.md) · [한국어](README.ko-KR.md) · [Español](README.es-419.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Українська](README.uk.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [繁體中文](README.zh-TW.md) · [हिन्दी](README.hi.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md) [](https://github.com/Hmbown/CodeWhale/actions/wo。這些內容只描述 CodeWhale 已公開的介面與用途；README 沒有交代的部署細節、模型效果或權限行為，本文保留為未說明，不把推測寫成保證。
編輯結論
Codewhale 是一個與模型無關的終端工具，具備感知權限的 TUI、無頭執行和可恢復的艦隊。README 未包含效能基準或生產保證，MIT 授權條款也不提供任何擔保。 採用前請先依 CodeWhale README 的實際命令、設定檔與輸入輸出做一次最小流程，確認你的環境能重現文件描述的結果；若核心整合或安全邊界未被文件說明，就不宜直接放進不可逆的正式流程。
社群筆記