Deep Code CLI 完整图文安装教程

时鹏亮

2 days ago

很多同学想体验终端里的 AI 编程助手，一搜教程全是 Claude Code。装完才发现：网络要折腾、账号要外区、额度还不便宜。

其实国内开发者有一条更省事的路：Deep Code CLI + DeepSeek V4。

Deep Code 是专为 deepseek-v4 优化的终端 AI 编码助手，支持深度思考、推理强度控制、Agent Skills 和 MCP，配置文件还能和 VSCode 插件共用。DeepSeek API 国内直连，按量计费，先少量充值就能跑起来。

本文从零开始，带你在 Windows 上装好 Deep Code CLI，并配置好 DeepSeek 官方 API。步骤尽量写细，照着做就行。

适用系统：Windows 10 / Windows 11。Linux 和 macOS 用户可跳过第 1~4 步里的 Windows 专属操作，直接从第五步开始。

前置基础信息

Windows 10 或更高版本（64 位）
能正常上网，需要访问 npm 和 DeepSeek 开放平台
管理员权限（安装 Git、Node.js 时会用到）
一个 DeepSeek API Key（第六步会教怎么申请）
建议 8GB 以上内存；Deep Code 本身很轻，主要吃网络和模型侧算力

关于费用：Deep Code CLI 软件本身免费，但调用模型需要 API Key。DeepSeek 官方按 token 计费，具体价格以 DeepSeek 开放平台为准。本文不卖 Key，也不建议购买共享或来路不明的 Key。

第一步：安装 Git for Windows

Deep Code 的很多操作会用到 Git，比如查看改动、生成 diff、回滚代码。Windows 上建议先装 Git for Windows。已经装过的可以跳过这一步。

下载 Git for Windows

打开 Git for Windows 官网，点击 Git for Windows/x64 Setup 下载。
下载完成后，双击 .exe 安装包。

也可以直接用 winget 安装：

winget install --id Git.Git -e --source winget

安装 Git for Windows

安装向导里一路点击 Next，保持默认选项即可。
点击 Install 开始安装。
安装完成后点击 Finish。

验证安装

按下 Win + R，输入 cmd，回车打开命令提示符，输入：

git --version

如果显示版本号（比如 git version 2.53.0），说明安装成功。

第二步：安装 Node.js

Deep Code CLI 通过 npm 分发，要求 Node.js 22 或更高版本。推荐安装 Node.js 24 LTS。

下载 Node.js

打开 Node.js 官网，下载 Windows 安装程序(.msi)。
下载完成后，双击 .msi 安装包。

用 winget 也可以：

winget install OpenJS.NodeJS.LTS

安装 Node.js

安装向导里一路点击 Next，保持默认选项，确保勾选 Add to PATH。
点击 Install 开始安装。
安装完成后点击 Finish。

验证安装

重新打开一个终端窗口，输入：

node -v
npm -v

如果显示版本号（比如 v24.14.1 和 11.11.0），说明安装成功。如果 node -v 低于 v22，请先卸载旧版本，再安装新版本。

第三步：安装 Windows Terminal

Windows 自带的 cmd.exe 对 Unicode 和 Emoji 的支持不太好，Deep Code 的图标和部分界面元素可能显示成方块。建议使用微软官方的 Windows Terminal。

Windows 11 已经预装 Windows Terminal，可以跳过本步。

Windows 10 用户安装方法

方法一：命令行安装。Windows 10 1809 以上自带 winget，直接运行：

winget install Microsoft.WindowsTerminal

如果提示是否同意源协议条款，输入 Y 后回车。

方法二：打开 Microsoft Store，搜索 Windows Terminal，点击获取或安装。

启动 Windows Terminal

按下 Win + R，输入 wt，回车即可启动。以后也可以在项目文件夹上右键，选择 在终端打开。

第四步：安装 Nerd Font 字体

这一步是为了让终端里的图标和特殊字符正常显示。如果你不介意图标显示成方块，也可以先跳过，不影响 Deep Code 的核心功能。

推荐使用 CaskaydiaCove Nerd Font Mono（基于微软 Cascadia Code）。

下载字体

打开 Nerd Fonts 官网，搜索 CaskaydiaCove，点击 Download 下载 CaskaydiaCove.zip。
解压后找到 Mono 系列的 4 个字体文件。

安装字体

终端字体用 Mono（等宽） 系列，最少安装这 4 个：

