开源 · 自带模型 · 运行在你的终端

一入码门深似海,
Codewhale 替你潜。

Codewhale 是一个跑在终端里的开源编程智能体。给它一个模型和一个任务。它会读你的代码、改文件、跑检查,活干完了或需要你拿主意时就停下来。模型随便用,也可以给每个角色各配一个。

一行安装
npm install -g codewhale
需要 Node 18+,无需 Rust 工具链其他方式 →

cw最新发布 v0.9.11源码 v0.9.1145 个提供商MIT

Codewhale TUI会话
Codewhale 终端会话,Operate 模式:鲸鱼、输入区与状态栏
Codewhale 会话 · Operate 模式 · 权限:Ask
实 时LIVE
已关闭#5533Feature: the control surface for supervised operation作者 @M-Maciej23分钟前已开启#5627Add Xquik to the reviewed MCP recommendations作者 @kriptoburak2小时前已合并#5623feat(tui): report post-compaction input tokens作者 @h3c-hexin2小时前已合并#5622feat(tui): support Kimi Code k3-256k作者 @h3c-hexin2小时前已合并#5624feat(tui): show live session token totals作者 @wuisabel-gif2小时前已合并#5619chore(contrib): grant @wuisabel-gif recurring PR access作者 @Hmbown3小时前已合并#5621fix(tui): make edit-last-turn boundaries authoritative作者 @h3c-hexin3小时前已开启#5626feat(runtime-api): add per-thread usage endpoint and persist session c…作者 @gaord8小时前已开启#5625Enhancement: non-blocking "pending user input" peek tool for mid-turn …作者 @ronohara14小时前已开启#5620Context pressure warning is transient and the agent does not proactive…作者 @ronohara19小时前已关闭#5616fix(tui): move git_status/git_diff off the async executor thread作者 @rafaelcavalheri昨天已关闭#5608feat(tui): add focused transcript actions作者 @wuisabel-gif昨天已合并#5614ci(release): fail when the release-note receipt check cannot run作者 @Hmbown昨天已合并#5613docs(i18n): fix English doc inaccuracies and add first zh_hans transla…作者 @SparkofSpike昨天已合并#5544feat(web): move docs/subagents and docs/mcp onto the dictionary spine …作者 @Lstarsky03天前已发布v0.9.113天前已开启#4956provider Network error: Connection failed: error sending request for u…作者 @RelicOfTesla29天前已开启#4568新版斜杠指令(/xxx)响应迟缓,性能不如上一版本作者 @whp233上个月已开启#4564codewhale exec --auto: --model and --toolsets flags consumed as single…作者 @alozano978-spec上个月

终端里的编程智能体。任意模型。本机运行。

用你手头已有的模型——托管、网关或本地都行。选一个模式:Plan、Work 或 Operate。再选它不问你就能做多少:Ask、Auto-Review 或 Full Access。

它如何决策

推理过程,原话呈现

会话摘录。每一段都写明模型依据了哪条项目规则,以及接着做了什么。

codewhale — thinking
推理痕迹
# 当上一会话的总结与仓库真实状态不符时……
Per Article II (truth) and V (verification), I report what's actually in the tree — not what the previous agent claimed.
Article II · TruthArticle V · Verification
如实报告了总结遗漏的未提交改动,而不是照搬旧说法。

从任务到验证过的改动。

  1. 01

    检查

    读取仓库、项目说明与任务。

  2. 02

    执行

    修改文件,你要求先问的地方会先问。

  3. 03

    验证

    运行检查,核对结果。

  4. 04

    报告

    说明改了什么、通过了什么。

$ codewhale exec "fix the failing test"inspect   仓库与项目说明act       在你设定的权限内修改文件verify    cargo test --lockedreport    检查通过 · 摘要已保存

第一次用?四步。

安装 → 首次会话,无需密钥 → 接入提供商 → 配置 Fleet。

  1. 安装 Codewhale

    一条 npm 命令即可安装终端运行时。Cargo、预编译包、Docker、Nix 和中国镜像也可以。它们安装的都是已发布版本。

    npm install -g codewhale
    codewhale doctor
    完整安装指南
  2. 打开第一个会话——无需密钥

    无需任何 API 密钥即可启动。简短设置后进入完整界面。先在只读的 Plan 模式里看看。模型回复需要提供商——那是下一步。

    codewhale
    先了解产品名词
  3. 连接提供商

    用托管 API 密钥、网关,或不需要密钥的本地运行时(Ollama、vLLM、SGLang)。提供商和模型都由你来选。模型名不会替你切换提供商。

    codewhale auth set --provider deepseek
    提供商与模型
  4. 配置你的理想 Fleet

    每个要用的提供商执行一次 auth set(本地运行时不需要)。然后运行 /fleet setup。它一次配置一个成员——语义角色、任意已配置提供商的模型、思考档位,再核对准确的身份与路由——并保存为花名册档案,可只用于本仓库或本机所有仓库。Runtime 权限始终独立。单个任务不需要这些。

    /fleet setup
    codewhale fleet status
    Fleet 与 Workflow 文档

你的模型。
你的边界。

模型、模式、以及它不问你能做多少,都由你来选。你不改,提供商和模型就不会变。预览功能会标注预览。

45 个提供商
托管、网关与本地模型
Plan · Work · Operate
从只读规划到自主执行
Ask · Auto-Review · Full Access
它在问你之前能做多少
TUI · exec · web · API
交互式或脚本化

活在哪里干,就在哪里用。

TUI交互式终端工作
codewhale exec脚本与 CI
Web 客户端浏览器客户端,仅限本机
运行时 API + MCP本地集成
Fleet多个智能体协作一件事
运行时界面与稳定程度 →

从一条命令开始。

npm install -g codewhale

Cargo预编译包DockerNixWindowsAndroid / Termux中国镜像

阅读安装指南 →

公开构建

MIT 许可。贡献者的工作覆盖运行时、提供商、平台、文档与测试。