Codewhale

Codewhale 是一款面向终端的开源编程智能体，使用 Rust 构建，并与用户一起在公开协作中不断改进。

English · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català

安装

npm install -g codewhale
codewhale

首次运行会帮助你连接提供商，也可以选择保持离线。Codewhale 还支持 Cargo、Docker、Nix、Scoop、预构建压缩包、Android/Termux 和 CNB 镜像。请参阅安装指南。

每种 shell 只需一条命令即可启用 Tab 补全——codewhale completion bash|zsh|fish|powershell|elvish。请参阅 shell 补全。

使用

像与队友交流一样向 Codewhale 描述任务：

Fix the failing tests and explain what changed.

也可以不打开 TUI，直接运行任务：

codewhale exec "fix the failing tests and explain what changed"

Codewhale 可以读取你的代码仓库、编辑文件、运行命令、检查结果，并持续推进目标。由你决定授予它多少访问权限。

为什么选择 Codewhale

• 使用你想要的模型。 连接托管提供商，或通过 Ollama、vLLM、SGLang 使用本地模型。使用 /model 切换提供商和模型。
• 掌控始终在你手中。 Plan 模式为只读。Ask、Auto-Review 和 Full Access 会清晰展示审批行为。/undo 可撤销上一轮操作，/restore 可将工作区恢复到较早的快照。
• 让长时间任务井然有序。 保存会话、设置持久的 /goal、在工作流运行前进行审查，并协调多个智能体，同时不让其内部指令混入你的对话记录。
• 扩展你已有的智能体。 连接 MCP 服务器和技能、配置钩子，并将智能体角色作为可读文件保存在项目或个人设置中。

在 TUI 中运行 /help 可查看命令和键盘快捷键。

安全

Codewhale 在你的机器上运行，并仅拥有你授予的访问权限。审批模式和仓库规则会限制智能体的行为；在支持的平台上，可选的操作系统沙箱可提供更强的执行边界。未知的模型价格会保持显示为未知，而不会被误报为免费。

阅读授权顺序了解确切的策略层级，阅读配置了解本地设置。

文档

• 提供商和本地模型
• 智能体团队
• MCP、钩子和配置
• 本地 Web 客户端
• 全部文档

加入社区

当人们使用 Codewhale、反馈不顺手之处并帮助修复问题时，它就会变得更好。如果缺少某个提供商、工作流体验不佳，或终端界面妨碍了你，请提交 issue。如果你知道如何改进，请提交 pull request。我们欢迎首次贡献，贡献者也会保留已合入工作的署名。

加入 Discord，或在微信添加 Hunter（hunterbown）并申请加入 Whale Brothers 群。

项目历史

Codewhale 起初名为 deepseek-tui，至今仍保留与其配置和会话的兼容性。如今它已不偏向任何提供商，由社区独立维护，也不隶属于任何模型提供商。

感谢每一位贡献者，以及帮助项目成长的开源社区。请参阅贡献者记录。

许可证

MIT。从其他开源项目改编的部分记录在第三方声明中。