Codewhale
Codewhale 是一款在終端機中使用的開源程式設計代理，以 Rust 打造，並與使用者一起透過公開協作持續改進。
English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · हिन्दी · Türkçe · Italiano · Polski · العربية · Català
安裝
npm install -g codewhale
codewhale
第一次執行時，系統會協助你連線至供應商，也可以選擇保持離線。Codewhale 亦支援 Cargo、Docker、Nix、Scoop、預先建置的封存檔、Android/Termux 與 CNB 映像。請參閱安裝指南。
每種 shell 只需一個指令即可啟用 Tab 自動完成——codewhale completion bash|zsh|fish|powershell|elvish。請參閱 shell 自動完成。
使用
像和隊友交談一樣告訴 Codewhale 你的需求：
Fix the failing tests and explain what changed.
你也可以不開啟 TUI，直接執行任務：
codewhale exec "fix the failing tests and explain what changed"
Codewhale 可以讀取你的程式碼儲存庫、編輯檔案、執行指令、檢查結果，並持續朝目標推進。你可以決定要授予它多少存取權限。
為何選擇 Codewhale
- 使用你想要的模型。 連線至託管供應商，或透過 Ollama、vLLM、SGLang 使用本機模型。使用
/model切換供應商與模型。 - 掌控權始終在你手中。 Plan 模式為唯讀。Ask、Auto-Review 與 Full Access 會清楚呈現核准行為。
/undo可復原上一輪操作，/restore可將工作區還原至較早的快照。 - 讓長時間工作井然有序。 儲存工作階段、設定持久的
/goal、在工作流程執行前加以審查，並協調多個代理，同時避免其內部指示混入你的對話記錄。 - 擴充你已有的代理。 連接 MCP 伺服器與技能、設定掛鉤，並將代理角色以可讀檔案保存在專案或個人設定中。
在 TUI 中執行 /help 可查看指令與鍵盤快速鍵。
安全性
Codewhale 在你的電腦上執行，且只擁有你授予的存取權限。核准模式與儲存庫規則會限制代理可以執行的操作；在支援的平台上，選用的作業系統沙箱可提供更強的執行邊界。未知的模型價格會維持顯示為未知，而不會被誤報為免費。
閱讀授權順序以了解確切的政策層級，並閱讀設定以了解本機設定。
文件
加入社群
當人們使用 Codewhale、回報不順手之處並協助修正問題時，它就會變得更好。如果缺少某個供應商、工作流程操作不便，或終端機介面妨礙了你，請提出 issue。如果你知道如何改善，請提出 pull request。我們歡迎首次貢獻，貢獻者也會保留已合併工作的署名。
加入 Discord，或在微信加入 Hunter（hunterbown）並申請加入 Whale Brothers 群組。
專案歷史
Codewhale 最初名為 deepseek-tui，至今仍保留與其設定及工作階段的相容性。現在它不偏向任何供應商，由社群獨立維護，也不隸屬於任何模型供應商。
感謝每一位貢獻者，以及協助專案成長的開源社群。請參閱貢獻者記錄。