终端原生的水下壳。模型与提供商中立。本地优先。
连接你已有的托管、网关或本地模型。Codewhale 在你的机器上运行；模型是可选择的组件，不是产品本身。Plan / Act / Operate 与明确的审批边界，让深潜也保持可控。
从任务到经过验证的改动。
- 01
检查
读取仓库、项目说明与任务。
- 02
执行
在明确的审批边界内修改文件。
- 03
验证
运行检查并核对结果。
- 04
报告
留下简洁、可追溯的工作收据。
$ codewhale exec "fix the failing test"inspect repository and instructionsact edit through the selected permission postureverify cargo test --lockedreport checks passed · receipt saved
第一次使用？四步走完。
安装 → 无需密钥的首次会话 → 连接提供商 → 第一个 Fleet Workflow。名词含义见产品名词页。
安装 Codewhale
一条 npm 命令即可安装调度器和终端运行时。Cargo、预编译包、Docker、Nix 和中国镜像是有文档的备选渠道；所有渠道只提供已发布版本。
完整安装指南 →npm install -g codewhale codewhale doctor打开第一个会话——无需密钥
运行时无需任何 API 密钥即可启动：先走过一段简短的宪法优先设置（语言、提供商就绪情况、运行姿态、你的宪法），然后进入完整界面。在 Plan 模式中探索——它始终只读。模型回复需要提供商；这正是下一步。
先了解产品名词 →codewhale连接提供商
任选一条受支持的路由——托管密钥、网关，或 Ollama、vLLM、SGLang 等免密钥本地运行时（推理完全在本地）。Provider 与模型始终明确；请求与实际思考档位及路由来源是分开的来源字段，暂不可用的值保持暂不可用。
提供商与模型 →codewhale auth set --provider deepseek运行第一个 Fleet Workflow
当工作需要持久 worker、有序阶段或收据时，编写可复用的 agent 团队档案并启动运行。Fleet 状态保存在工作区台账中，重启后依然存活；普通的单一任务不需要这些。
Fleet 与 Workflow 文档 →codewhale fleet init codewhale fleet run tasks.json --max-workers 4
你的模型。
你的边界。
显式选择模型、工作模式与权限姿态。Codewhale 不会把未知成本显示成零，也不会把预览功能说成已发布产品。
- 36 个提供商路由
- 托管、网关与本地模型
- Plan · Act · Operate
- 从只读规划到自主执行
- Ask · Auto-Review · Full Access
- 为任务选择权限姿态
- TUI · exec · web · API
- 交互式与无头运行时界面
在工作发生的地方使用运行时。
TUI交互式终端工作
codewhale exec脚本与 CI
Web 客户端仅限本机回环的浏览器客户端
运行时 API + MCP本地集成
Fleet持久化多智能体工作
从一条命令开始。
公开构建
Codewhale 采用 MIT 许可证，由来自不同时区、语言和技术背景的贡献者共同塑造。
