codewhale-hq/Codewhale

这是什么？

核心功能

• 01内置 40 多家模型服务商，并支持任何兼容 OpenAI 接口的端点
• 02通过 Ollama、vLLM、SGLang 使用本地模型
• 03执行非只读 shell 命令前需确认，提供 Ask、Auto-Review、Full Access 三种权限级别
• 04记录修改的文件、执行的命令和外部调用的收据
• 05通过 /undo 撤销上一次请求的文件改动
• 06支持接入 MCP 服务器、技能、插件和钩子

适用场景

• 在终端中修复失败的测试或在 git 仓库中进行多文件修改
• 在脚本或 CI 中通过 codewhale exec 非交互地运行编程任务
• 使用建议性审查命令评审 GitHub Pull Request
• 使用本地部署的模型，让代码不离开自己的机器

快速上手

1. 1

   使用 README 中的官方安装脚本安装

2. 2

   通过 npm 安装

   npm install -g codewhale
3. 3

   在 git 仓库根目录运行 codewhale

   codewhale
4. 4

   运行 /provider 选择提供商并粘贴 API 密钥，然后输入任务

使用前须知

• !Windows 目前没有操作系统级沙箱，完全访问模式会关闭沙箱。
• !遥测默认开启，可通过配置命令关闭。
• !内置的 Computer Use 插件处于实验阶段，仅支持 macOS。
• !部分功能已合并到 main 分支，但尚未发布在正式版本中。

标签

常见问题

Codewhale 是什么？

开源的 Rust 终端编程智能体，可读写代码、执行命令，并支持 40 多家模型服务商和本地模型。 Codewhale 是一款在终端中运行的编程智能体。给它一个任务后，它会阅读代码仓库、修改文件并执行命令，直到任务完成或需要你介入。内置 40 多家模型服务商，包括 Anthropic、OpenAI、DeepSeek、Google、Mistral 和 OpenRouter，也可以接入任何兼容 OpenAI 接口的端点，或通过 Ollama、vLLM、SGLang 运行的本地模型。

Codewhale 可以免费使用吗？用的什么许可证？

Codewhale 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

Codewhale 还在维护吗？

活跃维护中。Codewhale 最近一次提交是在 2026年10月19日。

Codewhale 适合用来做什么？

在终端中修复失败的测试或在 git 仓库中进行多文件修改 在脚本或 CI 中通过 codewhale exec 非交互地运行编程任务 使用建议性审查命令评审 GitHub Pull Request 使用本地部署的模型，让代码不离开自己的机器

Codewhale 怎么安装和运行？

使用 README 中的官方安装脚本安装 通过 npm 安装: npm install -g codewhale 在 git 仓库根目录运行 codewhale: codewhale 运行 /provider 选择提供商并粘贴 API 密钥，然后输入任务

在哪里获取 Codewhale？

源代码和安装说明在 GitHub 上：https://github.com/codewhale-hq/Codewhale