Deep Code CLI快速上手指南:专为DeepSeek优化的终端AI编码助手,5步完成首次配置
【免费下载链接】deepcode-cliDeep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手,支持深度思考、推理强度控制以及 Agent Skills。项目地址: https://gitcode.com/gh_mirrors/de/deepcode-cli
Deep Code是专为deepseek-v4模型优化的终端 AI 编码助手(Deep Code CLI),支持深度思考、推理强度控制以及 Agent Skills 扩展。本指南面向新手,带你 5 步完成安装与首次配置,几分钟内就能在终端里跑起自己的 AI 编程助手。
第1步:确认环境要求
开始之前,请确认本机已满足两个前置条件:
- ✅Node.js 22 或更高版本(可运行
node -v检查) - ✅一个可用的 DeepSeek API Key
只要这两项就绪,即可开始安装。
第2步:一行命令安装 Deep Code CLI
打开终端,执行全局安装命令:
npm install -g @vegamo/deepcode-cli安装完成后,用下面命令验证版本:
deepcode --version能正常输出版本号,说明安装成功。
第3步:创建配置文件,接入 DeepSeek
创建~/.deepcode/settings.json文件,写入以下内容(把API_KEY替换为你自己的 DeepSeek API Key):
{ "env": { "MODEL": "deepseek-v4-pro", "BASE_URL": "https://api.deepseek.com", "API_KEY": "sk-..." }, "thinkingEnabled": true, "reasoningEffort": "max" }常用字段说明:
| 字段 | 说明 |
|---|---|
env.MODEL | 模型名称,推荐deepseek-v4-pro,也支持deepseek-v4-flash、deepseek-flash |
env.BASE_URL | DeepSeek API 地址,默认https://api.deepseek.com |
env.API_KEY | 你的 DeepSeek API Key |
thinkingEnabled | 是否启用思考模式(DeepSeek V4 系列默认开启) |
reasoningEffort | 推理强度,可选"low"、"high"、"max" |
💡小贴士:这个配置文件与 Deep Code VSCode 插件共享,配置一次即可在终端和编辑器之间无缝切换。也可以在项目目录中创建.deepcode/settings.json,为单个项目单独设置模型和权限,项目配置会覆盖用户配置。完整字段说明见 docs/configuration.md。
第4步:启动 Deep Code 并验证
进入任意项目目录,启动交互式界面:
cd path/to/your-project deepcode启动成功后,你会看到包含版本号、当前模型、思考模式和推理强度的信息面板。输入任务按Enter即可发送,也可以在启动时直接带着初始问题进入:
deepcode -p "总结这个项目"第5步:发送第一条任务,体验 AI 编码
建议新手先从只读任务开始,感受助手的理解能力:
总结这个仓库,并说明如何运行它。
熟悉之后,再让它动手改代码:
为登录校验逻辑添加一个单元测试。运行测试用例,并修复失败的测试。
如果任务比较复杂,可以先让它给方案再执行(Plan 模式,详见 docs/plan-mode.md):
在修改文件前,先给出一个为用户列表添加分页的计划。
⌨️常用按键速查:
| 操作 | 按键 |
|---|---|
| 发送消息 | Enter |
| 输入多行 | Shift+Enter或Ctrl+J |
| 中断当前回复 | Esc |
| 从剪贴板粘贴图片 | Ctrl+V |
| 退出 | 连续Ctrl+D或/exit |
常用斜杠命令:效率加倍
在输入框输入/即可打开命令菜单:
| 命令 | 作用 |
|---|---|
/new | 开始新对话 |
/resume | 选择历史对话继续 |
/model | 切换模型、思考模式和推理强度 |
/init | 为当前项目生成AGENTS.md说明文件 |
/skills | 查看可用 Agent Skills |
/mcp | 查看 MCP 服务状态和可用工具 |
/undo | 将代码和/或对话恢复到之前的状态 |
/exit | 退出 Deep Code |
其中/init值得一试:它会引导你创建AGENTS.md文件,记录项目依赖安装方式、代码风格、目录约定等内容,之后 Deep Code 在该项目中工作时会自动参考这些说明。
进阶方向:Skills、MCP 与权限控制
完成首次配置后,你可以按需解锁更多能力:
- 🔧Agent Skills:把代码审查、文档生成等可复用工作流固化为技能,放在
./.deepcode/skills/或~/.deepcode/skills/下即可被扫描加载。指南见 docs/agent-skills.md,内置技能位于 packages/core/templates/skills/bundled/ - 🔌MCP 集成:连接 GitHub、浏览器、数据库等外部服务,配置后运行
/mcp查看状态。指南见 docs/mcp.md - 🔒权限控制:细粒度配置 Shell 命令、文件读写等操作为「始终允许 / 询问 / 拒绝」。指南见 docs/permission.md
- 🔔任务完成通知:配置脚本在任务完成后自动发送 Slack、系统通知等。指南见 docs/notify.md
🎉 至此,你已完成 Deep Code CLI 的全部首次配置。完整快速开始文档见 docs/quickstart.md,更多架构与调优细节可参考 docs/architecture.md。祝编码愉快!
【免费下载链接】deepcode-cliDeep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手,支持深度思考、推理强度控制以及 Agent Skills。项目地址: https://gitcode.com/gh_mirrors/de/deepcode-cli
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考