构建应用，让你的工作自动运行。
Codewhale 是一个开源智能体，可以编写代码、运行命令，并使用你连接的工具。你可以使用已有的模型 API，也可以在本地或自己的服务器上运行模型。
curl -fsSL https://codewhale.net/install.sh | sh
最新发布 v0.10.1未发布 v0.10.2MIT
▎ Local demo: add --json to export.py, run tests, and delegate a review. │╭ ✓ • tool done · 3/3 · 100% ││ ▏ checklist: todo_write ││ ▏ ☑ Inspect the export command ││ ▏ ☑ Add the --json flag │╰ ▏ ☑ Run tests and review the change │ │● JSON export is ready. │▏ │▏ Added --json while preserving CSV output. All 3 local tests passed, and the delegated review │▏ found no issues. ┃▏ ┃▏ Try: python3 export.py --json ┃▏ ┃▏ This session uses the local website-demo provider. ┃ ┃Note Workbar is off — no panel renders (/workbar bottom|top|left|right to show it) ┃╭──────────────────────────────────────────────────────────────────────────────────────────────────╮│❯ Type a message… ││ [·] │╰──────────────────────────────────────────────────────────────────────────────────────────────────╯ ● Full Access Shift+Tab to change work (Tab) Work bar (Ctrl+]) ← for agents · ↓ to manage website-demo · website-demo context 7%
你可以做什么
描述你想构建或自动完成的工作。Codewhale 可以编辑文件、运行命令并检查结果，访问权限由你控制。
- 构建应用和工具
- 创建应用、添加功能或编写脚本。Codewhale 可以处理项目文件、运行代码并测试构建结果。
- 让重复工作自动完成
- 从终端、脚本或 CI 中运行工作流。任务较大时，可以把部分工作交给使用不同模型的 Fleet 智能体团队。
- 连接你常用的工具
- 通过插件和 MCP 服务器添加工具，或在自己的脚本中调用 API。每项服务都需要单独配置和身份验证。
- 你的 API 账户
- 使用自己的密钥连接 OpenAI、Anthropic、Google、DeepSeek 等提供商。
- 你的网关
- 连接 OpenAI 兼容端点，选择它提供的模型。
- 你的推理服务
- 通过 Ollama、vLLM 或 SGLang 运行本地或自托管模型。
使用文件和工具开展工作
探索工具与集成- 文件与终端
- 创建文件、运行命令、分析数据，并测试你构建的成果。工作目录和权限由你设定。
- 插件与已连接的应用
- 通过插件和 MCP 添加技能与工具。审核并启用你希望智能体使用的连接。
- 浏览器与电脑操作 · 预览
- 使用浏览器工具和 Computer Use 插件，在你授予的访问范围内操作应用与网站。
- 随时接着做的会话
- 将对话、工具结果和工作记录保存在一起。在终端或本地浏览器客户端中继续之前的任务。
- 智能体团队
- 用 Fleet 将大任务分配给不同角色和模型的智能体，在一处查看它们的进度。
开始使用
安装 Codewhale，连接模型，然后打开项目文件夹。需要时，再添加插件或更多智能体。
安装 Codewhale
在 macOS 或 Linux 上安装最新发布版本。按安装程序的提示完成 PATH 设置，然后打开你想工作的文件夹。Windows 和其他安装方式见指南。
完整安装指南curl -fsSL https://codewhale.net/install.sh | sh连接你的模型
使用你已有的模型 API，或连接本地、自托管推理服务。下方命令用于保存 DeepSeek 密钥；本地 Ollama 模型无需 API 密钥。
连接模型提供商codewhale auth set --provider deepseek描述第一个任务
启动 Codewhale，说出你想要的结果：一个小应用、节省时间的脚本，或一份根据数据生成的报告。设定权限、查看它的工作，并随时调整方向。
设置模式与审批codewhale使用多个智能体
把较大的任务分配给不同角色、不同模型的智能体。在 Codewhale 中用 /fleet setup 保存团队，再用 /fleet status 查看运行状态。
配置 Fleet/fleet setup /fleet status
- 终端与本地浏览器
- 已发布在 Linux、macOS 或 Windows 上安装，然后运行 codewhale，或运行 codewhale web 打开本地浏览器客户端。也可以用 npm 或 Cargo 安装；Android 上的 Termux 版本为预览版。
- CodeWhale GUI（VS Code）
- 可用由社区维护的独立项目：在 VS Code 侧边栏中连接同一个 Codewhale Runtime，进行对话、管理线程并查看文件变更。可从 VS Code Marketplace 安装。
- 托管网页应用
- 开发预览正在重建，以与桌面应用保持一致。目前你可以登录，然后在正在运行的终端会话中输入 /rc，在网页上继续该会话；托管任务执行仍在验证中。
- 桌面端
- 开发版本正在成为 Codewhale 主要客户端的原生应用：文件夹、对话和模型连接集中在一个窗口中。暂无公开下载。
- 云端计算机
- 开发中为你运行任务的托管计算机。
终端、本地浏览器和 GUI 无需 Codewhale 账户。托管网页和桌面端使用账户。使用你自己的提供商密钥时，相应用量由该提供商计费。
为 Codewhale 做贡献
在 GitHub 上报告问题、改进文档或贡献代码。你也可以构建插件，与其他用户分享工作流。
在 macOS 或 Linux 上安装
GitHub Releases (预编译包) · npm · Cargo · Docker · Windows · Android / Termux · 中国镜像
阅读安装指南curl -fsSL https://codewhale.net/install.sh | sh