Deep Code CLI

English · 中文

🎁 Atlas Cloud 是一个全模态、OpenAI 兼容的 AI 推理平台 —— 把 BASE_URL 指向 https://api.atlascloud.ai/v1 即可作为 Deep Code 的即插即用后端，通过单一 API 接入 DeepSeek、Claude、Qwen、GLM、Kimi、MiniMax 等模型，无需逐家厂商对接。预算友好的 coding plan。

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。

主要功能

Skills

Deep Code CLI 支持 agent skills，允许您扩展助手的能力：

Skills 会按以下优先级扫描：

Scope	Path	Purpose
Project	`./.deepcode/skills/`	Deep Code 原生位置
Project	`./.agents/skills/`	跨客户端互操作
User	`~/.deepcode/skills/`	Deep Code 原生位置
User	`~/.agents/skills/`	跨客户端互操作

为 DeepSeek 优化

专门为 DeepSeek 模型性能调优。
通过使用上下文缓存来降低成本。
原生支持思考模式和思考强度控制。

斜杠命令与按键功能

斜杠命令	操作
`/`	打开 skills / 命令菜单
`/new`	开始新对话
`/resume`	选择历史对话继续
`/continue`	继续当前对话，或选择历史对话恢复
`/model`	切换模型、思考模式和推理强度
`/raw`	切换显示模式（Normal / Lite / Raw 滚动回溯）
`/init`	初始化 AGENTS.md 文件
`/skills`	列出可用 skills
`/mcp`	查看 MCP 服务器状态和可用工具
`/undo`	将代码和/或对话恢复到之前的状态
`/exit`	退出（也可用连续 `Ctrl+D`）

按键	操作
`Enter`	发送消息
`Shift+Enter`	插入换行（也可用 `Ctrl+J`）
`Ctrl+V`	从剪贴板粘贴图片
`Esc`	中断当前模型回复
连续 `Ctrl+D`	退出

支持的模型

deepseek-v4-pro（推荐使用）
deepseek-v4-flash
任何其他 OpenAI 兼容模型，例如 Atlas Cloud 提供的 300+ 个模型（deepseek-ai/DeepSeek-V3-0324、anthropic/claude-sonnet-4.6 等）

常见问题

Deep Code 是否有 VSCode 插件？

有的。Deep Code 提供功能完整的 VSCode 插件，可在 VSCode Marketplace 安装。插件与 CLI 共享 ~/.deepcode/settings.json 配置文件，可以在终端和编辑器之间无缝切换。

Deep Code 是否支持理解图片？

Deep Code 支持多模态，可使用ctrl+v从剪贴板粘贴图片。但目前 deepseek-v4 不支持多模态。有些模型虽然有多模态能力，但对多轮对话请求的限制太严。目前多模态输入推荐使用火山方舟的 Doubao-Seed-2.0-pro 模型，适配效果最好。

怎样在任务完成后自动给 Slack 发消息？

编写一个调用 Slack webhook 的 Shell 通知脚本，然后在 ~/.deepcode/settings.json 中将 notify 字段设为该脚本的完整路径即可。详细步骤请参考 docs/notify.md。

怎样启用联网搜索功能？

Deep Code自带免费的、且大部分情况够用的Web Search工具。如果你希望使用自定义脚本进行联网搜索，可以在 ~/.deepcode/settings.json 中将 webSearchTool 设为脚本的完整路径即可。详细步骤可参考：https://github.com/qorzj/web_search_cli

如何配置 MCP？

Deep Code 支持 MCP（Model Context Protocol），可以连接 GitHub、浏览器、数据库等外部服务。在 settings.json 中配置 mcpServers 字段即可启用，启动后使用 /mcp 命令查看已配置的 MCP 服务器状态和可用工具。

详细配置指南：docs/mcp.md

如何配置 Deep Code 任务完成后发送通知？

当 AI 助手完成一轮任务后，Deep Code 可以自动执行一个通知脚本，将任务结果发送到你指定的渠道（如 Slack、系统通知等）。

详细配置指南：docs/notify.md

Deep Code 只支持 YOLO 模式吗？

不是。Deep Code 内置了细粒度的权限控制机制，支持在 AI 助手执行 Shell 命令、读写文件、访问网络等操作前进行确认。你可以通过 settings.json 中的 permissions 字段按需配置每种权限范围的策略：始终允许、始终询问、或直接拒绝。详见 docs/permission.md。

是否支持 Coding Plan？

支持。只要把 ~/.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
}

是否支持 Atlas Cloud？

支持。Atlas Cloud 是一个 OpenAI 兼容的全模态 AI 推理平台，通过统一 API 提供 LLM、图像生成、视频生成共 300+ 个模型的接入。配置示例：

{
  "env": {
    "MODEL": "deepseek-ai/deepseek-v4-pro",
    "BASE_URL": "https://api.atlascloud.ai/v1",
    "API_KEY": "your-atlascloud-api-key"
  },
  "thinkingEnabled": true,
  "reasoningEffort": "max"
}

