第 2026-07-19 期
v0.8.67
CodeWhale
任何模型 · 开源模型优先
开源 · 任意模型 · 运行在你的终端

编码智能体运行在代码之上。CodeWhale 还运行在法典之上。

CodeWhale 是一个开源的终端编程智能体——一个 TUI,一个 CLI——适配任意模型,DeepSeek 与开放权重模型享有一级支持。指令总在堆积、彼此冲突:过时的规格、陈旧的交接、你此刻的要求、刚跑出的测试结果。多数智能体靠猜来化解;CodeWhale 靠位阶来裁决——一部嵌套的宪法:内置的基础法、你的常备规则、仓库自己的法。由执行框架强制生效,换掉模型也不失效。

一行安装
npm install -g codewhale
需要 Node 18+,无需 Rust 工具链其他方式(Cargo / Homebrew / 国内镜像)→
由 Hmbown 维护v0.9.130 个提供商MIT
看它如何裁决
codewhale — thinking
推理痕迹
# 当上一会话的总结与仓库真实状态不符时……
Let me be careful and truthful here. Per Article II (truth) and V (verification), I need to report what's actually in the tree — not what the previous agent claimed.
Article II · TruthArticle V · Verification
如实报告了总结遗漏的未提交改动,而不是照搬旧说法。

摘自真实会话的忠实片段——宪法可以在模型的推理里被直接观察到,而不是落地页上的一句宣称。

实 时LIVE
PR#4563fix(web): share SSRF guard and isolate web.run sessions· 33mISS#4564codewhale exec --auto: --model and --toolsets flags consumed as single arg on …· 51mPR#4562feat(route): make ReadyRouteCandidate immutable with sourced limit overrides· 1hPR#4559feat(protocol): add dependency-neutral run read model· 1hPR#4560chore(work-graph): satisfy current clippy· 2hPR#4561test(doctor): make scrubbed probes cross-platform· 2hPR#4558feat(persistence): per-session crash checkpoints with flush reporting· 4hPR#4553feat(work-graph): core model, reducer, validation· 4hPR#4555feat(kimi-code): exact K3 route truth and reasoning-effort canonicalization· 4hPR#4557feat(kimi-code): membership-plan onboarding and key recovery· 4hPR#4556feat(kimi-code): context-window provenance surfaces· 4hPR#4554fix(config): stop root DeepSeek default leaking onto vendor-locked routes· 4hPR#4563fix(web): share SSRF guard and isolate web.run sessions· 33mISS#4564codewhale exec --auto: --model and --toolsets flags consumed as single arg on …· 51mPR#4562feat(route): make ReadyRouteCandidate immutable with sourced limit overrides· 1hPR#4559feat(protocol): add dependency-neutral run read model· 1hPR#4560chore(work-graph): satisfy current clippy· 2hPR#4561test(doctor): make scrubbed probes cross-platform· 2hPR#4558feat(persistence): per-session crash checkpoints with flush reporting· 4hPR#4553feat(work-graph): core model, reducer, validation· 4hPR#4555feat(kimi-code): exact K3 route truth and reasoning-effort canonicalization· 4hPR#4557feat(kimi-code): membership-plan onboarding and key recovery· 4hPR#4556feat(kimi-code): context-window provenance surfaces· 4hPR#4554fix(config): stop root DeepSeek default leaking onto vendor-locked routes· 4h

三层法

v0.8.67 新增:宪法优先设置

审批、沙箱、网络与信任控制由代码强制执行——宪法文本永远越不过它们。

为什么是法 →
Stars · 星标
39.9k
Forks · 复刻
3.4k
Contributors · 贡献者
188
Latest · 版本
v0.9.0

怎么开始

三步:装好、配一个模型密钥、在项目里运行。每一步的细节都在安装指南里。

任意模型,实话实说

30 个提供商,同一个运行时。自带密钥,没有推理加价,不会悄悄换模型。此刻的真实情况:

当前推荐:GLM 5.2high reasoning,在 CodeWhale 里表现很好。
OpenAI Codex 登录可用。
Kimi OAuth 暂时不可用,正在修。
全部提供商 →没看到你想要的模型或端点?开个 issue

最近在发生什么

本周发布平稳——安装路径和贡献指南已同步。

本「今日要闻」由 DeepSeek V4-Flash 每六小时重新生成。在 cron 写入真实仓库动态之前,下面的固定链接是最实用的入口。

  • shipped
    安装

    npm、Cargo、Homebrew,或直接下载。

  • opened
    开放议题

    从 good first issue 标签开始。

  • discussion
    路线图

    已确认、审议中、以及已排除的功能。

需要帮助?

国内镜像 / China mirrors

npm 安装时可设 CODEWHALE_USE_CNB_MIRROR=1,wrapper 会改从 CNB 下载二进制。DeepSeek API(api.deepseek.com)国内直连,无需代理。

v0.9.1 致谢

每个补丁和报告都算数

CodeWhale 不做什么

有些边界值得写清楚。下面每一条都对这份代码库为真,可以在源码里核对——不是营销措辞。

不需要云账号

在你的机器上本地运行,无需注册 CodeWhale 账号。本地 vLLM / Ollama 模型连密钥都不用。

不收集你的代码

你的代码和使用数据都留在本机,没有任何分析上报。唯一自发的网络请求是一个可关闭的新版本检查,不发送任何代码。

不加推理差价

自带密钥,请求直连你配置的提供商,按提供商的价格计费。没有中间代理,没有加价。

不要求 CLA

贡献即 MIT 进、MIT 出。没有贡献者许可协议,也不需要签署版权转让。

不悄悄换模型

你选的模型就是运行的模型。切换是显式命令;自动路由需手动开启,并会显示所选路由。

法典越不过运行时控制

审批、沙箱、网络与信任由代码强制执行。任何法典文本——内置的、你的、或仓库的——都无法放松它们。

最后一条是根本性的,而且可验证——由执行框架的代码强制生效。 阅读宪法 →

这个项目

来自世界各地的开发者,把 CodeWhale 变成了今天的样子。

CodeWhale 起于一个人的 DeepSeek 业余项目,来自许多国家的贡献者把它塑造成了现在的样子——每一版发布上的贡献者名单就是证据。这里没有 CLA,没有赞助商优先通道,议题公开分类,版本从 main 分支发布。

「所有反馈都是礼物。」——这是我教书时很早就学到的一句话,也是我维护 CodeWhale 的方式。每一个 issue、PR、bug 报告或想法,都是我理解真实使用场景、做出更好决策的方式。

如果你遇到用不了的地方,或者想要一个没列出来的模型——那是你能告诉这个项目的最有用的事。

版本0.9.1
提供商30
许可证MIT