CaskaydiaCoveNerdFontMono-Regular.ttf
CaskaydiaCoveNerdFontMono-Bold.ttf
CaskaydiaCoveNerdFontMono-Italic.ttf
CaskaydiaCoveNerdFontMono-BoldItalic.ttf

同时选中这 4 个 .ttf 文件。
右键点击，选择 为所有用户安装。
等待安装完成。

配置 Windows Terminal 字体

打开 Windows Terminal，点击顶部标题栏的 ∨ 下拉箭头 → 设置，或按 Ctrl + ,。
左侧选择 配置文件 → 选中你常用的终端（如 Windows PowerShell 或 命令提示符）。
点击外观。
找到字体，在字体名称输入框中输入 CaskaydiaCove Nerd Font Mono 并选择它。
点击右下角保存。

也可以直接编辑 Windows Terminal 的 JSON 配置，在 "defaults" 里加上：

"profiles": {
    "defaults": {
        "font": {
            "face": "CaskaydiaCove Nerd Font Mono",
            "size": 12
        }
    }
}

第五步：安装 Deep Code CLI

环境准备好了，现在安装 Deep Code CLI。打开 Windows Terminal，执行：

npm install -g @vegamo/deepcode-cli

国内网络如果下载慢，可以加上 npmmirror 镜像：

npm install -g @vegamo/deepcode-cli --registry=https://registry.npmmirror.com

等待安装完成，可能需要几分钟，取决于网速。

验证安装

deepcode --version

如果显示版本号（比如 0.4.5，以实际最新版为准），说明安装成功。

第六步：配置 Deep Code CLI

Deep Code 使用 settings.json 保存配置。用户级配置文件位于 C:\Users\你的用户名\.deepcode\settings.json，配置一次，所有项目都能用。

创建配置文件

在 PowerShell 中执行：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.deepcode" | Out-Null
notepad "$env:USERPROFILE\.deepcode\settings.json"

在打开的文件里粘贴以下内容：

{
  "env": {
    "MODEL": "deepseek-v4-flash",
    "BASE_URL": "https://api.deepseek.com",
    "API_KEY": "sk-你的密钥"
  }
}

三个字段的含义：

MODEL：模型名称。日常推荐 deepseek-v4-flash，速度快、价格低；复杂任务可以换成 deepseek-v4-pro。
BASE_URL：DeepSeek 官方 API 地址，填 https://api.deepseek.com。
API_KEY：你的 DeepSeek API Key，以 sk- 开头。

申请 DeepSeek API Key

打开 DeepSeek 开放平台，注册并登录。
按平台提示完成充值。先充少量即可，够你把本文流程跑通、体验几天。
进入 API Keys 页面，点击 创建 API Key，起个名字，比如 deepcode。
复制生成的 Key。Key 通常只完整显示一次，务必先保存好。
把 Key 填到上面 settings.json 的 API_KEY 字段里。

【配图待补：DeepSeek 开放平台创建 API Key 页面】

注意：settings.json 是标准 JSON，不能写注释，最后一项后面不能多逗号。保存时用 UTF-8 编码。

第七步：启动 Deep Code

配置完成后，进入你要处理的项目目录。可以在文件夹空白处右键，选择 在终端打开，然后输入：

deepcode

第一次启动会进入 Deep Code 的交互界面。看到输入框后，直接输入你的需求，比如：

先读一遍这个项目，告诉我用了什么技术栈、入口文件在哪。

Deep Code 会读取当前目录的文件，执行命令、修改代码，并在终端里显示过程。

想退出时，输入 /exit，或者连续按两次 Ctrl + D。

以后每次使用，只需要在项目文件夹里打开终端，输入 deepcode 回车即可。

如您从本文得到了有价值的信息或帮助，请考虑扫描下方二维码捐赠和鼓励。

如本文对您有用，捐赠和留言 将是对我最好的支持~
如愿意，请向朋友推荐本站，谢谢。

尊重他人劳动成果。转载请务必附上原文链接，我将感激不尽。

教程目录

前置基础信息

第一步：安装 Git for Windows

下载 Git for Windows

安装 Git for Windows

验证安装

第二步：安装 Node.js

下载 Node.js

安装 Node.js

验证安装

第三步：安装 Windows Terminal

Windows 10 用户安装方法

启动 Windows Terminal

第四步：安装 Nerd Font 字体

下载字体

安装字体

配置 Windows Terminal 字体

第五步：安装 Deep Code CLI

验证安装

第六步：配置 Deep Code CLI

创建配置文件

申请 DeepSeek API Key

第七步：启动 Deep Code

与《Deep Code CLI 完整图文安装教程》相关的博文：