deepseek-ai/deepseek-v4-pro 是推理模型，需要给足输出预算（≥ 512 tokens），否则可能在思维链处停止、返回空 content。也可以使用 Claude、Qwen 等其他模型，API Key 在 Atlas Cloud 控制台获取。

全部 Atlas Cloud 对话模型（59 个，OpenAI 兼容）

Anthropic（Claude）： anthropic/claude-haiku-4.5-20251001、anthropic/claude-opus-4.8、anthropic/claude-sonnet-4.6
OpenAI（GPT）： openai/gpt-5.4、openai/gpt-5.5
Google（Gemini）： google/gemini-3.1-flash-lite、google/gemini-3.1-pro-preview、google/gemini-3.5-flash
阿里（Qwen）： qwen/qwen2.5-7b-instruct、Qwen/Qwen3-235B-A22B-Instruct-2507、qwen/qwen3-235b-a22b-thinking-2507、qwen/qwen3-30b-a3b、Qwen/Qwen3-30B-A3B-Instruct-2507、qwen/qwen3-30b-a3b-thinking-2507、qwen/qwen3-32b、qwen/qwen3-8b、Qwen/Qwen3-Coder、qwen/qwen3-coder-next、qwen/qwen3-max-2026-01-23、Qwen/Qwen3-Next-80B-A3B-Instruct、Qwen/Qwen3-Next-80B-A3B-Thinking、Qwen/Qwen3-VL-235B-A22B-Instruct、qwen/qwen3-vl-235b-a22b-thinking、qwen/qwen3-vl-30b-a3b-instruct、qwen/qwen3-vl-30b-a3b-thinking、qwen/qwen3-vl-8b-instruct、qwen/qwen3.5-122b-a10b、qwen/qwen3.5-27b、qwen/qwen3.5-35b-a3b、qwen/qwen3.5-397b-a17b、qwen/qwen3.6-35b-a3b、qwen/qwen3.6-plus
DeepSeek： deepseek-ai/deepseek-ocr、deepseek-ai/deepseek-r1-0528、deepseek-ai/DeepSeek-V3-0324、deepseek-ai/DeepSeek-V3.1、deepseek-ai/DeepSeek-V3.1-Terminus、deepseek-ai/deepseek-v3.2、deepseek-ai/DeepSeek-V3.2-Exp、deepseek-ai/deepseek-v4-flash、deepseek-ai/deepseek-v4-pro
Moonshot（Kimi）： moonshotai/Kimi-K2-Instruct、moonshotai/Kimi-K2-Instruct-0905、moonshotai/Kimi-K2-Thinking、moonshotai/kimi-k2.5、moonshotai/kimi-k2.6
智谱（GLM）： zai-org/GLM-4.6、zai-org/glm-4.7、zai-org/glm-5、zai-org/glm-5-turbo、zai-org/glm-5.1、zai-org/glm-5v-turbo
MiniMax： MiniMaxAI/MiniMax-M2、minimaxai/minimax-m2.1、minimaxai/minimax-m2.5、minimaxai/minimax-m2.7
xAI： xai/grok-4.3
快手（KAT）： kwaipilot/kat-coder-pro-v2
其他： owl

贡献

欢迎贡献代码！以下是参与方式：

# 克隆仓库
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)

协议

支持我们

如果你觉得这个工具对你有帮助，请考虑通过以下方式支持我们：

在 GitHub 上给我们一个 Star (https://github.com/lessweb/deepcode-cli)
向我们提交反馈和建议
分享给你的朋友和同事

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Deep Code CLI

安装

配置

主要功能

Skills

为 DeepSeek 优化

斜杠命令与按键功能

支持的模型

常见问题

Deep Code 是否有 VSCode 插件？

Deep Code 是否支持理解图片？

怎样在任务完成后自动给 Slack 发消息？

怎样启用联网搜索功能？

如何配置 MCP？

如何配置 Deep Code 任务完成后发送通知？

Deep Code 只支持 YOLO 模式吗？

是否支持 Coding Plan？

是否支持 Atlas Cloud？

贡献

获取帮助

协议

支持我们

Uh oh!

FilesExpand file tree

README-zh_CN.md

Latest commit

History

README-zh_CN.md

File metadata and controls

Deep Code CLI

安装

配置

主要功能

Skills

为 DeepSeek 优化

斜杠命令与按键功能

支持的模型

常见问题

Deep Code 是否有 VSCode 插件？

Deep Code 是否支持理解图片？

怎样在任务完成后自动给 Slack 发消息？

怎样启用联网搜索功能？

如何配置 MCP？

如何配置 Deep Code 任务完成后发送通知？

Deep Code 只支持 YOLO 模式吗？

是否支持 Coding Plan？

是否支持 Atlas Cloud？

贡献

获取帮助

协议

支持我们