老周的AI极客工坊 [第二期] | 终端神器 deepseek-tui (CodeWhale) 打造本地 AI 编程助理

亲爱的读者，欢迎回到 老周的AI极客工坊！

在上期“试刊号”中，我们一起搭建了本地的 ComfyUI 图像工作流。本期我们把目光投向软件开发与代码编写 —— 聊聊如何打造一个专属于你自己的、100% 免费且完全安全合规的 AI 编程助理。

很多开发者平时都在使用 GitHub Copilot，但它每月 10 美元（约合 70+ 元人民币）的订阅费对学生党和独立开发者来说是一笔不小的开销，而且网络连接经常卡顿。

今天，老周带你用最硬核、最酷炫的“黑客流”玩法：在终端（命令行）中配置专为国产良心大模型 DeepSeek 打造的开源终端神器 —— deepseek-tui（现官方更名为 CodeWhale），用它来替代 Codex / Claude，实现终端内的一键 Debug 和代码生成！

合规与安全声明： 本教程所使用的 DeepSeek API 为中国本土合规运营的生成式 AI 服务，其接口地址（api.deepseek.com）在国内网络完全畅通，下载和使用过程中相当流畅。本教程仅用于个人多设备互联与合规的远程办公/开发场景。

🚀 为什么选择 deepseek-tui (CodeWhale)？

在终端里写代码，不仅是因为看起来“极客范”十足，更因为以下三个无法拒绝的优势：

1. 极高性价比：调用 DeepSeek 官方 API，每百万 Token 只需要 1 - 2 元人民币，价格仅为 OpenAI 或 Claude 的百分之一，充值 10 元钱可以用上几个月！
2. 本地文件读写（Agent 能力）：它不只是一个普通的聊天框，它可以直接读取您本地项目中的代码文件，修改完 Bug 后直接把新代码写回文件，甚至帮你自动提交 Git，真正实现“解放双手”。
3. 100% 安全隐私：工具本身开源且纯本地运行，数据直连 DeepSeek 国内官方服务器，代码不会被任何第三方中转，保护您的商业机密。

🛠️ 第一步：获取你的 DeepSeek API Key

我们首先需要获取大模型的接口凭证：

1. 打开浏览器，直接访问 DeepSeek 开放平台（国内直连）。
2. 注册/登录您的账号。
3. 在左侧菜单栏点击 API keys 点击 创建 API Key。
4. 复制生成的密钥（形如 sk-xxxxxxxxxxxx），并妥善保存在本地。
5. 提示：新用户注册通常会免费赠送价值 10 元的 Token 额度，足够我们测试使用。

📥 第二步：极速安装与配置

deepseek-tui (CodeWhale) 提供了多种便捷的安装方式，您可以根据自己的系统选择：

1. 使用 npm 安装（适合所有已安装 Node.js 的电脑）

如果您电脑上安装了 Node.js，可以直接在终端（PowerShell 或终端）中运行一行命令安装：

npm install -g @hmbown/codewhale 

2. 使用 Rust 的 Cargo 安装（适合开发者）

如果您有 Rust 编译环境，也可以直接编译安装：

cargo install deepseek-tui 

⚙️ 第三步：配置环境变量与启动

为了让工具能够调用我们的大模型，我们需要把刚刚获取的 API Key 写入系统的环境变量中。

1. Windows 用户配置方法：

在 PowerShell 中运行以下命令（将 your_api_key_here 替换为您复制的 sk-... 密钥）：

[Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY", "your_api_key_here", "User") 

注：配置完成后，请重新打开一个新的 PowerShell 窗口使环境变量生效。

2. macOS / Linux 用户配置方法：

在终端中运行：

echo 'export DEEPSEEK_API_KEY="your_api_key_here"' >> ~/.bashrc # 如果使用的是 zsh echo 'export DEEPSEEK_API_KEY="your_api_key_here"' >> ~/.zshrc source ~/.zshrc 

3. 启动终端助理

在命令行中直接输入以下命令并回车：

codewhale 

或者（根据您安装的版本）：

deepseek-tui 

你将看到一个精美的全屏幕终端交互界面（TUI），可以开始用键盘流畅地与大模型对话了！

💻 第四部分：硬核实战！让 AI 帮你改本地代码

下面我们演示如何让 CodeWhale 读取我们本地的一个 Python 脚本并帮我们修改 Bug。

1. 进入您的项目目录： bash cd D:\同步\AI项目\
2. 启动 CodeWhale 并加载文件： 在 CodeWhale 界面中，你可以使用斜杠指令直接把文件喂给 AI： text /add wechat_publisher.py 此时，AI 已经读入了您的整个脚本内容。
3. 发送 Debug 指令： 在输入框中打字： > “请帮我检查这个脚本，看看在 Windows 下运行会不会有编码报错风险，并直接修改代码。”
4. 一键应用修改： AI 会自动分析代码，标出修改的 Diff，您可以按快捷键 Ctrl + A 直接接受修改，AI 会自动更新您本地的 wechat_publisher.py 文件！

🎁 本期福利资源包 (Episode 02 Perks)

为了帮助大家快速上手，我们在本系列的资源总仓里为您准备了以下起步福利：

1. Windows 环境变量一键配置脚本： 我们在本目录下为您提供了一个 set_key.bat 批处理文件。您只需右键编辑它，把您的 Key 填进去，双击即可完成配置。
2. deepseek-tui 快捷键速查表 (PDF)：
   • Tab：在对话框、文件列表和代码展示区之间切换焦点。
   • /add <file>：向上下文添加本地文件。
   • /commit：自动分析修改并为您生成 Git Commit 提交信息。
3. 魔搭社区（ModelScope）模型高速下载脚本： 如果您希望完全在本地离线运行（配合 Ollama），我们提供了一个 Python 脚本，可以满速从魔搭社区下载 DeepSeek-Coder 的 GGUF 模型，下载完成后直接双击导入 Ollama 即可。

下一期预告：我们将回到打洞组网专题，教大家如何把我们这两期的成果串联起来 —— 《老周的AI极客工坊 [第三期] | 异地安全穿透：如何在外网直接安全调用您家里的本地大模型与 AI 画图算力》。敬请期待！