Rust Codewhale 支持任意模型的终端开源编程智能体

市面上的编程 Agent 大多绑定某一家云端模型，想换模型要换工具，想本地跑要折腾环境，想看“它到底改了什么、跑了哪些命令”还得去翻日志。对重视数据主权、又想自由选择模型的开发者，这种锁定很烦。
Codewhale 的思路是：做一个终端里的开源 Agent，默认用 DeepSeek V4.1 Flash，但支持 40+ 内置供应商与本地模型，并且把“它改了哪些文件、跑了哪些命令、调了哪些 Web/MCP”整理成一张可查看的 receipt。

项目基本信息

一、项目介绍

codewhale-hq/Codewhale 是一个用 Rust 编写、开源（MIT）的终端编程智能体。你给它一个任务，它会读仓库、改文件、跑命令，直到任务完成或需要你介入。它兼容 40 多个内置模型供应商，默认走 DeepSeek V4.1 Flash，也支持本地模型。Codewhale 强调 local-first，并提供 /receipts 来回顾本次会话改动的、运行的与调用的全部痕迹，让 Agent 的行为可审计、可复盘。

二、核心优势

1. 任意模型：40+ 内置供应商，默认 DeepSeek V4.1 Flash，也支持本地模型。
2. 本地优先：可在本机运行，代码与工作流不强制上云。
3. 可审计：/receipts 汇总改动文件、运行命令与 Web/MCP 调用，行为透明。
4. 多运行方式：install.sh、winget/scoop、npm 包、cargo install 多种分发。
5. 跨平台：Rust 单二进制，Windows / macOS / Linux 一致体验。

三、适用场景

• 想在终端里完成“读代码—改文件—跑命令”的闭环任务。
• 希望自由选择/本地运行模型、不被云端厂商锁定的开发者。
• 需要事后复盘 Agent 改动与命令的审计场景。
• 做自动化重构、测试修复等可交给 Agent 的重复工程。

四、安装教程

macOS / Linux 一行安装：

curl -fsSL https://codewhale.net/install.sh | sh

Windows（winget）：

winget install HunterBown.CodeWhale

也可 npm 或 cargo：

npm install -g codewhale
cargo install codewhale-cli --locked

常见报错：install.sh 在受限网络可能拉取失败，可改用 npm/winget/源码编译；Windows 执行策略拦截 winget 以外脚本时按提示放行。

五、使用示例

把任务交给 Agent（沙箱模式）：

codewhale exec --auto --sandbox workspace-write "fix the failing tests and explain what changed"

真实流程：Codewhale 进入仓库，定位失败测试、修改对应代码并运行，完成后用自然语言解释改动；随后可用 /receipts 查看本次会话改了哪些文件、执行了哪些命令、调了哪些外部服务，做到全程可追溯。

六、常见问题

Q：默认模型是什么？
A：默认走 DeepSeek V4.1 Flash，但可在配置里换成任意内置供应商或本地模型。
Q：能保证代码不出本机吗？
A：支持本地优先与本地模型运行，但使用云端模型时相应流量仍会发往该供应商。
Q：和 Claude Code 比如何？
A：Codewhale 强调多模型与可审计 receipt，且开源；Claude Code 深度绑定 Anthropic，按你是否需要换模型与审计来选。

七、总结

Codewhale 把“终端编程 Agent”做成了模型自由、本地优先且行为可审计的开源工具。对想摆脱云端绑定、又需要复盘 Agent 痕迹的开发者，它是闭源 Agent 之外一个透明的替代；MIT 协议、Rust 单二进制，部署成本极低。