产品与定位
Deep Code 是一款由社区团队（lessweb，官网 deepcode.vegamo.cn）开发的终端 AI 编码助手，只针对 DeepSeek 模型做调优。它已被 DeepSeek 官方 API 文档收录为推荐集成方案（api-docs.deepseek.com/quick_start/agent_integrations/deepcode），这是它区别于其他第三方 CLI 的最强背书。
它的设计出发点来自一个具体观察：工具 schema 并非中立 —— 模型在训练与强化学习中形成的工具调用习惯，会让它在某个 harness 里表现很好，换一套工具形态就不稳定。Deep Code 因此选择「只为一个模型系列量身调优」，让 harness 持续贴合 DeepSeek 的行为特点。
功能速览
| 功能 | 说明 |
|---|---|
| 深度思考控制 | 原生支持思考模式，reasoningEffort 可选 max / high |
| 上下文缓存 | 主动利用 DeepSeek 的 KV 缓存（自动前缀缓存）降低成本 |
| Agent Skills | 扫描 ./.deepcode/skills/、./.agents/skills/、~/.deepcode/skills/、~/.agents/skills/ |
| MCP 集成 | settings.json 配置 mcpServers，/mcp 查看服务器状态与可用工具 |
| 细粒度权限 | 对 shell 命令、文件读写、网络访问逐类设置「始终允许 / 始终询问 / 直接拒绝」 |
| 多模态识图 | README 称 deepseek-flash 可直接读图，非多模态模型自动改用 UnderstandImage 工具（官网 FAQ 与 README 表述不一致，见下文） |
| 联网搜索 | 支持 DeepSeek Responses API 原生联网搜索，也可挂自定义搜索脚本 |
| 通知回调 | 任务结束后执行 notify 脚本（可推 Slack、系统通知等） |
| VSCode 扩展 | 独立插件，与 CLI 共享同一个 ~/.deepcode/settings.json |
常用命令
| 命令 / 快捷键 | 作用 |
|---|---|
deepcode | 在项目目录启动 |
/model | 切换模型、思考模式与推理强度 |
/init | 初始化 AGENTS.md |
/skills | 列出可用 skills |
/mcp | 查看 MCP 服务器状态 |
/fork / /resume / /undo | 分叉会话 / 恢复历史 / 回滚代码与对话 |
Ctrl+V | 从剪贴板粘贴图片 |
调用与兼容性
# 需要 Node.js 18+
npm install -g @vegamo/deepcode-cli
deepcode --version创建 ~/.deepcode/settings.json：
{
"env": {
"MODEL": "deepseek-flash",
"BASE_URL": "https://api.deepseek.com",
"API_KEY": "sk-..."
},
"thinkingEnabled": true,
"reasoningEffort": "max"
}支持任意 OpenAI 兼容端点：把 BASE_URL 指向其他兼容服务（例如火山方舟的 Coding Plan）即可复用，不限于 DeepSeek 官方 API。
版本与更新注意
- 当前版本 v0.4.1（2026-09-17），仓库
lessweb/deepcode-cli（不是OpenBMB/DeepCode，该路径并不存在，两者是不同项目），MIT 许可，约 2,254 stars（截至 2026-09-22），仍在积极迭代。 - npm 包名是
@vegamo/deepcode-cli，与 GitHub 组织名lessweb不一致，安装时不要找错。 - 模型名在演进：当前主力为
deepseek-flash（DeepSeek-V4.1-Flash，1M 上下文）与deepseek-v4-pro（DeepSeek-V4-Pro-0813，1M 上下文）；deepseek-v4-flash与deepseek-v4-flash-vision-exp已被 DeepSeek 官方标记为退役别名（请求会由 DeepSeek-V4.1-Flash 承接并按 Flash 价格计费）。Deep Code 的 README 与示例中仍在使用旧模型名，属陈旧信息，配置时以 DeepSeek 官方定价页为准。 - 多模态能力存在文档矛盾：README 写明支持图片理解，但官网 FAQ 表示「目前 deepseek-v4 不支持多模态」，并建议多模态场景改用火山方舟 Doubao-Seed-2.0-pro。以实际使用前请以官网说明为准。
- Node 版本要求不一致：官方文档页写 Node.js 18+，而 npm 包的
engines字段要求node >= 22。稳妥起见按 Node 22+ 准备环境。 - 图片默认以 base64 内联发送；启用
filesApiEnabled后会改用 DeepSeek Files API 上传并以file_id复用。 - 不只有 YOLO 模式：内置细粒度权限控制，这也是它与许多「全自动」CLI 的差异点。
- 除开源 CLI 外还有商业订阅：官网提供 Plus 套餐（¥39.90/月）。CLI 本体为 MIT 开源，但配套服务是商业产品，选型时注意区分。
选型建议
- DeepSeek API 的重度用户 → 上下文缓存与思考模式的原生适配能直接省钱、省调参。
- 需要「终端 + VSCode 双端同一套配置」→ CLI 与插件共享
settings.json，切换无成本。 - 在意权限边界、不想让 Agent 无确认执行 shell → 逐类权限策略比
--yolo式设计更稳妥。 - 需要多模型自由切换或非 DeepSeek 模型 → 应看 Oh My Pi 或 Crush；Deep Code 的取舍就是「单一模型深度优化」。