deepcode-cli

在终端里用 deepseek-v4 深度思考，写代码更聪明

Deep Code 是一个专为 deepseek-v4 模型优化的终端 AI 编码助手，基于 TypeScript 开发。它解决了开发者在终端中高效使用 AI 编程的问题，提供了深度思考模式、推理强度控制以及 Agent Skills 等核心能力。通过命令行界面，开发者可以快速调用 deepseek-v4 模型进行代码生成、解释、重构等任务，并可根据需求调整模型的推理深度和强度，实现更精准的代码辅助。项目处于成长阶段，GitHub 星标已超 2000，社区关注度较高。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2254

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队lessweb

所属国家

官网地址https://deepcode.vegamo.cn

GitHubhttps://github.com/lessweb/deepcode-cli

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai-agent,deepseek

GitHub 星标★ 2254

30天Star增速

HF 下载量

上线时间2026-04-28 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数8

使用教程

难度：入门约 10 分钟部署方式：命令行工具 5 步

环境要求

Node.js 与 npm 环境（需支持 npm install -g 全局安装）
一个 DeepSeek API Key（形如 sk-...）
可正常访问 https://api.deepseek.com 的网络环境
一个可用的终端（macOS / Linux / Windows 终端均可）

安装与启动步骤

1全局安装 CLI

使用 npm 全局安装 @vegamo/deepcode-cli 包，安装完成后系统会新增 deepcode 命令。
```
npm install -g @vegamo/deepcode-cli
```
2创建配置目录

CLI 默认读取用户主目录下的 ~/.deepcode/settings.json，先创建该目录。
```
mkdir -p ~/.deepcode
```
3写入配置文件

在 ~/.deepcode/ 下新建 settings.json，填入 MODEL、BASE_URL、API_KEY 等环境变量及思考模式开关。
4启动 Deep Code

进入任意项目目录后运行 deepcode 即可启动；配置为全局共享，无需每个项目重复配置。
```
deepcode
```
5添加 Skills（可选）

把自定义技能放入项目级 ./.deepcode/skills/ 或 ./.agents/skills/ 目录即可被自动扫描加载。
```
mkdir -p ./.deepcode/skills
```

关键配置

配置项	必填	说明	示例
`env.MODEL`	是	指定使用的 DeepSeek 模型名称	`deepseek-v4-pro`
`env.BASE_URL`	是	DeepSeek API 服务地址	`https://api.deepseek.com`
`env.API_KEY`	是	调用模型的 API 密钥，需替换成自己的真实 Key	`sk-xxxxxxxxxxxxxxxx`
`thinkingEnabled`	否	是否开启深度思考模式	`true`
`reasoningEffort`	否	推理强度控制，影响思考深度	`max`
`mcpServers`	否	配置 MCP 服务器，连接 GitHub、浏览器、数据库等外部服务	`{}`

如何确认成功

在任意项目目录执行 deepcode，终端出现交互界面即启动成功；输入 /mcp 可查看已配置的 MCP 服务器状态。

常见问题

Q：启动后提示没有配置或模型调用失败怎么办？

A：检查 ~/.deepcode/settings.json 是否存在，并确认 env 中的 MODEL、BASE_URL、API_KEY 三项已正确填写，API_KEY 需为有效密钥。

Q：如何让 Deep Code 连接 GitHub、数据库等外部服务？

A：在 settings.json 中配置 mcpServers 字段启用 MCP，启动后用 /mcp 命令查看已配置的服务器与可用工具，详见 docs/mcp.md。

Q：任务完成后想收到通知怎么做？

A：Deep Code 支持在完成一轮任务后自动执行通知脚本，可发送到 Slack 或系统通知等渠道，配置见 docs/notify.md。

Q：Skills 放在哪个目录会被识别？

A：按优先级扫描项目级 ./.deepcode/skills/、./.agents/skills/ 以及用户级 ~/.deepcode/skills/、~/.agents/skills/ 四个位置。

注意事项

配置文件路径固定为 ~/.deepcode/settings.json，README 未提供自动生成配置的命令，需手动创建。
该配置文件与 Deep Code VSCode 插件共享，已配置过插件则无需重复配置。
多层级配置优先级、环境变量等完整说明请参阅 docs/configuration.md。
若从源码本地开发，可执行 npm install 安装依赖、npm test 运行测试、npm link 链接到全局。

核心亮点

针对 deepseek-v4 深度优化，推理质量更贴合模型特性
支持推理强度控制，灵活平衡速度与深度
集成 Agent Skills，可扩展复杂编码任务

不足之处

仅支持 deepseek-v4，模型绑定性强
文档/社区待观察

适用场景

终端内快速代码生成与补全
复杂逻辑推理与代码重构
结合 Agent Skills 的自动化编码流程

替代项目

Aider、OpenCode、Codex CLI

项目介绍

deepcode-cli 是编程开发领域的开源项目，由 lessweb 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（2,254）位列前 30%，在编程开发分类中处于中上游。

近 45 天，它的 GitHub 星标从 2,146 增加到 2,254，净增 108。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：终端内快速代码生成与补全。同类可对比的替代方案包括 Aider、OpenCode、Codex CLI。

上一篇：awesome-vibe-coding

下一篇：Mysti