Codewhale

项目简介

Codewhale 是一个开源编码智能体与终端客户端，基于本地 Rust 智能体引擎。它可以读取项目、编辑文件、运行命令并检查工作结果，同时可使用托管提供商 API 或本地及自托管模型。

核心功能

• 支持 40 多条内置提供商路由、OpenAI 兼容端点，以及通过 Ollama、vLLM 或 SGLang 运行的本地模型。
• 提供 Plan、Work 和 Operate 模式与审批姿态，可通过 /undo 和 /restore 恢复工作区，并用 /receipts 列出会话活动。
• 提供交互式终端、无头 exec、本地浏览器客户端，以及用于线程、事件和审批的本地 HTTP 运行时 API。
• 可通过 MCP 服务器、技能、插件、钩子扩展，并兼容现有 Claude Code 插件。
• 支持多智能体工作流，包括子代理、受监督的智能体团队、Fleet 设置与状态，以及已检入的工作流。
• Computer Use 插件可用于观察和操作其他应用，访问权限由用户授予。

适用场景

• 构建应用、添加功能或编写脚本，然后运行代码并测试构建结果。
• 从终端、脚本或 CI 自动化重复工作流，包括使用 codewhale exec 执行无头回合。
• 通过插件和 MCP 服务器连接工具，或在自有脚本中使用 API。
• 使用 Fleet 将较大的任务拆分给具有不同角色和模型的智能体。

快速开始

• 在 macOS 或 Linux 上使用安装脚本安装 Codewhale，按安装器提示处理 PATH，然后打开项目文件夹。
• 使用 codewhale auth set --provider deepseek 连接模型，也可使用 /provider 或 F3，并通过 /model 切换模型。
• 运行 codewhale 并描述具体任务，然后选择权限并审查其工作。
• 可选：使用 /fleet setup 保存多智能体团队，并用 /fleet status 检查运行情况。

部署与要求

• 可在 macOS、Linux 和 Windows 上运行；Android 上的 Termux 为预览版。
• 安装方式包括安装脚本、npm、Cargo、Docker、Nix、Linux 上的 Homebrew，以及手动下载。
• 模型访问可使用提供商账户、OpenAI 兼容端点，或通过 Ollama、vLLM 或 SGLang 使用本地及自托管推理。
• 连接的服务需要各自完成设置和身份验证。
• 终端、本地浏览器和 VS Code GUI 无需 Codewhale 账户；托管网页和桌面端需要账户。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。