字
字节笔记本
2026年5月25日
DeepSeek-TUI 使用指南：原生对接 DeepSeek V4 的终端编程助手
API中转
¥120
DeepSeek-TUI 是一款采用 Rust 编写的开源终端 AI 编程助手，原生对接 api.deepseek.com，支持 DeepSeek V4 Pro 与 V4 Flash 的全 100 万 token 上下文，并在各平台上提供沙箱化的工具执行能力。
安装 DeepSeek-TUI
任选一种方式：
sh
# npm（跨平台预编译二进制）
npm install -g deepseek-tui
# Cargo（从源码构建，需要 Rust 1.85+）
cargo install deepseek-tui-cli也可以从 GitHub Releases 下载预编译二进制。
验证安装：
bash
deepseek --version获取 API Key
前往 DeepSeek 开放平台 获取 API Key。首次运行时 deepseek auth 会引导保存到配置文件，也可以直接设置环境变量 DEEPSEEK_API_KEY。
启动使用
bash
cd /path/to/my-project
deepseekDeepSeek-TUI 默认使用 DeepSeek-V4-Pro。常用快捷键：
| 按键 | 操作 |
|---|---|
Tab | 切换模式（Plan / Agent / YOLO） |
Shift+Tab | 切换推理强度（off / high / max） |
Enter | 发送 prompt |
Esc | 中断当前模型回合 |
/ | 打开 slash 命令菜单 |
? | 快捷键帮助 |
三种模式
- Plan：只读调研模式，不写文件、不执行 shell
- Agent：多步工具调用，具有副作用的工具需要审批
- YOLO：自动批准所有工具，解除工作区边界限制
配置文件与环境变量
主配置文件为 ~/.deepseek/config.toml。常用环境变量：
| 变量 | 说明 |
|---|---|
DEEPSEEK_API_KEY | API Key，覆盖配置文件 |
DEEPSEEK_BASE_URL | API 基址，默认 https://api.deepseek.com |
DEEPSEEK_MODEL | 覆盖默认模型 |
DEEPSEEK_PROVIDER | 切换提供商 |
MCP、Skills 与 Hooks
- MCP 服务器：在
~/.deepseek/mcp.json中配置 - Skills：放入
~/.deepseek/skills/<name>/或./.deepseek/skills/<name>/ - Hooks：在
config.toml的[hooks]中配置生命周期钩子 - 子 Agent：支持
agent_spawn派生子 Agent - HTTP API：
deepseek serve --http暴露运行时 API
分享: