DeepSeek-TUI Windows 安装配置教程

适用于 Windows x64 系统 · 2026年5月

目录

1.一、什么是 DeepSeek-TUI？

2.二、安装前准备

3.三、安装方法一（推荐）：npm 安装

4.四、安装方法二：直接下载二进制文件

5.五、配置 API Key

6.六、启动与使用

7.七、三种操作模式说明

8.八、常见问题与注意事项

9.九、卸载方法

一、什么是 DeepSeek-TUI？

DeepSeek-TUI 是一款完全运行在终端（命令行窗口）中的 AI 编程智能体，由开发者 Hayden Brown 使用 Rust 语言构建，专为 DeepSeek V4 系列模型（deepseek-v4-pro / deepseek-v4-flash）量身打造。

核心功能

·文件操作：支持文件读写、应用补丁（apply-patch）、批量修改

·Shell 命令执行：在终端内直接运行命令，无需切换上下文

·Git 管理：支持 Git 仓库操作

·网页搜索：内置网络搜索能力，辅助资料收集

·子智能体调度：支持并行调度多个子任务

·100 万 Token 超长上下文：支持整个项目一次性分析

·实时思维链显示：模型的推理过程流式输出到终端

二、安装前准备

1. 安装 Node.js（必需）

DeepSeek-TUI 推荐通过 npm 安装，因此需要先安装 Node.js。如果你的电脑已经安装了 Node.js，可以跳过此步骤。

步骤 1：打开浏览器，访问 Node.js 官网：https://nodejs.org/

步骤 2：下载 Windows 版本的 LTS（长期支持版）安装包（.msi 格式），建议选择最新 LTS 版本。

步骤 3：双击下载的安装包，一路点击「Next」完成安装。

步骤 4：验证安装。打开命令提示符（Win+R → 输入 cmd → 回车），输入 node --version，如果显示出版本号（如 v20.x.x）则说明安装成功。

2. 注册 DeepSeek API Key

DeepSeek-TUI 需要使用 DeepSeek 的 API 才能运行，因此需要提前注册获取 API Key。

步骤 1：打开浏览器，访问 DeepSeek 开放平台：https://platform.deepseek.com/

步骤 2：注册账号（支持国内手机号注册）。

步骤 3：登录后，进入「API Keys」页面，创建一个新的 API Key。

步骤 4：复制并保存好生成的 API Key（后续配置步骤需要用到）。

三、安装方法一（推荐）：npm 安装

配置国内镜像源（推荐中国大陆用户）

由于网络原因，直接使用 npm 官方源可能下载较慢，建议先配置国内镜像源。

步骤 1：打开命令提示符（管理员身份推荐，Win+R键 → 输入「cmd」→ 右键「以管理员身份运行」）。

步骤 2：设置 npm 镜像源（淘宝镜像）：

npmconfig set registry https://registry.npmmirror.com

安装 DeepSeek-TUI

配置好镜像源后，执行以下命令进行安装：

npminstall -g deepseek-tui

验证安装

安装完成后，验证是否安装成功：

deepseek--version

如果显示出版本号（如 v0.8.x），说明安装成功。

四、安装方法二：直接下载二进制文件

如果你不想安装 Node.js，也可以从 GitHub Releases 页面直接下载 Windows 预编译的二进制文件：

步骤 1：打开 DeepSeek-TUI GitHub Releases 页面：https://github.com/Hmbown/DeepSeek-TUI/releases

步骤 2：找到最新版本的发布包，下载 deepseek-windows-x64.exe 和 deepseek-tui-windows-x64.exe。

步骤 3：将下载的 .exe 文件放到一个文件夹中（如 C:\deepseek-tui）。

步骤 4：将该文件夹路径添加到系统环境变量 PATH 中（方便在任意位置调用）。

步骤 5：打开命令提示符，输入 deepseek --version 验证安装。

五、配置 API Key

安装完成后，需要配置 DeepSeek API Key 才能正常使用。有两种方式：

方式一：命令行配置（推荐）

deepseekauth set --provider deepseek

按照提示粘贴你的 API Key 即可。Key 会保存在本地配置文件中（~/.deepseek/config.toml）。

方式二：环境变量配置

在命令行中设置环境变量（每次打开新终端都需要重新设置）：

setDEEPSEEK_API_KEY=你的APIKey

也可以选择「系统环境变量」方式永久配置：此电脑 → 属性 → 高级系统设置 → 环境变量 → 新建 → 变量名 DEEPSEEK_API_KEY，变量值填入你的 API Key。

六、启动与使用

完成上述配置后，在命令提示符中输入以下命令启动：

deepseek

首次启动后会进入交互式 TUI 界面。你可以直接在终端中与 AI 对话，让它帮你完成代码编写、文件操作、命令执行等任务。

常用命令

七、三种操作模式说明

DeepSeek-TUI 提供了三种操作模式，适合不同使用场景：

Plan（计划模式）：只读模式。AI 会先分析项目、生成计划、列出待办事项，但不会真正执行任何修改。适合刚开始接触任务，想先了解整体思路时使用。

Agent（代理模式）：默认模式。AI 会调用工具来执行任务（如读文件、改代码、执行命令），但关键步骤仍然会要求你确认。适合日常开发使用。

YOLO（放权模式）：最激进的模式。AI 全自动推进整个任务链，不需要逐条确认。警告：首次使用或在不熟悉的项目上，不建议开启此模式。

八、常见问题与注意事项

1. 安装失败或下载慢

·确保已配置国内镜像源（npm config set registry https://registry.npmmirror.com）。

·可以尝试使用科学上网工具。

·也可选择安装方法二，直接从 GitHub Releases 下载二进制文件。

2. 启动后无法连接到 API

·检查 API Key 是否正确配置。

·检查网络连接是否正常。

·确认 DeepSeek 开放平台账号余额充足（API 调用需要付费）。

3. 权限安全提醒

DeepSeek-TUI 可以读写文件、执行命令、管理 Git，具有较高的操作权限。建议：

·首次使用时使用 Plan 或 Agent 模式，不要直接开启 YOLO 模式。

·不要在重要生产项目上直接使用 YOLO 模式。

·使用 Agent 模式时，逐条确认 AI 的操作请求。

·项目自带快照回滚功能，翻车了也不慌，可以回滚。

4. 费用说明

DeepSeek-TUI 本身是免费开源软件（MIT 协议），但调用 DeepSeek API 需要付费。DeepSeek V4 的 API 定价如下：

相比 Claude Code 每月 200 美元的订阅费，使用 DeepSeek-TUI 的成本可降低约 98%。

九、卸载方法

如果使用 npm 安装，卸载方法如下：

npmuninstall -g deepseek-tui

如果使用二进制文件方式安装，直接删除对应文件夹即可。

— 教程完 —