1. 为什么要在命令行和 VSCode 里同时装 Deep CodeDeep Code 是一个跑在终端里的 AI 编程助手专门针对 DeepSeek-V4 系列模型做了适配支持深度思考、推理强度控制、Agent Skills 以及 MCP 集成。它最大的特点是双端同源命令行版本CLI和 VSCode 插件共用同一份配置文件你在终端里配好的 API 通道打开编辑器就能直接复用不用来回折腾两套密钥。这篇文章要解决的问题很具体很多开发者第一次接触 Deep Code 时卡在 Node.js 版本、配置文件路径、API 通道地址这几步上装完 CLI 又想在 VSCode 里用结果发现两边配置对不上。我会把命令行和 VSCode 两条路径完整走一遍重点放在 Node.js 环境准备、API 通道配置、双端联调这三块每一步都给可复制的命令和配置片段。适合谁看已经会用 npm、想在本地快速搭一个 AI 编程助手的开发者习惯在终端里写代码、又想偶尔切到 VSCode 图形界面的同学以及之前装过类似工具但被 401、404 报错劝退的人。整篇按先装环境、再配通道、最后双端验证的顺序推进跟着敲一遍基本能跑通。需要提前说明一点Deep Code 本身只是个客户端它要调用大模型 API 才能工作。所以除了装工具你还得准备一个可用的 API 通道。下面会以 TaoToken 的 API 通道为例来配置因为它同时兼容 OpenAI 风格的接口配置项写起来比较直观。2. 前置准备Node.js 环境与 API 通道申请2.1 安装 Node.js 18 以上版本Deep Code 的 CLI 是通过 npm 分发的所以第一步是把 Node.js 装好。版本要求 18 及以上低于这个版本会在安装依赖时报错。去 Node.js 官网下载对应系统的安装包Windows 选 .msimacOS 选 .pkgLinux 用包管理器或者 nvm 都行。装完之后打开终端Windows 用 PowerShell 或 CMDmacOS/Linux 用默认终端验证一下node -v npm -v正常会输出类似v20.11.0和10.2.4的版本号。如果提示command not found说明环境变量没配好Windows 用户重新打开一个终端窗口通常就能解决macOS 用户检查一下是否用了 nvm 但没 source。这里有个容易踩的坑有些系统自带老版本 Node比如 v14 或 v16直接npm install -g会报EBADENGINE错误。遇到这种情况先升级 Node别硬装。2.2 申请 API 通道并拿到 KeyDeep Code 需要一个 API Key 才能调用模型。这里用 TaoToken 的 API 通道来演示它的接口地址是https://taotoken.net/api兼容 OpenAI 的请求格式配置起来比较省事。操作路径是先访问官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号然后进控制台创建 API Key。创建的时候建议给 Key 起个能认出来的名字比如deepcode-local方便以后区分不同用途的密钥。拿到 Key 之后先别急着关页面把它复制到记事本里存一下。这个 Key 只会完整显示一次关掉就看不到了只能重新生成。Key 的格式一般是一串以sk-开头的字符串。如果你还没决定用哪个模型可以在模型对话页面先试几个确认响应速度和效果符合预期再写进配置文件。模型对话入口在 https://taotoken.net/api 对应的控制台里能找到也可以直接走 deep linkhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。2.3 确认通道可用性在正式配置 Deep Code 之前建议先用一条 curl 命令确认通道是通的这样能把通道问题和客户端配置问题分开排查curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d { model: deepseek-v4-pro, messages: [{role: user, content: ping}] }如果返回一段包含choices字段的 JSON说明通道和 Key 都没问题。如果返回 401就是 Key 不对返回 404多半是模型名写错了。这一步花两分钟能省掉后面一堆来回试的时间。3. 可复制配置CLI 安装与 settings.json 写法3.1 全局安装 Deep Code CLI环境准备好之后安装 CLI 就是一条命令的事npm install -g vegamo/deepcode-cli装完验证deepcode --version能看到版本号就说明装好了。如果 npm 下载慢可以临时换源npm install -g vegamo/deepcode-cli --registryhttps://registry.npmmirror.com另外还有一个汉化版本deepcode-cli-cn全中文界面首次运行会自动弹配置向导适合不习惯英文界面的同学npm install -g deepcode-cli-cn两个版本不冲突但建议只留一个避免命令混淆。3.2 写配置文件 settings.jsonDeep Code 的配置集中在用户目录下的~/.deepcode/settings.json。不同系统的路径是WindowsC:\Users\你的用户名\.deepcode\settings.jsonmacOS / Linux~/.deepcode/settings.json如果.deepcode目录不存在手动建一个。然后用编辑器打开 settings.json写入下面这段配置{ env: { MODEL: deepseek-v4-pro, BASE_URL: https://taotoken.net/api, API_KEY: sk-你的真实API密钥 }, thinkingEnabled: true, reasoningEffort: max }这里三个关键字段必须写全也就是常说的三件套字段作用本例取值BASE_URLAPI 通道地址https://taotoken.net/apiAPI_KEY身份凭证sk-开头的一串字符MODEL调用的模型 IDdeepseek-v4-pro配置项说明补充几点thinkingEnabled控制是否开启深度思考模式deepseek-v4 系列默认就是 truereasoningEffort可选max或highmax 推理更充分但更慢日常写代码用 high 也够notify是可选字段填一个脚本路径任务完成后会触发通知。注意保存时务必确认文件扩展名是.json不是.txt。Windows 默认隐藏扩展名很容易存成settings.json.txt结果客户端读不到配置报API key not found。3.3 首次启动的自动向导如果你懒得手写配置也可以直接跑deepcode首次启动会自动弹出配置向导提示你输入 API Key输入后自动保存。这种方式适合快速试水但向导默认的 BASE_URL 可能不是你想要的通道所以正式用还是建议手写 settings.json把 BASE_URL 明确指向https://taotoken.net/api。3.4 VSCode 插件配置片段VSCode 插件和 CLI 共享同一份~/.deepcode/settings.json所以配置内容完全一样不需要重复写。安装插件的方式有两种方法 A打开 VSCode按Ctrl Shift X打开扩展面板搜索 Deep Code找到发布者对应的插件点安装。方法 B直接访问插件市场页面点 Install。装完建议重启一次 VSCode。重启后插件会自动读取~/.deepcode/settings.json如果之前 CLI 已经配好这里什么都不用做。如果你想把配置写进 VSCode 的工作区设置比如团队共享可以在项目根目录建.vscode/settings.json但注意 Deep Code 插件优先读用户目录的配置工作区配置只作为补充。真正决定 API 通道的还是~/.deepcode/settings.json里的三件套。4. 验证请求双端联调与成功结果确认4.1 命令行端验证配置写好后进入任意项目目录cd /path/to/your-project deepcode启动后会出现提示符输入一句测试指令比如请帮我分析一下这个项目的结构如果配置正确模型会开始流式输出分析结果。看到内容正常返回说明 CLI 端调用链路是通的。再试一个带文件操作的指令验证 Agent 能力在 src/utils 下创建一个 math.ts 文件并实现一个加法函数正常的话它会先说明计划然后创建文件。这一步能跑通说明不只是对话通了工具调用也正常。常用快捷键记几个就够Enter发送Shift Enter或Ctrl J换行Ctrl V粘贴图片Esc中断回复连按两次Ctrl D退出。斜杠命令里/model用来切换模型和推理强度/init在当前项目初始化 AGENTS.md/skills列出可用技能/mcp查看 MCP 服务器状态。这几个是高频操作建议先熟悉。4.2 VSCode 端验证打开 VSCode点左侧活动栏的 Deep Code 图标或者用命令面板搜索 Deep Code 打开面板。在输入框里输入同样的测试指令按 Enter 发送。插件会基于当前打开的项目上下文回答所以效果和 CLI 基本一致。如果这边也能正常返回说明双端联调成功——同一份配置两个入口都能用。有个小技巧如果你习惯把 AI 面板放在右侧可以在插件设置里把它移到 Secondary Side Bar写代码时视线不用来回跳。4.3 验证成功的判断标准怎么算真正配好了三个信号第一CLI 里deepcode启动后不报配置错误能正常对话第二VSCode 插件面板能返回内容且和 CLI 用的是同一个模型第三执行一次文件创建指令文件真的出现在磁盘上。三个都满足说明 Node.js 环境、API 通道、双端配置这条链路完整打通了。5. 常见报错排查401、404 与配置读取失败5.1 报错 API key not found这个报错几乎都是配置文件的问题。按顺序检查先确认~/.deepcode/settings.json文件确实存在。Windows 用户注意路径是C:\Users\你的用户名\.deepcode\settings.json不是当前项目目录。再确认文件扩展名是.json。前面提过Windows 隐藏扩展名时容易存成.json.txt用dir命令看一眼实际文件名。最后确认API_KEY字段填了真实 Key没有多余空格没有把示例里的sk-你的真实API密钥原样留着。5.2 报错 401 Unauthorized401 表示 Key 无效或过期。去控制台重新生成一个 Key更新到 settings.json 里。注意生成新 Key 后旧 Key 可能立即失效如果你在多台机器上用记得都更新。还有一种情况是 Key 复制时漏了字符尤其是结尾几位。建议从控制台复制后直接粘贴别手动敲。5.3 报错 404 Not Found404 通常是模型名写错了。检查MODEL字段是不是deepseek-v4-pro或deepseek-v4-flash拼写、大小写、连字符都要对。如果模型名没问题再检查BASE_URL是不是https://taotoken.net/api多一个斜杠或者少一段路径都可能导致 404。5.4 报错 local proxy failed 或连接超时这类报错说明客户端根本没连上通道。先确认网络能访问https://taotoken.net/api用前面那条 curl 命令测一下。如果 curl 通但 Deep Code 不通检查 settings.json 里的 BASE_URL 有没有写错或者有没有被其他环境变量覆盖。5.5 报错 reading choices 或返回结构异常如果日志里出现reading choices相关的解析错误一般是通道返回的 JSON 结构和客户端预期不一致。先确认 BASE_URL 指向的是兼容 OpenAI 格式的接口路径是/api而不是别的。如果确认无误还是报错换一个模型 ID 试试排除是特定模型的问题。5.6 CLI 和 VSCode 需要分别配置吗不需要。两者共享~/.deepcode/settings.json配置一次即可。如果 VSCode 插件读不到配置先确认插件版本是否最新再重启 VSCode。极少数情况下插件会缓存旧配置重启能解决。5.7 关于多模态输入Deep Code 本身支持Ctrl V粘贴图片但 deepseek-v4 系列目前不支持多模态。如果你确实需要图片输入得换支持视觉的模型配置方式一样只改 MODEL 字段即可。6. 长期使用建议与接入文档入口跑通之后日常使用还有几个点值得注意。配置文件建议做一次备份。~/.deepcode/settings.json里存着 Key换机器或者重装系统时直接复制过去就能用。但别把它提交到 Git 仓库Key 泄露了要立刻去控制台吊销重发。模型选择上日常写代码用deepseek-v4-flash响应更快、成本更低遇到复杂重构或者需要深度推理的任务再切到deepseek-v4-pro配合reasoningEffort: max。在 CLI 里用/model命令就能随时切换不用改配置文件。如果你打算把 Deep Code 用在长期项目里或者想接 Agent 工作流可以了解一下 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它更适合持续性的编码场景不用每次单独管额度。API Key 的管理入口在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 需要新建、吊销、查看用量都从这里进。完整的接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有针对不同客户端的配置示例遇到本文没覆盖的客户端可以对照着改。最后提醒一句装完先跑 curl 验证通道再写 settings.json最后双端各测一次。这个顺序能把问题定位在最小范围内比装完直接开用、报错了再回头查要省事得多。