开始第一个任务
从什么都没装到完成第一个任务，只需四步。每一步都链接到详细说明页；配置 Fleet 这一步是可选的。
安装 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
探索终端界面
Codewhale 演示会话的实录画面。查看对话、任务工作栏、模型连接与帮助。
输入框中准备发送的后续消息。
▎ 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) ┃╭──────────────────────────────────────────────────────────────────────────────────────────────────╮│❯ Also cover an empty export. ││ [↵] │╰──────────────────────────────────────────────────────────────────────────────────────────────────╯ ● Full Access Shift+Tab to change work (Tab) Work bar (Ctrl+]) Command selected: /workbar off website-demo · website-demo context 7%
下一步
查看改动
查看一次会话中的每处修改，把文件回滚到之前的回合，并在推送前做一次代码审查。
设置模式与审批
用 Plan、Work、Operate 选择工作类型，用 Ask、Auto-Review、Full Access 决定它什么时候停下来问你。
连接你常用的工具
通过 MCP 连接邮件工具，再让 Codewhale 把可访问的邮件整理成行动清单。
在事件发生时运行命令
在会话开始、工具调用之前或回合结束时运行你自己的脚本。可以用它们补充上下文、执行规则或发送通知。