改名过渡

DeepSeek TUI 已改名为 CodeWhale,这个中文站现在把旧名字当成迁移入口来处理

如果你是搜 DeepSeek TUI 进来的,先记住最关键的一点:新的安装和启动命令应该优先使用 CodeWhale。然后再按顶部主菜单进入安装、配置、文档或排错栏目。

npm install -g codewhale
codewhale --version
codewhale --model auto
先看改名说明主菜单先选栏目先列表后详情中文英文结构一致
$ Quickstart
$ npm install -g codewhale
$ codewhale --version
$ codewhale --model auto
先用新包名安装,再确认当前二进制,最后进入自动模型选择。

改名说明:DeepSeek TUI 现在叫 CodeWhale

上游项目已经正式改名。新安装应优先使用 npm install -g codewhale,启动命令也应优先使用 codewhale

旧的 deepseek / deepseek-tui 目前还作为兼容 shim 保留,但上游已说明这只是过渡方案,并计划在 v0.9.0 移除。

先选一个主栏目

这些就是顶部主菜单里的主要分支。先决定你现在是安装、配置、文档、模式还是排错问题,再进入对应栏目页。

安装

安装

先决定走 npm、cargo、Homebrew 还是 Windows 路线,再进对应文章。

打开安装栏目
文档

文档

如果你想按主题看架构、运行时 API、快捷键和上游文档,这条分支最直接。

打开文档栏目
配置

配置

如果命令已经能跑,但 provider、API Key 或运行参数还不稳,这条分支最合适。

打开配置栏目
MCP

MCP

如果你现在关心的是工具接入、外部上下文和高级扩展,这条分支更适合。

打开 MCP 栏目
模式

模式

如果你要在 plan mode 和 yolo mode 之间做选择,这条分支会更省时间。

打开模式栏目
技能

技能

如果你关心的是可复用工作流,而不是一次性 prompt,这条分支最相关。

打开技能栏目
对比

对比

如果你还在比较 DeepSeek TUI 和其他终端代理工具,这条分支更适合。

打开对比栏目
排错

排错

如果问题已经出现,先分清楚是安装、路径、provider 还是 MCP 问题。

打开排错栏目
资讯

资讯

如果你想先理解这个工具为什么还在以 DeepSeek TUI 旧名字被持续搜索,以及 CodeWhale 改名意味着什么,可以先走这条线。

打开资讯栏目

怎么使用这套结构

中文站现在也按文档产品的思路工作,不再只是平铺一堆文章入口。

步骤 1

先从顶部主菜单选栏目

先判断你现在是安装、配置、文档、模式还是排错问题,不要一上来点具体文章。

看一个栏目页
步骤 2

再用左侧副菜单当栏目清单

进入某个栏目后,左边副菜单会列出这条分支里的总页和详情页,不用再回首页找。

看副菜单结构
步骤 3

最后再进真正需要的详情页

当问题已经缩小到 npm 安装、API Key、plan mode 或 MCP setup 这一级时,再开详情页。

看一篇详情页

最常用的详情页

这些通常是用户在先选好栏目之后,下一步最常打开的文章。

安装

用 npm 安装 CodeWhale

如果你已经确定走 Node 全局 CLI 路线,这篇是最快的详情页。

打开 npm 安装
配置

CodeWhale API Key 设置

如果命令能跑,但 provider 或认证还不通,这篇通常是下一步。

打开 API Key 页
文档

架构文档

如果你已经不是在装工具,而是在理解工具结构,这篇更合适。

打开架构文档
模式

Plan mode vs yolo mode

如果你知道两个名字,但还没决定用哪个模式,这篇更直接。

打开模式对比
改名

DeepSeek TUI 改名为 CodeWhale

如果你最关心的是新旧命令、包名和迁移说明,这篇应该先看。

打开改名页
对比

CodeWhale vs Claude Code

如果你现在的真实问题是选工具,而不是配工具,这篇更相关。

打开对比页
排错

MCP 排错

如果基础命令能跑,但 MCP 这一层出问题,这篇是更具体的入口。

打开 MCP 排错