deepcode-cli

English · 中文

Deep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手，支持深度思考、推理强度控制、Agent Skills 以及 MCP 集成。

安装

npm install -g @vegamo/deepcode-cli

在任意项目目录下运行 deepcode 即可启动。

配置

创建 ~/.deepcode/settings.json 文件，内容如下：

{
  "env": {
    "MODEL": "deepseek-flash",
    "BASE_URL": "https://api.deepseek.com",
    "API_KEY": "sk-..."
  },
  "thinkingEnabled": true,
  "reasoningEffort": "max"
}

配置文件与 Deep Code VSCode 插件 共享，无需重复配置。

完整配置说明（多层级优先级、环境变量等）请参阅 docs/configuration.md。

主要功能

Skills

Deep Code CLI 支持 agent skills，允许您扩展助手的能力：

Skills 会按以下优先级扫描：

为 DeepSeek 优化

• 专门为 DeepSeek 模型性能调优。
• 通过使用上下文缓存来降低成本。
• 原生支持思考模式和思考强度控制。

斜杠命令与按键功能

支持的模型

• deepseek-flash（推荐使用）
• deepseek-v4-pro
• deepseek-v4-flash
• deepseek-v4-flash-vision-exp
• 任何其他 OpenAI 兼容模型

架构和基准测试

Armin Ronacher 在《Better Models: Worse Tools》中指出，工具 schema 不是「中立的」：模型（LLM）会继承训练和强化学习中形成的工具使用习惯，因此可能在某个主流 harness 中表现很好，却在另一套工具形态下变得不稳定。这正是 Deep Code 的架构出发点：只为 DeepSeek 量身调优，从而让 harness 本身持续贴合 DeepSeek 的行为特点。

Deep Code 的收益来自于工具约束、上下文管理、Agent Skills 和权限策略等多项设计叠加后的结果。deepcode-qrcode-benchmark 项目展示了在一个真实且有难度的 Python 需求上，Deep Code + DeepSeek + /plan 模式相较 Claude Code + DeepSeek 的组合具有效果优势。

详见：Deep Code 架构

常见问题

Deep Code 是否有 VSCode 插件？

有的。Deep Code 提供功能完整的 VSCode 插件，可在 VSCode Marketplace 安装。插件与 CLI 共享 ~/.deepcode/settings.json 配置文件，可以在终端和编辑器之间无缝切换。

Deep Code 是否支持理解图片？

支持。deepseek-flash 模型支持直接读取本地图片或使用ctrl+v从剪贴板粘贴图片，让模型直接看到图片内容。

deepseek-v4-pro、deepseek-v4-flash 等非多模态模型仍会使用 UnderstandImage 识图工具。Deep Code 会自动判断模型能力，也可通过 multimodal 配置项手动覆盖。

默认情况下，图片会以 base64 内联发送给模型。启用 filesApiEnabled 后，Deep Code 会使用 DeepSeek Files API 上传图片并在请求中复用 file_id。详见 docs/configuration.md。

怎样在任务完成后自动给 Slack 发消息？

编写一个调用 Slack webhook 的 Shell 通知脚本，然后在 ~/.deepcode/settings.json 中将 notify 字段设为该脚本的完整路径即可。详细步骤请参考 docs/notify.md。

怎样启用联网搜索功能？

Deep Code 已支持 DeepSeek Responses API 的原生联网搜索能力。如果你希望使用自定义脚本进行联网搜索，可以在 ~/.deepcode/settings.json 中将 webSearchTool 设为脚本的完整路径即可。详细步骤可参考：https://github.com/qorzj/web_search_cli

如何配置 MCP？

Deep Code 支持 MCP（Model Context Protocol），可以连接 GitHub、浏览器、数据库等外部服务。在 settings.json 中配置 mcpServers 字段即可启用，启动后使用 /mcp 命令查看已配置的 MCP 服务器状态和可用工具。

详细配置指南：docs/mcp.md

如何配置 Deep Code 任务完成后发送通知？

当 AI 助手完成一轮任务后，Deep Code 可以自动执行一个通知脚本，将任务结果发送到你指定的渠道（如 Slack、系统通知等）。

详细配置指南：docs/notify.md

Deep Code 只支持 YOLO 模式吗？

不是。Deep Code 内置了细粒度的权限控制机制，支持在 AI 助手执行 Shell 命令、读写文件、访问网络等操作前进行确认。你可以通过 settings.json 中的 permissions 字段按需配置每种权限范围的策略：始终允许、始终询问、或直接拒绝。详见 docs/permission.md。

是否支持 Coding Plan？

支持。只要把 ~/.deepcode/settings.json 的 env.BASE_URL 配置为 OpenAI 兼容的接口地址就行。以火山方舟的 Coding Plan 为例：

{
  "env": {
    "MODEL": "ark-code-latest",
    "BASE_URL": "https://ark.cn-beijing.volces.com/api/coding/v3",
    "API_KEY": "**************"
  },
  "thinkingEnabled": true
}

贡献

欢迎贡献代码！以下是参与方式：

# 克隆仓库
git clone https://github.com/lessweb/deepcode-cli.git
cd deepcode-cli

# 安装依赖
npm install

# 运行测试
npm test

# CLI本地开发（类型检查 + lint + 格式检查 + 构建）
npm run build

# CLI链接到全局（即本地全局安装）
npm link

# VSCode插件本地开发
npm run build:vscode

• 提交 PR 前请确保 npm run check 通过（类型检查 + lint + 格式检查）
• 建议在执行构建前，先执行 npm run format 自动格式化代码，避免构建报错

获取帮助

• 在 GitHub Issues 上报告错误或请求功能 (https://github.com/lessweb/deepcode-cli/issues)

协议

• MIT

支持我们

如果你觉得这个工具对你有帮助，请考虑通过以下方式支持我们：

• 在 GitHub 上给我们一个 Star (https://github.com/lessweb/deepcode-cli)
• 向我们提交反馈和建议
• 分享给你的朋友和同事