项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2192
使用教程
环境要求
- 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
下一篇:Mysti
同类项目推荐
code-interpreter
开源
在AI应用里安全跑代码,几行代码集成代码解释器
Python & JS/TS SDK for running AI-generated code/code interpreting in your AI app
voidmuse
开源
在 IDE 里玩转多模型 AI,边写代码边学习
Open-source AI IDE plugin for intelligent code completion, codebase indexing & multi···
autoprompt-skill
开源
给编码智能体加个技能,任务失败率直降45%
Autoprompt is a coding-agent skill that cuts failures by 45% on agentic coding tasks···
metis
开源
给 AI 编程加个项目经理,任务拆解+自动测试,代码一次过
Metis is a coding agent that boosts AI/LLM coding performance by 50% QQ群: 801193315
deepseek-harness-desktop
开源
把 DeepSeek 编码代理装进桌面,手机还能远程看
Compact DeepSeek Harness desktop host with a native SwiftUI iPhone Remote source pre···
shell_gpt
开源
在终端里用大白话指挥 AI,命令生成、脚本编写一步到位
A command-line productivity tool powered by AI large language models like GPT-5, wil···
CLIO
开源
在终端里用任意 AI 模型,高效搞定编码任务
An AI-assisted coding agent that runs in your terminal and supports many providers a···
revup
开源
一次提交,自动拆成多个关联 PR,评审更轻松
Upload once to create multiple, relative PRs. Productivity-focused git tools with pa···
evm-cortex
开源
让 AI 助手真正读懂 EVM,写合约不再靠猜
Ethereum protocol engineering squad for AI coding assistants
