🐣 国内小白也能3分钟搞定！
DeepSeek TUI 安装配置极速指南（Win / Mac / Linux） ❤️ 专为国内用户优化｜🗂️ Windows / macOS / Linux 全平台覆盖｜⚡ 安装步骤极简｜🎯 看了就会，装了就能用！
你是不是也受够了——想用 AI 写代码还要在浏览器和编辑器之间来回切窗口？
😩 现在有个神器，可以直接住进你的终端里，读代码、改 bug、跑命令、查资料，全都一句话搞定！
💬 说的就是 DeepSeek TUI ，一个完全跑在终端里的 AI 编程搭子。
背后是 DeepSeek 大模型，拥有超长上下文，能实时展示推理过程，还能操作文件、执行 shell、管理 git……酷毙了！
🔥 📑 目录（跟着走，不迷路） 步骤内容 ⚡5 分钟快速通道（心急就看这）🔑第一步：获取 DeepSeek API Key💻第二步：安装 DeepSeek TUI（Windows 优先）⚙️第三步：完整配置与首次启动🎮第四步：快速上手（常用命令/快捷键）🐛遇到问题？
常见排查🎁深入了解：DeepSeek TUI 能干啥？
🎉结语与资源 ⚡ 5 分钟快速通道（心急就看这） 适用于 Windows / macOS / Linux ，复制粘贴即可，全程国内网速友好！
# 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 执行：
npm install -g deepseek-tui --registry=https://registry.npmmirror.com
✅ 就这么一行，npm 会自动下载 Windows 预编译程序，装完就能用！
如果还没装 Node.js？
打开 https://nodejs.org ，下载左侧 LTS 版本 （推荐 18+） 双击安装包，一路点「Next」完成安装 重新打开 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 安装（一键搞定）
brew tap Hmbown/deepseek-tui
brew install deepseek-tui
deepseek --version # 验证安装
备选：npm 安装（国内网速更快）
npm install -g deepseek-tui --registry=https://registry.npmmirror.com
deepseek --version
如果没有 Node.js，先去 https://nodejs.org 下载 macOS 安装包，18+ 版本即可。
🐧 Linux 安装 首选：npm 一键安装（国内镜像加速）
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
：
# 以 x86_64 为例
tar -xzf deepseek-tui-linux-x64.tar.gz
sudo mv deepseek deepseek-tui /usr/local/bin/
deepseek --version
其它安装方式 （Docker、Cargo 源码编译等）可参考文末进阶资源中的项目仓库。
⚙️ 第三步：完整配置与首次启动 装好之后，我们要给工具配置上“钥匙”，还可以做一些个性化设置，让 AI 更懂你！
🔑 基础配置：设置 API Key 方式一：交互式配置（推荐，最无脑）
deepseek auth set --provider deepseek
终端会提示你输入密钥，把之前复制的
sk-xxx
粘贴进去就行。
密钥会自动保存到
~/.deepseek/config.toml
文件里，以后在任意目录都能用。
方式二：环境变量（适合脚本、CI/CD 场景）
# 临时生效（关掉终端就没了）
export DEEPSEEK_API_KEY="你的sk-xxx"
# 永久生效（推荐）
# bash 用户 → 写入 ~/.bashrc
echo 'export DEEPSEEK_API_KEY="你的sk-xxx"' >> ~/.bashrc
source ~/.bashrc
# zsh 用户（macOS 默认） → 写入 ~/.zshenv
echo 'export DEEPSEEK_API_KEY="你的sk-xxx"' >> ~/.zshenv
source ~/.zshenv
💡 两种方式二选一即可，不要重复配置哦。
🌐 进阶配置：使用国内代理（如遇网络问题） 如果你在启动后经常遇到连接失败，可能是环境网络受限，可以给 DeepSeek TUI 配置 HTTP 代理。
全局代理（临时）
# 先设置代理环境变量，再启动
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
deepseek
永久代理配置 将上面两行
export
写入你的 shell 配置文件（
~/.bashrc
或
~/.zshenv
），这样每次启动终端都会自动用代理。
⚠️ 代理地址（如
127.0.0.1:7890
）要改成你自己的代理软件实际端口哦！
🤖 进阶配置：切换 AI 模型与提供方 DeepSeek TUI 默认使用
deepseek
提供方，但你也可以用它连接其它兼容 OpenAI API 的服务，比如本地的 Ollama、Fireworks 等。
使用本地 Ollama 模型（免费，离线可用） 先确保你已经安装了 Ollama 并拉取了模型：
ollama pull deepseek-coder:6.7b
然后用
--provider ollama
启动：
deepseek --provider ollama --model deepseek-coder:6.7b
使用 Fireworks 提供方（海外服务）
deepseek --provider fireworks --model deepseek-v4-pro
（需要先配置对应的 API Key） 永久修改默认模型 / 提供方 可以通过命令行参数，也可以直接在配置文件
~/.deepseek/config.toml
中修改。
小白用户建议先用启动参数试玩，以后熟练了再改配置文件。
⚙️ 进阶配置：调整默认工作模式与推理强度 每次启动
deepseek
时，默认是
Agent
模式（操作前需批准），推理强度默认是
auto
（自动）。
你可以在启动时就指定：
# 启动时指定模式和推理强度
deepseek --mode plan --reasoning high # 只读探索 + 高推理强度
deepseek --mode yolo --reasoning max # 全自动 + 最大推理（请谨慎！
）
你也可以在 TUI 界面里通过快捷键
Shift + Tab
动态切换推理强度，模式切换也只需输入命令。
📁 配置文件说明（了解即可） 所有配置都保存在
~/.deepseek/config.toml
，用文本编辑器可以打开查看/修改。
第一次使用时，该文件会由程序自动生成，默认内容如下：
# DeepSeek TUI Configuration
# Get your API key from https://platform.deepseek.com
# Save it with: deepseek auth set --provider deepseek
# Base URL (default: https://api.deepseek.com/beta)
# Set https://api.deepseek.com to opt out of beta features.
# base_url = "https://api.deepseek.com/beta"
# Default model
default_text_model = "deepseek-v4-pro"
# Thinking mode (DeepSeek V4 reasoning effort):
# "auto" | "off" | "low" | "medium" | "high" | "max"
# Shift+Tab in the TUI cycles between off / high / max.
reasoning_effort = "auto"
关键项说明：
default_text_model
：默认的对话模型，可根据需要改为
deepseek-chat
或其它支持的模型。
reasoning_effort
：推理强度，可选
auto
、
off
、
low
、
medium
、
high
、
max
，界面内
Shift+Tab
可快速切换。
base_url
：API 地址，通常不需要改；如果未来有国内专属地址可以在这里修改。
当你运行
deepseek auth set --provider deepseek
并输入密钥后，会自动在
[auth.deepseek]
段落写入你的
api_key
，所以 手动编辑文件时请不要直接粘贴密钥到其他字段，使用命令更安全 。
🚀 启动 TUI 界面 一切就绪，启动吧！
# 直接启动（在当前目录下工作）
deepseek
# 指定项目目录启动
deepseek --cwd /你的代码项目路径
首次启动会看到一个很酷的终端界面，等加载完毕，你就可以在下方输入框和 AI 对话啦！
👋 🩺 检查配置是否成功
deepseek doctor
如果看到一串绿色的 ✅ 就说明一切正常。
如果有 ❌，根据提示检查前面的配置步骤。
🎮 第四步：快速上手（常用命令 & 快捷键） 🤖 三种工作模式 模式说明适合场景 🕵️Plan只读探索，AI 不动你文件第一次用，先看看 AI 的理解🤖Agent默认模式，操作前需你批准日常写代码，安全可控⚡YOLO自动批准，AI 可以自由发挥完全信任 AI，效率起飞 ⌨️ 必知快捷键 快捷键作用
Shift + Tab切换推理强度（off → high → max）Ctrl + R恢复历史会话Ctrl + C中断当前操作输入/进入命令模式
📝 其他实用命令
deepseek --version # 查看版本
deepseek doctor # 诊断配置
deepseek auth clear --provider deepseek # 清除密钥
deepseek --help # 查看所有命令
🔄 如何更新 DeepSeek TUI
# npm 安装的
npm update -g deepseek-tui
# Homebrew 安装的
brew upgrade deepseek-tui
🐛 遇到问题？
常见排查 ❓ 提示 “deepseek: command not found” 原因 ：系统找不到 deepseek 命令。
解决 ： macOS/Linux：确认
/usr/local/bin
或 npm 全局 bin 目录在 PATH 中，或重启终端 Windows：检查安装文件夹是否已添加到系统 Path 环境变量 ❓ Windows 终端闪屏、显示乱码 原因 ：CMD 或旧版 PowerShell 渲染能力不足。
解决 ：安装 Windows Terminal （微软商店免费下载），在里面运行 deepseek ❓ API Key 配置后提示认证失败 可能原因 ：密钥复制不完整、账户余额不足、密钥失效 解决 ：
deepseek auth clear --provider deepseek
deepseek auth set --provider deepseek # 重新粘贴完整密钥
deepseek doctor # 验证
❓ npm 安装下载太慢或失败 解决 ：已默认带镜像，如果还慢可手动指定：
npm install -g deepseek-tui --registry=https://registry.npmmirror.com
❓ 连接 API 超时或报网络错误 解决 ：参考上面「进阶配置：使用国内代理」章节，设置 HTTP 代理后再启动。
❓ 更新不及时，想用最新版 去 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！
🚀✨