Codewhale：终端里的开源编程 Agent

项目简介

Codewhale 是一个用 Rust 编写的开源终端编码 Agent。给它一个任务，它会读取仓库、编辑文件、运行命令，直到任务完成或需要你补充输入。它内置 40 多个提供商，默认使用 DeepSeek V4.1 Flash，也支持运行在本机的模型。/receipts 会列出它改过的文件、执行过的命令，以及发起的 Web 与 MCP 调用。

主要功能

• 多模型：内置 40 多个提供商，包括 Anthropic、OpenAI、DeepSeek、Google、Mistral、Moonshot、OpenRouter、xAI 等；任何 OpenAI 兼容端点都能接入，也支持通过 Ollama、vLLM、SGLang 使用本地模型。/model 可在每轮之间切换模型，/model auto 会为每轮自动选择，/turn inspect 查看本轮使用的模型、花费和耗时。
• 模式与权限：Tab 或 /mode 在 Plan（只读不改）、Work（改文件、跑命令）、Operate（把请求当目标持续执行到验证完成）之间切换；Shift+Tab 在 Ask、Auto-Review、Full Access 三种权限间切换。
• 回执与撤销：/receipts 或退出后执行 codewhale receipts --last，可查看改动文件、执行命令、Web 与 MCP 调用、启动的 Agent、审批记录与失败项；/undo 一步撤回上一次请求及其文件改动；/restore 将整个工作区回滚到更早的快照。
• 长任务：/goal 设定跨轮次目标，可把工作拆分给 sub-agents、运行 agent fleet，或按仓库内的 workflow 执行。
• 扩展能力：接入 MCP 服务器，添加 skills 与 plugins，在会话和工具事件上运行 hooks；Code mode（实验性，默认开启）让模型写一个 execute_tools 程序调用多个 MCP 与插件工具，每次调用仍受审批规则约束并保留回执。
• 兼容其他 Agent：自动读取 AGENTS.md；CLAUDE.md、.cursorrules、.github/copilot-instructions.md 等需在配置中通过 project_instruction_imports 显式开启后才会加载；/import-claude 可准备导入 Claude Code 的设置与 MCP 服务器，/plugin install 接受包含 skills、commands、agent profiles 与 MCP 服务器的 Claude Code 插件。
• 0.10.2 新增：/pet on 把终端变成动画鲸鱼来展示 Agent 正在做什么；/workbar terminal 实时显示 Agent 正在运行的 shell；/color 为每个对话设置独立配色；/diff 在非 Git 目录也能用；web_search 可接入 DeepSeek Search API。

安装与使用

macOS 与 Linux：

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

安装器会把经过校验的 codewhale 及其短别名 codew 放到 ~/.local/bin，用 codewhale update 升级。Windows、npm、Cargo 等方式：

winget install HunterBown.CodeWhale  # Windows x64
npm install -g codewhale
cargo install codewhale-cli --locked

快速上手：先提交或 stash 你的改动，在 git 仓库根目录运行 codewhale；执行 /provider（或按 F3）选择提供商、粘贴 API Key、选择模型，然后输入任务，例如：

Fix the failing tests and explain what changed.

只读命令会直接执行，其他 shell 命令会先询问：y 执行一次，a 在本次对话内放行同类命令，n 拒绝。/undo 撤回上一次请求及其文件改动，/help 列出所有命令与快捷键。

用于脚本和 CI 时，codewhale exec 可以不带界面执行单个任务：

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

注意事项

• codewhale exec --auto 默认使用 Full Access：工具无需确认即可运行，shell 不受 Codewhale 沙箱限制，trust mode 允许文件工具写到工作区之外；加上 --sandbox workspace-write 可保留 shell 沙箱与文件工具的工作区限制，并关闭 trust mode。
• 同一台机器只保留一种安装方式，否则 PATH 上会出现两份，先被找到的那份生效。
• /restore 会覆盖之后的编辑，因此需要 /trust on 或 Full Access。
• 全新安装默认处于 Work 模式与 Ask 权限。

---

本作品整理自 GitHub 开源项目 codewhale-hq/Codewhale，原作者 @codewhale-hq，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。