Codewhale 终端编码助手
在终端中委派编码任务，让智能体读取代码库、修改文件并运行命令。
- Star 数
- ★ 41k
- 最近更新
- 今天
- License
- MIT
- 主语言
- Rust
- FA 评分
- 75/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude APIChatGPT · Claude Code（部分支持）
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 需要让编码助手修复失败测试并解释改动的开发者，可在仓库根目录交给它任务并查看 diff。
- 不适合
- 需要 Windows OS 沙箱的团队
- 希望直接使用原生桌面应用的用户
- 源码审查
- 75/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
Codewhale 是以 Rust 构建的开源编码助手，主要通过交互式终端应用使用，也提供单任务命令行、Web UI、Runtime API 和 ACP 接口。它在当前仓库中读取和搜索文件，按权限设置编辑文件并运行 shell 命令，任务可持续到完成或需要用户输入。它内置 40 多种模型服务商适配，也支持 OpenAI 兼容端点和通过 Ollama、vLLM 或 SGLang 运行的本地模型。/receipts 可查看文件变更、命令、Web 与 MCP 调用、审批及失败记录；工具执行记录也可在退出后查询。软件采用 MIT 许可且无需账户，但使用托管模型时需自行承担服务商费用；Windows 目前没有 OS 级沙箱。
在 Git 仓库根目录启动 codewhale 后，用户可输入任务；Codewhale 会读取和搜索仓库文件，在 Work 或 Operate 模式下编辑文件并运行命令。Ask 权限会在执行非只读 shell 命令前询问；用户也可配置 Auto-Review 或 Full Access。模型可通过 /provider 和 /model 选择，或连接本地 Ollama、vLLM、SGLang；扩展可通过 MCP 服务器、插件、技能和钩子提供工具。还可使用 codewhale exec 执行非交互任务、codewhale review --pr N 进行建议性 GitHub PR 审查、codewhale web 启动本地 Web UI，或运行 Runtime API 与 ACP。结果包括文件修改、命令和工具调用记录、审批及失败信息，可用 /receipts 或 codewhale receipts --last 查看。
- 需要让编码助手修复失败测试并解释改动的开发者，可在仓库根目录交给它任务并查看 diff。
- 希望先探索和规划而不改文件的工程师，可切换到 Plan 模式读取和搜索代码。
- 需要在脚本或 CI 中执行单次代码任务的维护者，可调用
codewhale exec并选择自动权限与沙箱设置。 - 需要检查 GitHub 拉取请求的团队，可运行
codewhale review --pr N获取建议性审查。 - 需要连接团队 MCP 工具或并行代理的开发者，可配置 MCP 服务器、插件、技能、工作流或子代理。
如何安装或部署这个 Agent？
macOS 和 Linux 可用安装脚本安装最新发布版；安装器会将 codewhale 与 codew 放入 ~/.local/bin。Windows 可从 README 提及的发行版途径安装，也可用 npm 或 Cargo 安装。
如何使用这个 Agent？
进入 Git 仓库根目录并启动终端应用：
codewhale在界面中使用 /provider 选择服务商、添加 API 密钥并选择模型；本地模型可使用 Ollama、vLLM 或 SGLang。然后输入任务，例如修复失败测试。默认 Ask 权限会直接应用文件编辑并在非只读 shell 命令运行前询问。
脚本或 CI 可运行：
codewhale exec --auto --sandbox workspace-write "fix the failing tests and explain what changed"这个 Agent 有哪些优点和局限？
- 内置 40 多种服务商，并支持 OpenAI 兼容端点及 Ollama、vLLM、SGLang 本地模型，便于按模型与部署方式选择。
- 交互终端、
exec、Web UI、Runtime API 和 ACP 共用同一引擎，适合个人操作与自动化接入。 /receipts记录变更文件、命令、Web/MCP 调用、代理、审批和失败，便于追溯任务过程。- Ask、Auto-Review、Full Access、Plan、Work 和 Operate 提供不同的权限与任务执行方式。
- 使用托管模型时需要自行配置服务商密钥并支付相应费用；本地模型则需要自行运行支持的推理运行时。
- Windows 尚无 OS 级 shell 沙箱；Full Access 会关闭 Codewhale 沙箱。
- 遥测默认开启，虽然 README 说明不发送对话、代码、提示词或凭据，仍需由用户主动关闭才能禁用。
- 原生桌面应用仍在开发中，没有公开下载版本。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Codewhale 终端编码助手 当前 | 75 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 41k | 今天 | Rust | OpenAI API · Claude API |
| Empryo | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.4k | 5 天前 | TypeScript | OpenAI API · Claude API |
| Aster | 77 · 表现良好 | 命令行工具免费 + 模型费 | ★ 131 | 2 天前 | Rust | OpenAI API |
| VT Code 终端编码智能体 | 66 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 883 | 今天 | Rust | OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示工具权限可配置，Ask 会对非只读 shell 命令询问，Full Access 会跳过沙箱；命令沙箱按平台说明回退条件，收据和撤销功能也有明确说明。遥测字段和退出方式、密钥留在本机及请求预览均有披露。扣分原因：默认文件修改无需确认，依赖用户理解模式差异；依赖安全材料仅列出版本和锁定依赖，没有展示漏洞审计或处置证据；发布者身份未知且维护归属信息有限。
README、沙箱说明和安装清单彼此大体一致，并明确区分已接入与未来功能；诊断、探测失败和平台回退均有说明。扣分原因：这些材料是静态描述，没有足以验证运行结果的证据；外部服务及系统沙箱是否可用仍取决于环境。
面向终端开发者、脚本/CI、课堂部署和集成开发环境，涵盖多种模型、运行模式与扩展方式。沙箱平台边界、插件限制及工作间尚未实现的部分写得清楚。扣分原因：触发和适用场景虽有举例，但复杂配置与扩展组合的选型指导不完整；Windows 当前没有命令 OS 沙箱。
文档按安装、模式、提供商、安全、扩展和 API 分层组织，提供命令示例、故障排查、已知限制、MIT 许可证和变更记录入口。扣分原因：安装渠道及当前 main 与已发布版本的差异要求读者留意；版本兼容和维护责任说明虽存在，但对未发布分支仅承诺尽力支持，发布者身份仍未验证。
产品可在终端中读取和修改仓库、执行工具调用，并提供收据、差异、撤销、多提供商及脚本接口，输出可用于审阅和自动化。扣分原因：价值依赖模型/API 成本、平台沙箱和操作者配置；高权限自动执行带来需自行管理的风险和成本。
文档将不少主张关联到具体配置、命令、模块路径、状态和限制，并区分已实现能力与未来工作。扣分原因：本次材料虽含多种文件，但多数安全与产品主张来自文档自述，未提供此静态审查范围内的独立实现交叉证据。
- Full Access 和 `exec --auto` 可在无逐项确认、无 Codewhale 命令沙箱的情况下执行命令；先确认权限模式和平台实际可用的沙箱。
- 遥测默认开启；如不接受匿名使用计数，请按文档关闭。使用外部模型提供商或 OpenSandbox 时，相关数据处理与隔离也取决于服务方。
- 文档明确指出 Windows 当前不提供 Codewhale OS 命令沙箱；不要把审批策略当作操作系统隔离。
常见问题
使用 Codewhale 是否必须付费或注册账户？
它能完全离线运行吗？
CODEWHALE_NO_UPDATE_CHECK=1 跳过版本检查，并关闭遥测；README 未说明完整离线模式。它会在未经确认时运行命令吗？
exec --auto 默认使用 Full Access，可添加 --sandbox workspace-write 限制执行范围。