它是什么？简单说：一个跑在终端里的 AI 编程智能体，专为 DeepSeek V4 模型打造。你在终端里输入指令，它就能帮你读代码、写代码、执行命令、管 Git，100 万 token 的上下文窗口，开箱即用。
这篇教程把从安装到跑通第一个任务的完整流程走一遍。
安装：5 分钟搞定
DeepSeek TUI 支持多种安装方式，对大多数用户来说，npm 一行命令最简单。
# 确保装了 Node.js（建议 v18+），然后执行 npm install -g deepseek-tui
安装完成后，执行以下命令验证：
deepseek --version
macOS 用户如果遇到「无法验证开发者」提示，执行：
xattr -d com.apple.quarantine $(which deepseek)
其他安装方式（cargo 源码编译、下载预编译包）可参考官方文档。
配置：绑定你的 DeepSeek API Key
DeepSeek TUI 完全基于 DeepSeek API 运行，需要先获取 API Key。
打开 https://platform.deepseek.com/api_keys，登录后创建新 Key，复制保存。
然后在终端执行认证：
deepseek auth set --provider deepseek # 按提示粘贴你的 API Key，回车即可
配置文件位于 ~/.deepseek/config.toml，如需手动配置也可以直接编辑该文件。
启动：第一个任务
安装配置完成后，在任意目录下启动：
deepseek
TUI 界面启动后，你会看到三个模式可选：
- Plan 模式：让 AI 先分析任务、制定计划，你确认后再执行，适合复杂任务
- Agent 模式：AI 自动执行，适合明确的小任务
- YOLO 模式：直接执行，不确认，适合简单快速的活
实操一下，从创建一个简单的 Python 脚本来测试：
请帮我写一个脚本，功能是：读取当前目录下所有 .txt 文件，统计每个文件的行数，输出到 result.txt
DeepSeek TUI 会自动分析当前目录结构、写脚本、执行，并展示思考模式的流式输出——你能实时看到 AI 推理的全过程。
几个实用功能
1. 思考模式流式输出
启用 deepseek-v4-pro 或 deepseek-v4-flash 模型时，AI 的推理过程会实时展示在终端里，适合学习 AI 的解题思路。
2. Git 自动备份
开启后，每次执行写操作前会自动 git commit，出现问题可以快速回滚。配置方法：在 config.toml 中设置 enable_git = true。
3. MCP 扩展
支持 Model Context Protocol，可以接入自定义工具。文档在 docs/MCP.md。
4. 多 Agent 协作
复杂任务可以并发启动多个子 Agent，分别处理不同模块，适合大型项目的拆解式开发。
几点说明
DeepSeek TUI 目前最新版本为 v0.8.8，2026 年 5 月初刚更新，支持 Linux ARM64（包括鲲鹏、树莓派、Graviton 等平台）。
它和 Claude Code、Cursor 等工具最大的区别在于：底层为 DeepSeek 原生定制，在使用 DeepSeek API 计量计费的场景下，成本大约是 Claude Code 的三分之一到五分之一，适合对成本敏感的团队。
如果你想在本地跑完整的 AI 编程工作流，DeepSeek TUI 是目前门槛最低、性价比最高的选择之一。
资源链接
- GitHub：https://github.com/Hmbown/DeepSeek-TUI
- npm：
npm i -g deepseek-tui - 官方文档：项目内的 docs/ 目录
