【agent】从 DeepSeek-TUI 到 CodeWhale：终端 AI 编程助手安装与基础设置实录

关键词：DeepSeek-TUI / CodeWhale / 终端 AI 编程 / 开源 / 国产模型
写作日期：2026-08-12

一、缘起：为什么想试这个工具

最近一直在关注国产大模型的落地工具。一方面，工作中对数据安全与自主可控的要求越来越高，AI 编程类工具的选择需要更审慎；另一方面，DeepSeek V4 系列（尤其是 Flash 版）的性价比和 Agent 能力确实能打，缺的是一个趁手的“壳”——一个能把它跑起来的终端智能体。

直到看到 DeepSeek-TUI——被社区称为“DeepSeek 版 Claude Code”的开源终端编程智能体。Rust 编写、MIT 协议、键盘驱动、原生支持 1M 上下文……正好是我想要的样子。于是我决定亲自装一遍，把过程和坑记录下来。

二、它是谁：DeepSeek-TUI 改名 CodeWhale

先说个背景：这个项目已经改名了。

• 原名 DeepSeek-TUI，由独立开发者 Hunter Bown 打造（与 DeepSeek 官方无隶属关系）
• 2026 年五一假期在 GitHub 引爆：4 天迭代 10 个版本，星标从数百飙到 1.2 万+，一度登顶全球热榜
• 2026 年 7 月正式更名为 CodeWhale：v0.8.66 完成名称切换，v0.9.0 起移除 deepseek / deepseek-tui 旧命令，旧 npm 包停止更新
• 项目定位：支持 30+ 模型厂商（DeepSeek、Claude、GPT、Kimi、GLM…）以及 Ollama / vLLM / SGLang 本地模型

所以现在装它，认准 CodeWhale 这个名字，别再搜旧名了。

三、安装：三种方式，选一个就行

我装的时候 v0.8.67，官方给了 npm / Cargo / 脚本三种主流方式：

# 方式一：npm（最省事）
npm install -g codewhale

# 方式二：Cargo（需要 Rust 1.88+）
cargo install codewhale-cli --locked
cargo install codewhale-tui --locked

# 方式三：官方脚本
curl -fsSL https://.../install.sh | sh

我选了 npm 方式，装完直接 codewhale 回车就进 TUI 了，没有额外依赖，体验顺畅。

⚠️ 如果你是旧版用户，注意迁移：npm uninstall -g deepseek-tui && npm install -g codewhale，状态目录会从 ~/.deepseek/ 迁到 ~/.codewhale/，旧数据仍可读、自动兼容。

四、首次启动：先过“宪法”这一关

第一次启动，迎面而来的是 Constitution（宪法）设置向导——这可能是这个工具最“与众不同”的设计：

“这里的‘代码’有两层含义：你交付的软件，以及 CodeWhale 与你协作的长期准则。起草你的宪法——简短、持久、可修订。”

它不是让你填一堆配置，而是定义“AI 怎么跟你干活”的长期约定，跨会话生效。向导给出六个维度，默认值很合理：

维度	默认值	含义
用途	编码工作台	角色定位
主动性	平衡	主动 vs 等待的度
证据	测试/凭据	结论要有依据
沟通	简洁	回答风格
隐私	标准保护	数据边界
原则	小范围改动	小步提交

操作也很简单：1-6 调维度，F 输入自己的自由原则，A 让 deepseek-v4-pro 起草一版，连按两次 G 预览并批准——未经确认绝不保存。我这次先按 U 用了内置宪法（对，选择内置/默认也是有效完成方式），等熟悉了再定制。

重点提醒：宪法只指导行为风格，不会放开沙盒、Shell、网络、信任或 MCP 权限——安全边界是写死的，这点对生产环境很重要。

五、复核视图：看懂这份“体检报告”

设置完进复核（check）视图，它把设置状态汇总成一张清单，标注每步是 已验证 / 未开始 / 可选。我当时的实际状态：

服务商与模型  已验证 (必需) · 0.8.67
              provider=deepseek, model=deepseek-v4-pro
              auth=present/local, health=not checked
运行姿态      未开始 (必需)
你的宪法      未开始 (必需)
Operate/Fleet 未开始 (可选)
Hotbar / 工具与 MCP / 远程运行时 / 持久化  未开始 (可选)

同时能看到运行时姿态（Runtime Posture）——这是理解权限模型的关键：

intent=agent, approval=suggest, shell=enabled,
trust=workspace, sandbox=default, network=prompt by default

翻译一下：以 Agent 方式运行、建议式批准、Shell 已启用、信任边界是当前工作区、沙箱默认、网络访问默认需要确认。也就是说，它不是“无脑放开权限”，而是在可控范围内给你自主性——这个设计理念值得点赞。

六、持久化：文件都放哪了

用 /setup 还能看持久化路径（纯展示，不读内容、不改配置）：

文件	路径	我的状态
配置	~/.codewhale/config.toml	✅ present
设置状态	~/.codewhale/setup_state.json	✅ present
宪法	~/.codewhale/constitution.json	⚠️ missing（用内置）
记忆	~/.codewhale/memory.md	⚠️ missing（用到才生成）
笔记	~/.codewhale/notes.txt	⚠️ missing（用到才生成）

missing 都是正常的——用到才会生成，不用手动创建。

七、初体验与踩坑

装完跑了几个小任务（改代码、跑测试、看仓库结构），整体感受：

优点：

• ✅ 快：键盘驱动、轻量 TUI，几乎没有等待感
• ✅ 上下文大：1M 上下文，大项目不“断片”
• ✅ 自主可控：模型随便切（DeepSeek / 本地 Ollama），不被厂商绑定
• ✅ 权限模型清晰：Ask / Auto-Review / Full Access 三档，Tab 随时切

踩的坑 / 待解决：

• ⚠️ Windows 安装器未签名，会触发 SmartScreen 提示（我走 npm 没遇到）
• ⚠️ 输入缓存命中率社区反馈偏低（老版本问题，升级后观察）
• ⚠️ 首次设置时“运行姿态”和“宪法”还标着“未开始”——下一步把这两步补完，再配一套自己的宪法

八、下一步计划

1. 补完“运行姿态”和“宪法”两个必需步骤，写一版自己的自由原则
2. 试试 /model --project 按项目固定模型，以及 --model auto 自动路由
3. 接一个本地 Ollama 模型做纯离线场景验证
4. 对比一下它和 WorkBuddy / 其他国产 Agent 在编码场景的实际差距

九、结语

从 DeepSeek-TUI 到 CodeWhale，这个项目最打动我的不是星标数，而是两点：把选择权还给用户（模型随便换、本地能跑）和把安全边界写死（宪法管行为、权限管边界，两者分离）。对于“既要效率、又要自主可控”的场景，它确实是一个值得长期跟踪的工具。

等我把宪法和运行姿态配完、跑一段时间真实任务，再写一篇深度使用体验。

---

本文基于 CodeWhale v0.8.x 实际安装与设置过程整理；工具仍在快速迭代，以官方文档为准。