Whale

Whale 快速入门

专为 DeepSeek 打造的终端 AI 编程 Agent——98% 缓存命中率，1M 上下文，Rust 底层极速响应，编程成本降至几分钱

⭐ 评分: 8.2/10 💰 价格: 开源免费 🏢 厂商: usewhale 🌐 官网: GitHub

一、这是什么

Whale 是一个专为 DeepSeek 优化的终端 AI 编程 Agent。它的核心理念是”极致效率”——通过 DeepSeek 的 prompt 缓存机制，Whale 实现了约 98% 的缓存命中率，这意味着每次编码对话的 token 消耗极低，成本降至几分钱。

Whale 由 Go 语言编写（Rust 底层），支持三种交互模式：

• TUI（终端交互界面）：日常编码对话，支持实时 diff 预览
• CLI（命令行）：一次性问答、代码审查
• Headless（无头模式）：CI/CD 集成、自动化 PR 审查

支持 MCP 协议（可连接 1000+ 工具服务器）、Skills 和 Plugins 系统、Subagents 子 Agent 角色定义。特别值得一提的是 Dynamic Workflows——用 JavaScript 编写多 Agent 编排脚本，与 Claude Code 的 workflow 格式兼容。

Whale 明确声明它不是”多模型外壳”——它专注 DeepSeek，为 DeepSeek 的缓存、工具调用和定价做了深度优化。如果你主要使用 DeepSeek，Whale 可能是最经济的编码 Agent 选择。

适合人群：DeepSeek 用户、追求低编程成本的开发者、喜欢终端工具的开发者。

二、快速上手

准备工作

• Node.js 18+（npm 方式）或 macOS/Linux/Windows 系统
• DeepSeek API Key（platform.deepseek.com 获取）
• 终端环境

安装

# npm 全局安装（所有平台）
npm install -g @usewhale/whale

# macOS Homebrew
brew install usewhale/tap/whale

# Linux 一键安装
curl -fsSL https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.sh | sh

# Windows PowerShell
irm https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.ps1 | iex

三步开始

Step 1：配置 API Key

whale setup

按提示输入 DeepSeek API Key。配置保存在 .whale/config.local.toml。

Step 2：启动 TUI

whale

进入终端交互界面，输入编程问题，Whale 会读取文件、执行命令、编辑代码。

Step 3：CLI 快速问答

whale ask "审查 src/ 目录下的代码安全问题"

一次性命令，输出结果后退出。适合 CI/CD 集成。

三、核心功能

~98% Prompt 缓存命中率

Whale 最核心的优势。DeepSeek 的 prompt 缓存机制允许重复的上下文前缀以极低价格计费。Whale 的上下文管理策略使得大多数对话的 prompt 都命中缓存，token 成本降低 90%+。实际体验：一次完整的编码会话成本可能只有几分钱。

1M 上下文窗口

充分利用 DeepSeek 的 1M token 上下文窗口。可以一次性加载整个代码库（或大部分）到上下文中，Agent 理解全局架构后再进行修改，避免”只见树木不见森林”。

Dynamic Workflows（动态工作流）

用 JavaScript 编写多 Agent 编排脚本。例如：

// 并行研究 + 汇总
const results = await parallel([
  () => agent("研究 Go 错误处理最佳实践"),
  () => agent("研究常见 Go 错误处理错误"),
]);
return agent("综合两方面的发现，写一份简明指南");

与 Claude Code 的 workflow 格式兼容，已有的 Claude Code workflows 可以直接在 Whale 中使用。

MCP + Skills + Plugins

• MCP：连接 1000+ 工具服务器（数据库、API、浏览器自动化）
• Skills：加载社区技能包（代码审查、Git 工作流等）
• Plugins：扩展 Whale 运行时
• Subagents：定义子 Agent 角色（审查员、研究员等）

三种交互模式

四、竞品对比

与 Claude Code 对比：Claude Code 是 Anthropic 官方 CLI 编程 Agent，功能强大但 API 成本较高。Whale 专注 DeepSeek，利用缓存将成本压至极低。Claude Code 的模型能力更强（Claude 4），Whale 的成本更低。Whale 的 Dynamic Workflows 与 Claude Code 兼容，两者可以互补使用。

与 Codex CLI 对比：Codex 是 OpenAI 的 CLI 编程 Agent，开源且功能丰富。Whale 更轻量，专注 DeepSeek 生态。Codex 适合多模型用户，Whale 适合 DeepSeek 用户追求极致性价比。

与 Godcoder 对比：Godcoder 是桌面 GUI 应用，Whale 是终端工具。Godcoder 适合喜欢图形界面的用户，Whale 适合终端爱好者。两者都支持本地运行，但 Whale 的缓存优化是独特优势。

五、常见踩坑

1. 必须使用 DeepSeek API——Whale 不是多模型工具，其他模型的 API 不兼容
2. Dynamic Workflows 默认禁用，需要在 TUI 中运行 /config 或在配置文件中启用 [workflows] enabled = true
3. Headless 模式下，需要预先配置好 API Key 和项目上下文，否则 Agent 可能无法正常工作
4. 项目较新（2026 年 5 月创建），910 Stars，功能还在快速迭代中，API 可能变化
5. 不是 DeepSeek 官方产品——是社区开源项目，与 DeepSeek Inc. 无关联

六、常见问题 FAQ

Q1: 为什么只支持 DeepSeek？

A: Whale 的设计目标是极致效率，DeepSeek 的 prompt 缓存是实现 ~98% 缓存命中率的关键。其他模型没有同等级别的缓存机制。Whale 明确声明不做”多模型外壳”。

Q2: 缓存命中率 98% 是真的吗？

A: 这是 Whale 官方宣称的数据。实际命中率取决于使用模式——如果你频繁切换项目或上下文，命中率会降低。在同一个项目中持续编码，命中率最高。

Q3: 和 Cursor 有什么区别？

A: Cursor 是 IDE 集成 Agent，Whale 是终端独立工具。Cursor 提供图形化代码补全和聊天，Whale 提供终端内的全功能 Agent。两者可以同时使用——Cursor 做日常编码，Whale 做复杂任务编排。

Q4: 能用于生产环境吗？

A: 官方建议先用于个人项目和实验性仓库。项目处于活跃开发阶段，适合”可以审查和回滚”的工作流。

Q5: 支持其他编程语言吗？

A: 支持。Whale 是通用编程 Agent，不限于特定语言。Go 和 Rust 项目可能有更好的体验（Whale 自身用这些语言编写）。

参考链接

• GitHub 仓库
• npm 包
• DeepSeek API
• MCP 协议

最后更新：2026-07-14 · 作者：MagicNetWorld