Claude Code 用不了、或者你想用国产模型跑终端编程 Agent？DeepSeek 官方文档里已经把 Deep Code 挂上了推荐位。它是一个开源的终端 AI 编程助手，专为 DeepSeek-V4 模型打造，支持深度思考、推理强度控制和 Agent Skills。这篇把它是什么、能做什么、怎么装讲清楚。

Deep Code 是什么

官方原文一句话定义："Deep Code is an open-source terminal AI coding assistant for the DeepSeek-V4 model."

它是第三方开源项目（GitHub: lessweb/deepcode-cli，npm 包 @vegamo/deepcode-cli），基于 Node.js 技术栈，DeepSeek 在官方 API 文档的 Agent 集成页里把它列为推荐方案之一。定位上对标 Claude Code——同样是终端里跑、同样能调用技能、同样面向"写代码 + 改代码"的工程流程，但模型换成 DeepSeek-V4，配置文件和 VSCode 扩展共享同一套设置。

⚠️ 注意：DeepSeek 官方在文档里明确声明，这个 Agent 完全由第三方提供，仅作开发者参考，官方不保证其效果和安全性。使用前自行评估。

核心特性

• 深度思考（deep thinking）：默认对 deepseek-v4 系列模型开启，让模型在动手前先推理
• 推理强度可调：max 或 high 两档，控制模型"想多深"再行动
• Agent Skills：可扩展的技能系统，支持用户级和项目级两类技能
• Web 搜索工具：可在配置里开启，让 Agent 联网查资料
• VSCode 扩展：和终端 CLI 共享同一个 ~/.deepcode/settings.json，配置一次两边通用

三步上手

第一步：安装

需要 Node.js 18+。在终端运行：

npm install -g @vegamo/deepcode-cli

安装完成后，验证一下是否就绪（官方文档此处标注了 verify the installation，建议跑 deepcode --version 确认）。

第二步：配置 API Key 与模型

创建配置文件 ~/.deepcode/settings.json：

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

API Key 去 DeepSeek 开放平台（platform.deepseek.com）申请。常用模型名是 deepseek-v4-pro（旗舰）或 deepseek-v4-flash（轻量）。

主要配置项：

💡 提示：同一份配置文件会被 VSCode 扩展复用。先在终端配好，IDE 里直接可用。

第三步：进入项目目录并启动

cd /path/to/my-project
deepcode

启动后的常用快捷键：

Agent Skills 怎么用

技能（Skills）是 Deep Code 的扩展机制，从两个位置自动发现：

• 用户级：~/.agents/skills/<name>/SKILL.md
• 项目级：./.deepcode/skills/<name>/SKILL.md

按 / 打开技能选择器，或直接输入技能名调用（比如 /skill-writer）。这意味着你可以把团队里反复用的工作流（代码规范检查、特定框架的脚手架、文档生成）沉淀成技能文件，团队共享。

它适合谁

• 想用 DeepSeek-V4 做终端编程、但对 Claude Code 访问受限的开发者
• 团队想把内部工作流沉淀成可复用技能的工程团队
• 偏好开源、可自托管方案、不想被单一订阅绑定的用户

一句话总结

Deep Code 不是 DeepSeek 自研，但它填补了"DeepSeek-V4 + 终端编程 Agent"这个组合的空白。配置简单、技能可扩展、和 VSCode 共享配置，是目前用国产模型跑类 Claude Code 流程最直接的方案之一。用之前记得它是第三方项目，自己评估稳定性。