快速开始
几分钟内完成安装、配置并开始你的第一个 Whale 会话。
准备工作
- • 一个 DeepSeek API Key
- • macOS、Linux 或 Windows（PowerShell / Git Bash / Windows Terminal）
安装
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/usewhale/whale/main/scripts/install.sh | sh macOS (Homebrew)
brew install usewhale/tap/whale Windows (PowerShell)
irm https://raw.githubusercontent.com/usewhale/whale/main/scripts/install.ps1 | iex Windows (CMD)
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/usewhale/whale/main/scripts/install.ps1 | iex" 升级
brew upgrade usewhale/tap/whale
# 或重新运行安装脚本 配置
运行以下命令设置 DeepSeek API Key 并验证安装：
whale setup
whale doctor whale setup 会提示你输入 DeepSeek API Key。
whale doctor 运行健康检查确认一切正常。
使用方法
启动交互式 TUI
whale 启动终端界面，你可以与 AI Agent 对话、读写文件、运行命令等。
一次性任务执行
whale exec "解释一下这个项目的架构"
printf '总结当前目录\n' | whale exec 恢复之前的会话
whale resume
whale resume --last
whale resume <会话ID> 命令参考
| 命令 | 用途 |
|---|---|
| whale | 启动交互式 TUI |
| whale setup | 保存 API Key |
| whale doctor | 健康检查 |
| whale exec "提示" | 一次性执行 |
| whale --worktree [名称] | 隔离工作树会话 |
| whale resume | 会话选择器 |
斜杠命令（TUI 内）
| 命令 | 用途 |
|---|---|
| /ask [提示] | 只读问答 |
| /plan [提示] | 先计划再执行 |
| /review [目标] | 代码审查 |
| /compact | 压缩对话 |
| /focus | 切换专注视图 |
| /status | 显示会话状态 |
| /skills | Skills 菜单 |
| /memory | 查看/管理记忆 |
| /mcp | MCP 服务器状态 |