Deep Code CLI：专为 DeepSeek V4 优化的终端 AI 编程助手安装与使用指南
项目背景
在 AI 编程工具百花齐放的今天，越来越多的开发者习惯在终端里直接完成"读代码—改代码—跑命令—看结果"的完整闭环。Deep Code CLI 正是这样一款扎根于命令行的 AI 编码助手，它由 lessweb 团队开发，并被 DeepSeek 官方 API 文档列入推荐的 Agent 集成清单。
它的设计出发点很特别：研究者 Armin Ronacher 在《Better Models: Worse Tools》一文中指出，工具 schema 并不是"中立"的——大模型会继承自己在训练和强化学习中形成的工具使用习惯，可能在某套主流工具里表现很好，换到另一套工具形态下就变得不稳定。Deep Code CLI 反其道而行之，只为 DeepSeek 系列模型量身调优，让工具约束、上下文管理、Agent Skills 与权限策略始终贴合 DeepSeek 的行为特点，从而在真实编程任务上获得更好的效果。
截至本文撰写时，该仓库已收获 2.2k Star、222 Fork，并且同时提供功能完整的 VS Code 插件，二者共享同一份配置文件，开发者可以在终端和编辑器之间无缝切换。
核心特性
为 DeepSeek 量身优化：专门针对 DeepSeek 模型做性能调优，利用 DeepSeek 的上下文缓存（Context Caching）大幅降低输入成本，原生支持思考模式（Thinking）与思考强度控制。
深度思考与推理强度控制：支持
thinkingEnabled开关与reasoningEffort（low / high / max）调节，简单任务快速响应，复杂任务深度推理。Agent Skills 技能体系：支持从用户级、项目级目录自动发现
SKILL.md技能包，可扩展助手能力，且兼容.agents/skills/跨客户端目录。MCP（Model Context Protocol）集成：可连接 GitHub、浏览器、数据库等外部 MCP 服务，把任意 stdio 工具接入编码 Agent。
斜杠命令丰富：内置
/new、/fork、/continue、/compact、/model、/mcp、/undo等命令，会话管理一气呵成。多模态识图：支持读取本地图片或
Ctrl+V粘贴剪贴板图片，让模型直接"看到"截图内容辅助排错。细粒度权限控制：对 Shell 命令、文件读写、网络访问分别设置"始终允许 / 始终询问 / 拒绝"，并非只有全自动的 YOLO 模式。
OpenAI 兼容：除官方 DeepSeek API 外，通过修改
BASE_URL即可接入火山方舟 Coding Plan 等任意 OpenAI 兼容接口。
环境要求
操作系统：Windows / macOS / Linux（支持 WSL2）。
Node.js：建议 Node.js 22 LTS 及以上版本（项目自带
.nvmrc）。npm：随 Node.js 一起安装，建议 npm 9+。
网络：可访问
https://api.deepseek.com（国内如不稳定可使用兼容镜像地址）。API 密钥：在 DeepSeek 开放平台申请，以
sk-开头。
详细部署步骤
第一步：安装 Node.js 环境
Deep Code CLI 是一个 npm 包，必须先准备好 Node.js。推荐使用 nvm 管理版本：
# Linux / macOS 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载终端配置
source ~/.bashrc # 或 source ~/.zshrc
# 安装并使用 Node.js 22
nvm install 22
nvm use 22
# 验证版本
node -v
npm -vWindows 用户可直接到 Node.js 官网下载 LTS 安装包，一路下一步即可。
第二步：全局安装 Deep Code CLI
官方推荐使用 npm 全局安装：
npm install -g @vegamo/deepcode-cli安装完成后验证：
deepcode --version若提示 deepcode: command not found，说明 npm 全局 bin 目录未加入 PATH，可执行 npm config get prefix 查看前缀，并把 <prefix>/bin 加入 PATH。
第三步：申请并配置 API Key
登录 DeepSeek 开放平台，创建一个 API Key（形如 sk-xxxxxxxx），并确保账户有余额。然后创建配置文件：
# 创建配置目录
mkdir -p ~/.deepcode
# 新建配置文件
nano ~/.deepcode/settings.json写入以下内容（注意把 sk-... 换成你自己的 Key）：
{
"env": {
"MODEL": "deepseek-flash",
"BASE_URL": "https://api.deepseek.com",
"API_KEY": "sk-你的API密钥"
},
"thinkingEnabled": true,
"reasoningEffort": "max"
}配置项逐行说明：
env.MODEL：默认模型，推荐deepseek-flash；可选deepseek-v4-pro、deepseek-v4-flash、deepseek-v4-flash-vision-exp。env.BASE_URL：API 地址，默认官方地址；接火山方舟 Coding Plan 时改成https://ark.cn-beijing.volces.com/api/coding/v3。env.API_KEY：你的密钥。thinkingEnabled：是否开启深度思考模式。reasoningEffort：推理强度，low快速、high平衡、max最深。
第四步：启动并验证
进入任意项目目录后直接运行：
cd /path/to/your/project
deepcode启动成功后会看到 ASCII 艺术字 "DEEP CODE" 欢迎界面，显示当前模型（Model）、是否开启思考（Thinking Enabled）、推理强度（Reasoning Effort）以及当前工作目录（CWD）。在底部输入框输入 hello 回车，能收到 DeepSeek 的回复即说明配置成功。
第五步（可选）：配置 MCP 与 Skills
在 settings.json 中加入 mcpServers 字段即可挂载外部工具：
{
"env": { "MODEL": "deepseek-flash", "BASE_URL": "https://api.deepseek.com", "API_KEY": "sk-..." },
"thinkingEnabled": true,
"reasoningEffort": "max",
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
}
}
}启动后输入 /mcp 可查看已连接的 MCP 服务器与可用工具。Skills 则把 SKILL.md 放到 ~/.deepcode/skills/<name>/ 或项目 ./.deepcode/skills/ 目录即可被自动发现。
常见坑与解决办法
命令找不到：npm 全局目录未加入 PATH，执行
npm config get prefix并把bin加入 PATH。401 / 403 报错：API Key 错误或已失效，回 平台重新生成。
402 报错：账户余额不足，需充值。
连接超时：国内网络访问
api.deepseek.com不稳定时，可更换为兼容的镜像BASE_URL。Node 版本过低：请用 nvm 切到 22+，旧版本会出现语法错误。
使用方法示例
启动后，你可以用自然语言让 Agent 干活：
> 帮我把当前项目的所有 console.log 替换成 logger.info，并写一条单元测试常用斜杠命令速查：
默认无需账号密码，鉴权完全由 settings.json 中的 API Key 完成；图片可直接把文件拖入或 Ctrl+V 从剪贴板粘贴。
常见问题 FAQ
Q1：Deep Code 有 VS Code 插件吗？
A：有，CLI 与 VS Code 插件共享 ~/.deepcode/settings.json，终端配好后插件直接复用，无需重复填写 Key。
Q2：支持看图吗？
A：支持。deepseek-flash 可直接读取本地图片或剪贴板图片；deepseek-v4-pro 等非多模态模型会自动调用识图工具。
Q3：如何接入火山方舟 Coding Plan？
A：把 BASE_URL 改成方舟 Coding Plan 地址、MODEL 改成 ark-code-latest 即可，无需改代码。
Q4：任务完成后能自动发通知吗？
A：可以，写一个调用 Slack webhook 的脚本，在配置里把 notify 字段指向该脚本完整路径即可。
Q5：只能全自动执行吗？
A：不是，内置细粒度权限控制，可在 settings.json 的 permissions 字段为每类操作设置确认策略。
跳转链接
GitHub 仓库：https://github.com/lessweb/deepcode-cli
官方网站（中文）：https://deepcode.vegamo.cn
DeepSeek 官方接入文档：https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/deepcode/
API Key 申请：https://platform.deepseek.com/api_keys