DeepSeek TUI 已改名为 CodeWhale
这个项目上游已经改名。现在的新安装命令应优先使用 npm install -g codewhale，启动命令也应优先使用 codewhale。
旧的 deepseek / deepseek-tui 目前仍作为兼容 shim 存在，但上游已经说明它们只是过渡方案，并计划在 v0.9.0 移除。
npm 安装
如果你是搜 DeepSeek TUI 进来的，现在该用 npm 安装的是 CodeWhale
项目上游已经改名，但真正的安装判断还是看你的 Node 工作流。如果你平时就通过 Node 管理终端工具，npm 路线通常最省事，只是现在应优先使用 CodeWhale 这套新包名和新命令。
本页是站内详情页用 npm 安装 CodeWhale（DeepSeek TUI 改名指南）安装
这页能直接回答的问题
- 什么时候该优先选 npm，而不是 cargo 或 Homebrew？
- 安装结束后最先该核对什么？
- 哪些失败其实是 Node PATH 问题，而不是 CodeWhale 自己坏了？
做完后该核对什么
- 在新开的 shell 里跑 `codewhale --version`，不要只在当前安装窗口测试。
- 先确认 API Key 和 provider 配置是否准备好了，再判断是不是安装失败。
- 如果命令存在但行为异常，下一步应先查配置和环境变量。
最常见的误区
- 用一套 Node 管理方式安装，却在另一套 shell 环境里测试。
- 把 provider 认证报错误判成安装失败。
- 升级了 npm 包，却从来不核对 shell 实际调用的是哪个二进制。
推荐阅读顺序
先按当前问题走，再决定要不要切去相邻详情页或 hub。
先确认运行时
安装前先跑 `node --version` 和 `npm --version`。如果这一步就不稳，后面装工具只是把问题往后推。
只保留一条全局安装路径
尽量保持一条明确的全局 npm 安装路线，不要把系统 Node、nvm 和手动拷贝二进制混在一起。
安装后立即查当前命令
安装完成后就核对 `codewhale` 命令到底来自哪里，确保和你认为的 npm 路径一致。
直接可用的示例
先拿可执行例子，再回头做更细的调整。
最快的 npm 安装路径
只保留一条全局 npm 路线，然后在新 shell 里验证，不要只相信安装窗口里的结果。
npm install -g codewhale
codewhale --version
command -v codewhale || which codewhale如果你本来就在用 nvm 或 fnm
安装和验证都放在同一套 Node 管理器 shell 里完成，避免把不同运行时的包归属混在一起。
node --version
npm --version
npm install -g codewhale
codewhale --version常见失败分支
先判断你卡在哪一层，再去对应分支，不要把所有问题都混成一个。
安装命令成功了，但 `codewhale` 不存在
这通常是 PATH 或 shell profile 问题，不是 npm 包本身失败。先去看 command-not-found 排错，不要先重装。
一个终端里能跑，另一个终端里不能跑
说明 Node 管理器或 shell 启动文件在不同 terminal profile 里不一致。先比 shell，再动应用。
什么时候该离开这页
当你已经确认当前路线没问题，就不要继续停留在这页。安装线应转去配置，配置线应转去 provider 或排错，MCP 和模式线则应该转回真实工作流页。详情页的价值是把问题缩窄，而不是长期停留在解释层。