DeepSeek TUI 安装配置极速指南（Win / Mac / Linux）

🐣 国内小白也能3分钟搞定！

❤️ 专为国内用户优化｜🗂️ Windows / macOS / Linux 全平台覆盖｜⚡ 安装步骤极简｜🎯 看了就会，装了就能用！

你是不是也受够了------想用 AI 写代码还要在浏览器和编辑器之间来回切窗口？😩 现在有个神器，可以直接住进你的终端里，读代码、改 bug、跑命令、查资料，全都一句话搞定！💬

说的就是 DeepSeek TUI，一个完全跑在终端里的 AI 编程搭子。背后是 DeepSeek 大模型，拥有超长上下文，能实时展示推理过程，还能操作文件、执行 shell、管理 git......酷毙了！🔥

这篇教程专门为国内新手小白重新编排，把安装步骤放在最前面，镜像加速直接植入每一步，让你以最快速度装上并跑起来！🚀

📑 目录（跟着走，不迷路）

步骤	内容
⚡	[5 分钟快速通道（心急就看这）](#步骤内容 ⚡ 5 分钟快速通道（心急就看这） 🔑 第一步：获取 DeepSeek API Key 💻 第二步：安装 DeepSeek TUI（Windows 优先） ⚙️ 第三步：配置与首次启动 🎮 第四步：快速上手（常用命令/快捷键） 🐛 遇到问题？常见排查 🎁 深入了解：DeepSeek TUI 能干啥？ 🎉 结语与资源)
🔑	[第一步：获取 DeepSeek API Key](#步骤内容 ⚡ 5 分钟快速通道（心急就看这） 🔑 第一步：获取 DeepSeek API Key 💻 第二步：安装 DeepSeek TUI（Windows 优先） ⚙️ 第三步：配置与首次启动 🎮 第四步：快速上手（常用命令/快捷键） 🐛 遇到问题？常见排查 🎁 深入了解：DeepSeek TUI 能干啥？ 🎉 结语与资源)
💻	[第二步：安装 DeepSeek TUI（Windows 优先）](#步骤内容 ⚡ 5 分钟快速通道（心急就看这） 🔑 第一步：获取 DeepSeek API Key 💻 第二步：安装 DeepSeek TUI（Windows 优先） ⚙️ 第三步：配置与首次启动 🎮 第四步：快速上手（常用命令/快捷键） 🐛 遇到问题？常见排查 🎁 深入了解：DeepSeek TUI 能干啥？ 🎉 结语与资源)
⚙️	[第三步：配置与首次启动](#步骤内容 ⚡ 5 分钟快速通道（心急就看这） 🔑 第一步：获取 DeepSeek API Key 💻 第二步：安装 DeepSeek TUI（Windows 优先） ⚙️ 第三步：配置与首次启动 🎮 第四步：快速上手（常用命令/快捷键） 🐛 遇到问题？常见排查 🎁 深入了解：DeepSeek TUI 能干啥？ 🎉 结语与资源)
🎮	[第四步：快速上手（常用命令/快捷键）](#步骤内容 ⚡ 5 分钟快速通道（心急就看这） 🔑 第一步：获取 DeepSeek API Key 💻 第二步：安装 DeepSeek TUI（Windows 优先） ⚙️ 第三步：配置与首次启动 🎮 第四步：快速上手（常用命令/快捷键） 🐛 遇到问题？常见排查 🎁 深入了解：DeepSeek TUI 能干啥？ 🎉 结语与资源)
🐛	[遇到问题？常见排查](#步骤内容 ⚡ 5 分钟快速通道（心急就看这） 🔑 第一步：获取 DeepSeek API Key 💻 第二步：安装 DeepSeek TUI（Windows 优先） ⚙️ 第三步：配置与首次启动 🎮 第四步：快速上手（常用命令/快捷键） 🐛 遇到问题？常见排查 🎁 深入了解：DeepSeek TUI 能干啥？ 🎉 结语与资源)
🎁	[深入了解：DeepSeek TUI 能干啥？](#步骤内容 ⚡ 5 分钟快速通道（心急就看这） 🔑 第一步：获取 DeepSeek API Key 💻 第二步：安装 DeepSeek TUI（Windows 优先） ⚙️ 第三步：配置与首次启动 🎮 第四步：快速上手（常用命令/快捷键） 🐛 遇到问题？常见排查 🎁 深入了解：DeepSeek TUI 能干啥？ 🎉 结语与资源)
🎉	[结语与资源](#步骤内容 ⚡ 5 分钟快速通道（心急就看这） 🔑 第一步：获取 DeepSeek API Key 💻 第二步：安装 DeepSeek TUI（Windows 优先） ⚙️ 第三步：配置与首次启动 🎮 第四步：快速上手（常用命令/快捷键） 🐛 遇到问题？常见排查 🎁 深入了解：DeepSeek TUI 能干啥？ 🎉 结语与资源)

⚡ 5 分钟快速通道（心急就看这）

适用于 Windows / macOS / Linux，复制粘贴即可，全程国内网速友好！

bash 复制代码

# 1. 获取 API Key（浏览器操作 1 分钟）
#    打开 https://platform.deepseek.com → 注册登录 → API Keys → 创建密钥 → 复制 sk-xxx

# 2. 安装（命令行执行，二选一）
#    a) 有 Node.js 的用户：
npm install -g deepseek-tui --registry=https://registry.npmmirror.com
#    b) 没有 Node.js？先去 https://nodejs.org 下载安装，再用上面命令，或看下方各平台其它安装方式

# 3. 配置密钥
deepseek auth set --provider deepseek
#    输入你复制的 sk-xxx

# 4. 启动！
deepseek

🎉 顺利的话，你已经进入 TUI 界面，可以打字让 AI 帮你写代码啦！如果中间遇到问题，后面有详细分步教程和故障排查～

🔑 第一步：获取 DeepSeek API Key

想要让 AI 帮你干活，得先有"钥匙"哦～🔑

🌐 浏览器访问 DeepSeek 开放平台：https://platform.deepseek.com
📝 注册 / 登录你的 DeepSeek 账号
🧭 左侧边栏找到 「API Keys」，点击进入
🔘 点击 「创建 API Key」 ，起个名字（比如 deepseek-tui-key）
📋 立刻复制并保存密钥 ！格式类似 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ 重要：密钥只显示一次！一定要立刻复制保存。丢了就只能重新创建一个。

💰 费用：按使用量付费，价格非常划算，个人开发基本几块钱用一个月。

💻 第二步：安装 DeepSeek TUI

下面按 Windows → macOS → Linux 的顺序给出了最简单的安装方法，每一种都内置了国内镜像加速，再也不用担心下载龟速啦！

🪟 Windows 安装（最推荐这种方式⭐）

首选：npm 安装（自带国内镜像）

如果你电脑上有 Node.js，直接打开 PowerShell 执行：

powershell 复制代码

npm install -g deepseek-tui --registry=https://registry.npmmirror.com

✅ 就这么一行，npm 会自动下载 Windows 预编译程序，装完就能用！

如果还没装 Node.js？

打开 https://nodejs.org ，下载左侧 LTS 版本（推荐 18+）
双击安装包，一路点「Next」完成安装

重新打开 PowerShell，验证：

powershell 复制代码

node --version   # 显示 v18.x.x 或更高
npm --version    # 显示 9.x.x 或更高

然后执行上面的 npm install -g deepseek-tui --registry=https://registry.npmmirror.com

备用方案：直接下载 .exe 文件（完全不用装任何工具）

浏览器打开 https://github.com/Hmbown/DeepSeek-TUI/releases
下载 deepseek-tui-windows-x64.zip，解压得到 deepseek.exe 和 deepseek-tui.exe
把这两个 exe 放到一个文件夹（比如 C:\deepseek）
将该文件夹添加到 PATH 环境变量 ：
- 按 Win + X → 「系统」→ 「高级系统设置」→ 「环境变量」
- 在「系统变量」中找到 Path，编辑，添加 C:\deepseek，保存
重新打开终端，执行 deepseek --version 验证

🖥️ 强烈建议使用 Windows Terminal（微软商店免费下载）运行 DeepSeek TUI，老版 CMD 可能显示不正常哦～

🍎 macOS 安装

首选：Homebrew 安装（一键搞定）

bash 复制代码

brew tap Hmbown/deepseek-tui
brew install deepseek-tui
deepseek --version   # 验证安装

备选：npm 安装（国内网速更快）

bash 复制代码

npm install -g deepseek-tui --registry=https://registry.npmmirror.com
deepseek --version

如果没有 Node.js，先去 https://nodejs.org 下载 macOS 安装包，18+ 版本即可。

🐧 Linux 安装

首选：npm 一键安装（国内镜像加速）

bash 复制代码

npm install -g deepseek-tui --registry=https://registry.npmmirror.com
deepseek --version

若提示权限不足，前面加 sudo；若没有 Node.js，可通过系统包管理器安装，例如 Ubuntu 执行 sudo apt install nodejs npm。

备选：直接下载预编译二进制

从 https://github.com/Hmbown/DeepSeek-TUI/releases 下载对应架构的 .tar.gz 文件，解压后放入 /usr/local/bin：

bash 复制代码

# 以 x86_64 为例
tar -xzf deepseek-tui-linux-x64.tar.gz
sudo mv deepseek deepseek-tui /usr/local/bin/
deepseek --version

其它安装方式（Docker、Cargo 源码编译等）可参考文末进阶资源中的项目仓库。

⚙️ 第三步：配置与首次启动

🔑 配置 API Key

交互式配置（最简单）

bash 复制代码

deepseek auth set --provider deepseek

按提示粘贴你的 sk-xxx 密钥。密钥会自动保存，以后哪都能用～

环境变量配置（适合脚本）

bash 复制代码

# 临时使用
export DEEPSEEK_API_KEY="你的sk-xxx"

# 永久生效（bash 用户写 ~/.bashrc，zsh 用户写 ~/.zshenv）
echo 'export DEEPSEEK_API_KEY="你的sk-xxx"' >> ~/.zshenv
source ~/.zshenv

🚀 启动 TUI 界面

bash 复制代码

# 直接启动
deepseek

# 或者指定某个项目目录启动
deepseek --cwd /你的项目路径

看到酷炫的 TUI 界面后，就可以开始和 AI 对话啦！👋

🩺 检查配置是否成功

bash 复制代码

deepseek doctor

全部绿色 ✅ 就说明一切就绪。

🎮 第四步：快速上手（常用命令 & 快捷键）

🤖 三种工作模式

模式	说明	适合场景
🕵️ Plan	只读探索，AI 不动你文件	第一次用，先看看 AI 的理解
🤖 Agent	默认模式，操作前需你批准	日常写代码，安全可控
⚡ YOLO	自动批准，AI 可以自由发挥	完全信任 AI，效率起飞

⌨️ 必知快捷键

快捷键	作用
`Shift + Tab`	切换推理强度（off → high → max）
`Ctrl + R`	恢复历史会话
`Ctrl + C`	中断当前操作
输入 `/`	进入命令模式

📝 其他实用命令

bash 复制代码

deepseek --version                 # 查看版本
deepseek doctor                    # 诊断配置
deepseek auth clear --provider deepseek  # 清除密钥
deepseek --help                    # 查看所有命令

🔄 如何更新 DeepSeek TUI

bash 复制代码

# npm 安装的
npm update -g deepseek-tui

# Homebrew 安装的
brew upgrade deepseek-tui

🐛 遇到问题？常见排查

❓ 提示 "deepseek: command not found"

原因：系统找不到 deepseek 命令。
解决：

macOS/Linux：确认 ~/.cargo/bin 或 /usr/local/bin 在 PATH 中，或重启终端
Windows：检查安装文件夹是否已添加到系统 Path 环境变量

❓ Windows 终端闪屏、显示乱码

原因：CMD 或旧版 PowerShell 渲染能力不足。
解决：安装 Windows Terminal（微软商店免费下载），在里面运行 deepseek

❓ API Key 配置后提示认证失败

可能原因 ：密钥复制不完整、账户余额不足、密钥失效
解决：

bash 复制代码

deepseek auth clear --provider deepseek
deepseek auth set --provider deepseek   # 重新粘贴完整密钥
deepseek doctor                         # 验证

❓ npm 安装下载太慢或失败

解决：已默认带镜像，如果还慢可手动指定：

bash 复制代码

npm install -g deepseek-tui --registry=https://registry.npmmirror.com

❓ 更新不及时，想用最新版

去 GitHub Releases 直接下载最新预编译包覆盖安装。

🎁 深入了解：DeepSeek TUI 能干啥？

当你已经成功安装并跑起来，再来看看这位终端里的 AI 伙伴到底有多强大：

🧠 流式思考展示：实时观察模型的推理过程，就像看 AI 一步步思考
🔧 完整工具包：读写文件、执行 shell 命令、管理 git、搜索网页、打补丁、子智能体......
📚 100 万 token 上下文：整个代码仓库扔进去毫无压力
💾 会话保存与恢复：长任务中断了还能接着来
⏪ 工作区一键回滚：每次操作前后自动保存快照，出错随时恢复
📦 MCP 协议扩展：可以连接外部工具服务器，能力无限扩展
🔍 LSP 实时报错：代码编辑后立刻给出错误/警告（支持 Rust、Python、TS 等）
💰 成本透明：实时显示 token 用量和花费，每一分钱都清楚
🌍 多语言界面：中文、English、日本語......切起来随手就来

一句话总结：它就是你终端里的全能编程助手，从读代码到改代码，从运行命令到搜索网页，全搞定！

🎉 结语与资源

🎊 恭喜！现在你已经拥有了一个跑在终端里的 AI 编程搭子，遇到问题随时敲 deepseek 开聊～

刚开始推荐用 Plan 模式 熟悉，慢慢过渡到 Agent 模式，最后试试 YOLO 模式的高速体验！😎

🔗 实用链接

资源	地址
📖 项目仓库	GitHub - Hmbown/DeepSeek-TUI
📄 官方中文说明	README.zh-CN.md
🔌 MCP 扩展文档	docs/MCP.md
📥 所有版本下载	GitHub Releases
🔑 DeepSeek 开放平台	platform.deepseek.com
🐳 Docker 镜像	ghcr.io/hmbown/deepseek-tui

📢 本指南基于 DeepSeek TUI v0.8.29 编写，工具更新频繁，最新特性以官方仓库为准。

如果这篇教程帮到了你，别忘了去给作者 Hmbown 点个 ⭐ Star，也欢迎分享给更多需要的小伙伴～ 🥰

Happy Coding！🚀✨