Deep Code CLI与VSCode插件双端协同：共享配置与无缝切换开发工作流-平芜编程栈

Deep Code CLI与VSCode插件双端协同：共享配置与无缝切换开发工作流

【免费下载链接】deepcode-cliDeep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手，支持深度思考、推理强度控制以及 Agent Skills。项目地址: https://gitcode.com/gh_mirrors/de/deepcode-cli

Deep Code CLI 是一款专为 deepseek-v4 模型优化的终端 AI 编码助手，它提供与 VSCode 插件共享同一份配置和会话数据的双端协同能力：只写一次settings.json，就能在终端和编辑器之间无缝切换开发工作流，无需重复配置模型、API Key 和权限策略。

为什么需要 CLI + VSCode 插件双端协同？

不同任务适合不同的工作界面：

场景	推荐端	理由
长任务、跑测试、批量重构	Deep Code CLI	终端上下文小、可挂着后台跑，适合配合`/plan`模式
边写代码边问 AI、查看 Diff	Deep Code VSCode 插件	聊天面板与编辑器同屏，改完即见
需要读图片、贴截图给模型	双端皆可	均支持本地图片与剪贴板粘贴（`Ctrl+V`）

两端由同一个代码库维护（CLI 见 packages/cli/，插件见 packages/vscode-ide-companion/），共享配置文件和数据，但运行时互不依赖——关掉插件不影响 CLI，卸载 CLI 也不影响插件。

一份配置两端通用：settings.json 怎么写

在用户主目录创建~/.deepcode/settings.json，CLI 和 VSCode 插件读取的是同一个文件：

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

env.MODEL/env.BASE_URL/env.API_KEY：模型与接口信息，改一次两端同时生效
thinkingEnabled/reasoningEffort：思考模式与推理强度（low/high/max）
完整字段说明见 docs/configuration.md

此外还支持项目级配置：在项目根目录放.deepcode/settings.json，只对该项目生效，并覆盖用户级设置。适合"团队统一用deepseek-v4-pro、我个人某个小项目想省 token 改用deepseek-v4-flash"这类需求。

三步完成双端安装与配置

第 1 步：安装 CLI（需要 Node.js 22+）

npm install -g @vegamo/deepcode-cli

第 2 步：配置：按上文写入~/.deepcode/settings.json（一步配置，两端通用）。

第 3 步：安装 VSCode 插件：在 VSCode 扩展市场中搜索Deep Code并安装（插件标识vegamo.deepcode-vscode），重启后在侧边栏即可看到 Deep Code 聊天面板。

在任意项目目录下执行deepcode即可启动 CLI，启动界面会直接显示当前生效的模型、思考模式与推理强度，方便确认配置是否加载成功：

会话数据也共享：终端改一半，编辑器接着聊

除了配置，会话历史同样两端通用。Deep Code 按项目把会话持久化在本地：

~/.deepcode/projects/<project-code>/ ├── sessions-index.json # 会话索引（标题、状态、用量） ├── <session-id>.jsonl # 会话消息记录 └── file-history/.git # 供 /undo 使用的代码快照

这意味着一个非常顺手的切换姿势：

晚上在终端跑长任务：deepcode中执行重构，任务完成后按配置自动发通知（notify字段）
白天回到 VSCode：插件读取同一份会话索引，直接继续昨天的对话
CLI 里用/resume选择历史会话，或用/fork从某个节点分叉出新会话，插件端看到的也是同一套记录

会话机制（压缩、fork、/undo快照）详见 docs/session-persistence.md。

双端常用能力对照清单

能力	CLI	VSCode 插件
共享`~/.deepcode/settings.json`	✅	✅
深度思考 + 推理强度控制	✅	✅
Agent Skills（`.deepcode/skills/`、`.agents/skills/`）	✅	✅
MCP 外部工具（GitHub、数据库等）	✅	✅
图片理解（本地图片 /`Ctrl+V`粘贴）	✅	✅
`/plan`规划模式、`/undo`回滚	✅	✅
权限策略（允许/询问/拒绝）	✅	✅