Codewhale

机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

安装

macOS 和 Linux：

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

安装器会将经过校验和验证的二进制文件下载到 ~/.local/bin。如果之后运行 codewhale 提示 "command not found"，请运行安装器打印出的那一行 PATH 命令，或参阅 将它加入 PATH。 随时可以通过 codewhale update 升级。

winget 安装 HunterBown.CodeWhale  # Windows x64（或者使用 Scoop，或者从 GitHub Releases 的安装程序）
npm install -g codewhale            # 封装相同的发布二进制文件 cargo install codewhale-cli --locked  # 从 crates.io 构建

快速开始

在一个地方管理你的模型 API 密钥。 注册 Codewhale 账号， 或运行 codewhale login 登录。将密钥保存到账号后，可以集中更新，并在已登录的设备上 通过 Codewhale 模型通道使用。设置账号密钥（英文版）。 登录不会自动上传已有的本地密钥；不注册账号也可以继续在本地使用。

1. 打开你的项目。 在要处理的文件夹中运行 codewhale。
2. 连接模型。 运行 /provider（或按 F3）添加托管服务的密钥，或选择本地运行时。 如果 Ollama 已在运行并带有聊天模型，Codewhale 会自动切换到它。使用 /model 更换模型。
3. 给它一个具体的任务。

Fix the failing tests and explain what changed.

同一任务也可以在脚本或 CI 作业中以无界面方式运行：

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

运行 /help 查看命令和键盘快捷键。

运行方式

所有客户端都驱动同一个本地 Codewhale Runtime，因此会话、工具和权限在各处的行为一致。

原生桌面应用（GPUI）正在作为需登录的产品客户端开发中；开放情况见 产品页面。由社区维护的 VS Code 扩展 可在侧边栏中连接同一个 Runtime（源码）。

功能

• 任意模型，不被锁定。 内置超过 40 条提供商路由——Anthropic、DeepSeek、Google、 Mistral、Moonshot、OpenAI、OpenRouter、xAI 等——还支持任何兼容 OpenAI 的端点， 以及通过 Ollama、vLLM 或 SGLang 运行的本地模型。提供商
• 由你掌控。 Plan 模式只探索、不做任何改动；Work 和 Operate 会进行修改。 审批姿态决定工具调用何时需要你的确认，/undo 和 /restore 可恢复工作区改动， /receipts 会列出一次会话中的每个文件、命令和审批。模式 · 回执
• 为长时间任务而设计。 设定持久的 /goal，把有边界的工作委派给 子智能体，运行带有预算检查的受监督智能体团队， 或将它们编写为可纳入版本库的工作流。
• 扩展你已在使用的工具。 连接 MCP 服务器，安装 技能和插件，在会话和工具事件上运行 钩子，并加载现有的 Claude Code 插件。
• Computer Use。 内置插件提供观察和操作其他应用的工具。使用前请先查看其访问范围并启用。 指南

模式与权限

Full Access 仍然遵守硬性策略边界。 模式与权限指南对每个选项都有说明。

安全

Codewhale 在你的机器上运行，只拥有你授予它的访问权限。审批姿态和仓库规则会限制智能体可以做的事， 在支持的平台上，命令会在操作系统沙箱中运行（macOS 上为 Seatbelt；Linux 上的 bubblewrap 需主动启用）。 /preview-request 会在发送任何内容之前显示经过脱敏的完整请求。 未知的模型价格会保持"未知"，而不会被报告为免费。

参见授权顺序、 沙箱和遥测——使用量计数默认开启， 运行 codewhale config set telemetry false 即可关闭。

文档

社区

欢迎提交缺陷报告、功能想法和拉取请求——无论你已使用 Codewhale 数月，还是第一次尝试。 如果缺少某个提供商，或某个工作流不顺手， 请提交 issue或 发送拉取请求。欢迎首次贡献， 被合并的工作会保留贡献者的署名。 仓库结构是一个不错的起点。

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

历史与许可证

Codewhale 最初名为 deepseek-tui，至今仍会读取该项目的配置和会话。 它现在与具体提供商无关，由独立团队维护，与任何模型提供商均无隶属关系。 感谢每一位贡献者，以及帮助它成长的开源社区。

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