Codewhale 终端编程智能体

Codewhale 是什么

Codewhale 是一款开源的终端编程智能体（coding agent），使用 Rust 编写。它能读取你的项目、编辑文件、运行命令并检查执行结果，模型可以是你选择的托管服务，也可以是本地运行的模型。

它最初叫 deepseek-tui，如今已发展为一个支持多提供商、多模型、多智能体协作的工具，并保持配置与会话的向后兼容。

核心能力

在终端里干活

在项目目录下运行 codewhale 打开交互式界面，用 /provider 选择提供商、/model 选择模型，然后直接描述任务：

Fix the failing tests and explain what changed.

也可以不进入 TUI，直接在脚本或 CI 中执行：

codewhale exec "fix the failing tests and explain what changed"

模式与权限控制

• /mode plan：只探索、不改文件、不执行 shell
• /mode work：允许实际修改
• Shift+Tab：在 Ask、Auto-Review、Full Access 之间切换审批级别

/undo 与 /restore 可帮助恢复工作区改动。

多智能体与多模型

可以把大任务拆分给不同模型、不同角色的智能体协作完成，并通过 /goal 设定持久目标、保存会话、在运行前审查工作流。

扩展生态

• 连接 MCP 服务器与技能
• 配置 hooks
• 以可读文件形式定义智能体角色
• 可选 Computer Use 插件，用于观察和操作其他应用

安装与运行

macOS / Linux 可通过官方安装脚本安装，Windows 可从 GitHub Releases 下载安装包或压缩包。也支持 npm、Cargo、Docker、Nix、Scoop、Android/Termux 等次要分发方式。

首次运行会直接进入输入界面，不会引导配置。在连接模型之前，界面会提示「no model connected」，此时用 /provider 添加托管密钥或选择本地运行时即可。若本机已有 Ollama 并加载了对话模型，Codewhale 会自动切换过去。

适用人群

• 习惯命令行、希望减少窗口切换的开发者
• 关注代码隐私、倾向使用本地模型的团队
• 需要把编码任务接入 CI 或自动化脚本的工程师

安全提示

Codewhale 以你授予的权限在本机运行。审批模式与仓库规则会限制智能体行为，在支持的平台上还可启用操作系统级沙箱作为更强的执行边界。未知的模型价格会保持「未知」，而不会被当作免费。