Deep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手，支持深度思考、推理强度控制、Agent Skills 以及 MCP 集成。
npm install -g @vegamo/deepcode-cli在任意项目目录下运行 deepcode 即可启动。
创建 ~/.deepcode/settings.json 文件，内容如下：
{
"env": {
"MODEL": "deepseek-v4-pro",
"BASE_URL": "https://api.deepseek.com",
"API_KEY": "sk-..."
},
"thinkingEnabled": true,
"reasoningEffort": "max"
}配置文件与 Deep Code VSCode 插件 共享，无需重复配置。
完整配置说明（多层级优先级、环境变量等）请参阅 docs/configuration.md。
Deep Code CLI 支持 agent skills，允许您扩展助手的能力：
- User-level Skills：从
~/.agents/skills/目录中发现并激活 skills。 - Project-level Skills：从
./.agents/skills/目录中加载项目专属 skills，并兼容旧的./.deepcode/skills/目录。
| 斜杠命令 | 操作 |
|---|---|
/ |
打开 skills / 命令菜单 |
/new |
开始新对话 |
/resume |
选择历史对话继续 |
/model |
切换模型、思考模式和推理强度 |
/init |
初始化 AGENTS.md 文件 |
/skills |
列出可用 skills |
/mcp |
查看 MCP 服务器状态和可用工具 |
/exit |
退出（也可用连续 Ctrl+D） |
| 按键 | 操作 |
|---|---|
Enter |
发送消息 |
Shift+Enter |
插入换行（也可用 Ctrl+J） |
Ctrl+V |
从剪贴板粘贴图片 |
Esc |
中断当前模型回复 |
连续 Ctrl+D |
退出 |
deepseek-v4-pro（推荐使用）deepseek-v4-flash- 任何其他 OpenAI 兼容模型
有的。Deep Code 提供功能完整的 VSCode 插件，可在 VSCode Marketplace 安装。插件与 CLI 共享 ~/.deepcode/settings.json 配置文件，可以在终端和编辑器之间无缝切换。
Deep Code 支持多模态，可使用ctrl+v从剪贴板粘贴图片。但目前 deepseek-v4 不支持多模态。有些模型虽然有多模态能力，但对多轮对话请求的限制太严。目前多模态输入推荐使用火山方舟的 Doubao-Seed-2.0-pro 模型，适配效果最好。
编写一个调用 Slack webhook 的 Shell 通知脚本，然后在 ~/.deepcode/settings.json 中将 notify 字段设为该脚本的完整路径即可。详细步骤可参考：https://binfer.net/share/jby5xnc-so6g
Deep Code自带免费的、且大部分情况够用的Web Search工具。如果你希望使用自定义脚本进行联网搜索，可以在 ~/.deepcode/settings.json 中将 webSearchTool 设为脚本的完整路径即可。详细步骤可参考：https://github.com/qorzj/web_search_cli
Deep Code 支持 MCP（Model Context Protocol），可以连接 GitHub、浏览器、数据库等外部服务。在 settings.json 中配置 mcpServers 字段即可启用，启动后使用 /mcp 命令查看已配置的 MCP 服务器状态和可用工具。
详细配置指南：docs/mcp.md
支持。只要把 ~/.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
# 本地开发（类型检查 + lint + 格式检查 + 构建）
npm run build
# 运行测试
npm test
# 链接到全局（即本地全局安装）
npm link- 提交 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)
- 向我们提交反馈和建议
- 分享给你的朋友和同事