新手指引

安装 Codewhale，连接模型，然后交给它一项任务。Fleet 配置为可选步骤。

1. 01

   安装 Codewhale

   下方命令会在 macOS 或 Linux 上安装最新发布版本。Windows、包管理器以及未发布候选版的源码构建方式，请参阅安装指南。

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

   完整安装指南 →
2. 02

   连接你的模型

   模型回复需要连接云端或本地模型。你可以使用自己的提供商密钥（下方以 DeepSeek 为例），或按提供商指南连接其他服务和本地模型。离线配置不需要密钥。

   codewhale auth set --provider deepseek

   选择提供商 →
3. 03

   交给它一项任务

   在项目文件夹中打开 Codewhale。先用 /mode plan 让它解释项目；需要修改文件或运行命令时，再切换到 /mode work。Shift+Tab 切换审批设置，/provider 和 /model 用于更改模型连接。

   codewhale

   模式与权限 →
4. 04

   需要时配置 Fleet

   当任务需要多个模型和角色配合时，可以在 Codewhale 中运行 /fleet setup 来配置团队，然后在 shell 中用 codewhale fleet status 查看已保存的 Fleet。

   /fleet setup
   codewhale fleet status

   Fleet 与 Workflow 文档 →

接下来