产品与定位
Codewhale 是一款用 Rust 编写的开源终端编码 Agent，原名 deepseek-tui（仓库 Hmbown/DeepSeek-TUI）。项目已正式更名为 Codewhale（仓库同步改为 Hmbown/CodeWhale），并从「面向 DeepSeek 的 TUI」转型为供应商中立的通用编码 Agent —— 官方明确声明「不再隶属于任何模型供应商」。
对老用户是好消息：更名后保留了原有配置与 session 的兼容性，不需要迁移。
功能速览
| 功能 | 说明 |
|---|---|
| 供应商中立 | 可接托管 API，也可通过 Ollama / vLLM / SGLang 接本地模型，/provider 与 /model 切换 |
| 三种客户端 | 终端 TUI、本地网页客户端（codewhale web）、GPUI 原生桌面应用 |
| 非交互执行 | codewhale exec "任务" 适合脚本与 CI |
| 模式与权限 | /mode plan 只读探索、/mode work 允许改动；Shift+Tab 切换 Ask / Auto-Review / Full Access |
| MCP 与技能 | 支持接入 MCP 服务器与 skills，可配置 hooks，Agent 角色以可读文件定义 |
| Agent 团队 | 支持多 Agent 协作与长任务编排（docs/FLEET.md） |
| 会话管理 | 保存会话、设定持久 /goal、/undo 与 /restore 恢复工作区改动 |
| Computer Use | 内置插件，可观察并操作其他桌面应用（需显式授权与系统权限；macOS 为 beta，Windows/Linux 实验性） |
| OS 级沙箱 | 可选的操作系统沙箱，用于在审批模式与仓库规则之外提供更强的执行边界 |
| 内置 Web 搜索 | 提供 Web 搜索工具 |
| MCP 服务器 | 除作为客户端外，也可 codewhale serve --mcp 被其他 MCP 客户端调用 |
| 多端安装 | npm、Cargo、Homebrew、Docker、Nix、Scoop、Android/Termux，另提供 CNB 镜像 |
常用命令
| 命令 | 作用 |
|---|---|
codewhale | 启动交互式 TUI |
codewhale exec "..." | 非交互执行一个任务 |
codewhale web | 启动本地网页客户端 |
codewhale update | 更新到最新版本（--check 仅检查） |
codewhale completion <shell> | 生成 bash/zsh/fish/powershell/elvish 补全 |
/mode plan / /mode work | 切换计划与执行模式 |
调用与兼容性
# macOS / Linux 官方安装脚本（自动选择最新 release）
curl -fsSL https://codewhale.net/install.sh | sh
"$HOME/.local/bin/codewhale"
# Windows：从 GitHub Releases 下载安装包
# 已直装用户可直接原地升级
codewhale update也支持 npm 与 Cargo 作为次要安装途径。首次运行会引导你连接供应商或配置离线模式。
版本与更新注意
- 当前版本 v0.10.0（2026-09-22 发布），MIT 许可，仓库约 41,031 stars、3,564 forks（截至 2026-09-22）。注意官网版本展示滞后：codewhale.net 上仍标注 v0.9.13，请以 GitHub Release 为准。
- 品牌与仓库均已改名：v0.8.41 起项目以
codewhale名义发布，Hmbown/DeepSeek-TUI→Hmbown/CodeWhale，官网为codewhale.net。旧地址会重定向，但引用时建议改用新名称与新地址。v0.9.0 起已移除deepseek/deepseek-tui兼容 shim，旧命令不再可用，npm 上的deepseek-tui包也已废弃 —— 老用户需改用codewhale。 - 定位已变：不再是 DeepSeek 专属工具，现支持 40+ 供应商（DeepSeek 仅为默认供应商，默认模型
deepseek-flash），也可用 Ollama / vLLM / SGLang 跑本地模型。README 原文：「It is now provider-neutral and independently maintained; it is not affiliated with any model provider.」早期资料中「面向 DeepSeek-V4 优化」的说法已过时。 - 旧描述需澄清的两点：①「Codex 风格架构」在官方 README 与官网中均无此表述，属外部推断，不建议引用；②「支持 100 万 token 上下文」是 DeepSeek 模型自身的属性（
deepseek-flash与deepseek-v4-pro均为 1M 上下文），并非 Codewhale 的工具能力。 - 沙箱措辞需谨慎：官方原文为 optional OS sandboxing，默认依赖审批模式与仓库规则；能力可用性还因平台而异。
- 产品形态正在迁移：官方于 2026-09-14 决定以 GPUI 原生桌面应用作为主客户端方向；托管网页版
app.codewhale.net将分阶段下线，但营销站点、登录、计费、法务与下载页会长期保留。 - VS Code 扩展由社区维护，非官方出品。
- 模型价格未知时保持「未知」而不显示为免费，这一点在成本核算上比部分同类更诚实。