❤️❤️❤️❤️❤️❤️ 我们已经正式推出微信小程序,在微信中搜索 TrendForge Pro 即可使用小程序,如果使用 Telegram 请搜索 trendforge_tg ❤️❤️❤️❤️❤️❤️

DeepSeek-TUI 5分钟快速开始

DeepSeek-TUI 是一个终端原生编码代理,专为 DeepSeek V4 模型设计,支持 1M 令牌上下文,单二进制文件即可运行。

环境要求

支持的操作系统

macOS Windows Linux

所需工具

终端

运行命令

必需

操作步骤

1

下载预编译二进制文件

从 GitHub Releases 页面下载适合你系统的二进制文件。Linux x64、macOS ARM64 等均有提供。

替换 <your-os> 和 <arch> 为你的系统(如 linux-x64、darwin-arm64)
curl -LO https://github.com/Hmbown/DeepSeek-TUI/releases/latest/download/deepseek-<your-os>-<arch>.tar.gz
解压文件
tar -xzf deepseek-*.tar.gz
将两个二进制文件移动到 PATH 中
sudo mv deepseek /usr/local/bin/ && sudo mv deepseek-tui /usr/local/bin/

预期结果::命令执行后无错误输出,deepseek 和 deepseek-tui 命令可用。

如果下载慢,可以使用 npm 安装:npm i -g deepseek-tui(需要 Node.js,但仅用于安装)。

2

设置 API 密钥

首次运行会提示输入 DeepSeek API 密钥,密钥保存在 ~/.deepseek/config.toml。也可以提前设置环境变量。

设置环境变量,替换为你的真实密钥
export DEEPSEEK_API_KEY='your-api-key-here'

预期结果::无输出,但后续运行不再提示输入密钥。

密钥可以从 platform.deepseek.com 获取。

3

启动 TUI

在终端中运行 deepseek 命令启动 TUI 界面。

启动 DeepSeek-TUI
deepseek

预期结果::终端显示 TUI 界面,顶部有模式指示器(如 Agent),底部有输入框。

如果报错找不到 deepseek-tui,确保两个二进制文件都在 PATH 中。

4

发送第一条消息

在 TUI 中输入一条简单指令,例如 '列出当前目录文件',然后按 Enter 发送。

在 TUI 输入框中输入此消息并回车
列出当前目录文件

预期结果::模型会思考并执行 ls 命令,然后在界面中显示文件列表。

按 Tab 可以自动补全命令或文件路径。

验证成功

成功看到模型执行命令并返回结果,说明 DeepSeek-TUI 已正常运行。

TUI 界面正常显示
模型响应并执行了工具调用
输出结果包含文件列表或任务完成信息

快速提示

导航

按 F1 查看所有快捷键帮助

配置

按 Shift+Tab 切换推理强度(off/high/max)

命令

输入 /help 查看命令列表

常见问题

1

运行 deepseek 报错 'command not found'

确保二进制文件已移动到 /usr/local/bin 或 PATH 中的其他目录。

2

启动后提示 API 密钥未设置

设置环境变量 DEEPSEEK_API_KEY 或运行 deepseek auth set --provider deepseek 交互式输入。

3

模型响应慢或超时

检查网络连接,或按 Ctrl+C 取消当前请求后重试。

下一步

阅读文档

查看 docs/ 目录下的详细文档,了解 MCP、会话保存等功能。

尝试 YOLO 模式

在 TUI 中按 Tab 切换到 YOLO 模式,体验自动批准工具调用。

配置项目覆盖

在工作目录创建 .deepseek/config.toml 覆盖全局配置。

助手