第一步:安装 DeepSeek-TUI
您可以根据自己的开发环境,选择以下任意一种方式进行安装:
方法 1:使用 Node.js (npm) —— 最推荐,跨平台
如果您的电脑安装了 Node.js,这是最简单快捷的方式:
Bashnpm install -g deepseek-tui
方法 2:使用 Rust (Cargo) —— 适合开发者
如果您本地有 Rust 环境(需要 Rust 1.85+),可以直接从源码构建:
Bashcargo install deepseek-tui-cli
方法 3:手动下载预编译二进制文件
前往 GitHub Releases 页面,下载对应操作系统的压缩包,解压并将可执行文件移动到系统的环境变量路径(PATH)中。
验证安装:安装完成后,在终端输入
deepseek --version,如果正确显示版本号,说明安装成功!
第二步:配置 API Key
DeepSeek-TUI 需要调用 DeepSeek 的官方 API。
- 前往 DeepSeek 开放平台 注册并获取你的
API Key。 - 初始化配置:在终端运行以下命令:
Bashdeepseek auth程序会引导你输入 API Key,并自动将其保存到本地配置文件~/.deepseek/config.toml中。
备选方案:你也可以直接配置环境变量,在
.bashrc或.zshrc中加入:
export DEEPSEEK_API_KEY="你的API_KEY"
第三步:核心使用指南
配置完成后,直接在你的项目目录下输入 deepseek 即可启动交互式终端界面。
Bashcd /path/to/your-project deepseek
1. 界面核心快捷键
进入 TUI 界面后,可以通过以下快捷键快速切换状态:
Tab键:切换工作模式(Plan / Agent / YOLO)。Shift + Tab键:切换推理强度(off基础 /high高级 /max极限推理)。默认使用 DeepSeek-V4-Pro 模型。
2. 三大核心工作模式
DeepSeek-TUI 的强大之处在于它的三种运行模式,分别对应不同的安全级别和应用场景:
模式 安全等级 行为说明 适用场景 Plan (调研)3. 常用命令行子命令 (CLI Flags)
除了直接进入 TUI 界面,你也可以直接在终端使用子命令实现快速调用:
- 一次性问答 (Prompt):不想进界面,只问一个问题。
Bashdeepseek -p "帮我用Python写一个快速排序算法" - 检查环境 (Doctor):排查 MCP(Model Context Protocol)或配置问题。
Bashdeepseek doctor - 直接进入 YOLO 模式:
Bashdeepseek --yolo - 启动 HTTP 服务:将 DeepSeek-TUI 作为一个本地服务挂载。
Bashdeepseek serve --http
避坑与安全提示
- YOLO 模式慎用:在 YOLO 模式下,AI 可能会误删文件或执行破坏性的 Shell 命令。建议仅在已提交 Git 版本控制的项目目录中使用,方便随时回滚代码。
- 推理强度调节:如果只是问简单的语法问题,可以把推理强度(Shift+Tab)调到
off以节省 Token 和响应时间;如果是复杂的算法难题或 Bug 排查,再开启high或max。
1 个帖子 - 1 位参与者