Claude 桌面端 与 VS Code 接入 DeepSeekAPI 教程

想用 Claude 的操作界面、模型接 DeepSeek,可以选两种方法:在桌面端用 CC Switch 管理接口,或者在 VS Code 里使用 Claude Code。这篇会分别讲安装和 API 配置,也会带你把 VS Code、Claude Code 的界面改成中文。扩展市场打不开时,后面有 VSIX 本地安装步骤。

更新于 2026-10-19已查看 4 次Windows / macOS
下载教程Markdown飞书文档保存到本地,随时查阅
文章目录(40 节)

适用系统:Windows 与 macOS
作者:伯伦
更新日期:2026 年 10 月 18 日

想用 Claude 的操作界面、模型接 DeepSeek,可以选两种方法:在桌面端用 CC Switch 管理接口,或者在 VS Code 里使用 Claude Code。这篇会分别讲安装和 API 配置,也会带你把 VS Code、Claude Code 的界面改成中文。扩展市场打不开时,后面有 VSIX 本地安装步骤。

装过类似软件的,可以先看快速版;第一次用,就跟着详细步骤往下做。文中会给出下载入口和配置方法。遇到界面或价格变化,以官网和自己的账户页面为准。

先选一种用法,跟着对应步骤做。两条路线可以分别安装。

使用方式本文对应内容
在 Claude 桌面应用中使用 DeepSeek路线一,使用 CC Switch 管理模型接口
在 VS Code 中使用 Claude Code路线二,包含编辑器与 Claude Code 汉化、VSIX 本地安装

安装前准备

先看电脑系统和芯片

Windows:打开“开始 → 设置 → 系统 → 关于”,看清系统版本和系统类型。

  • 显示“基于 x64 的处理器”,选择 Windows x64、64 位或 AMD64 安装包。
  • 显示“基于 ARM 的处理器”,选择 Windows ARM64 安装包,并确认软件支持该架构。

Mac:点击左上角苹果菜单 → 关于本机。

  • Apple M 系列芯片,选择 Apple Silicon、ARM64 或 aarch64。
  • Intel 处理器,选择 Intel 或 x64。
  • 看到 Universal 通用包时,按下载页说明选择,通常可以同时支持两种芯片。

选定路线后,再核对 Claude 或 VS Code、CC Switch 等组件的系统和芯片要求,分别下载兼容的安装包。

账号和工作目录

准备自己的 DeepSeek 开放平台账号、API Key 和可用余额。密钥自己创建、自己保管,发截图或分享配置时记得遮住。两条路线的配置位置不同,按选定的路线填写。

先建一个 AI-Workspace 文件夹。Windows 可以放在用户目录或数据盘,Mac 可以放在“文稿”中,再在里面建一个测试目录:

纯文本
AI-Workspace/
  claude-test/
  claude-vscode-test/

第一次验证用空文件夹,权限保留询问或手动确认。选了工作目录,仍要留意后续的权限提示。几款智能体一起处理同一个项目时,先分好各自负责的文件,避免同时改同一份内容。

下载或登录失败时

下载或登录卡住时,先看具体报错,再检查网络、系统时间和官方服务状态。也要确认软件支持你的系统和使用地区,账号符合要求。公司或学校的电脑,还要看管理员是否允许安装和连接。

页面提示地区、账号或付款方式不符合要求时,按官方说明处理。条件暂时不满足,就先用自己能正常访问的工具。

路线一 Claude 桌面端通过 CC Switch 接入 DeepSeek API

软件与模型分工

桌面端这条路线要装 Claude 和 CC Switch。你在 Claude 里对话,实际生成回答的是 DeepSeek 官方 API。

软件和模型服务各自负责这些事:

名称在本教程中的作用
Claude Desktop桌面操作界面,以及当前版本提供的对话和工具功能
CC Switch保存模型提供方配置、写入桌面端配置,并在需要时运行本地模型映射服务
DeepSeek API实际生成回答的模型服务,按 DeepSeek 账户规则计费

Claude 原生服务有地区和账号要求。这里先用 DeepSeek 官方 API;以后符合其他模型服务的使用条件,再添加对应配置。服务范围参见 Anthropic 支持地区政策。

我用 CC Switch,主要是为了以后换模型省事:接口地址、密钥和模型配置都放在一处管理,不用每次手动改文件。它能切换配置,服务商的地区和账号要求仍要另外满足。

Claude 桌面端提供第三方推理配置,CC Switch 是单独的开源工具。接上以后,能用哪些工具、运行是否稳定,还得看模型和软件版本。相关机制参见 Claude Desktop 第三方模式说明。

桌面端安装前准备

准备以下内容:

  • 与系统兼容的 Claude 桌面端安装包。
  • 提供 Claude Desktop 配置页的新版 CC Switch。
  • 自己的 DeepSeek 开放平台账号、API Key 和可用余额。

这部分步骤参照 2026 年 10 月 17 日核对的 CC Switch v4.0.14 稳定版文档。你下载时选项目发布的当前稳定版即可,不用专门找同一个版本号。

需要用 Cowork 处理工作任务时,还要看电脑是否满足它的要求。官方当前列出 macOS 14 或更高版本;Windows 10 build 19041 或更高版本,支持 x64 与 Arm64。Cowork 还需要硬件虚拟化,Windows 需要 Virtual Machine Platform 组件并使用 .msix 安装包。设备不确定时,可先使用官方准备情况检查工具。参见 Claude 桌面端安装与设备要求。

桌面端快速安装

  1. 从 Claude 官方下载页 安装桌面应用;首次打开出现登录页时,先退出,完成下面的第三方配置。
  2. 从 CC Switch 项目发布页 安装当前稳定版。
  3. 在 DeepSeek 开放平台 登录,检查余额并创建 API Key。
  4. 打开 CC Switch,选择 Claude Desktop,进入添加供应商。
  5. 选择 DeepSeek 官方预设,或使用自定义配置,填写 DeepSeek API Key。
  6. 使用本路线的模型映射方案:上游格式选 Anthropic Messages,接口地址填 https://api.deepseek.com/anthropic,实际请求模型填 deepseek-flash。
  7. 添加后切换到该供应商,确认本地路由服务运行,再完全退出并重开 Claude 桌面端。
  8. 按客户端提供的第三方配置入口进入对话,发送验证消息,并核对 DeepSeek 的调用记录。

本路线使用模型映射时,CC Switch 需要在使用过程中保持运行。菜单中出现的 Sonnet、Opus、Haiku 是映射入口;实际调用哪款模型,要看 CC Switch 中的配置。

桌面端详细步骤

第一步 安装 Claude 桌面端

浏览器打开 Claude 官方下载页。

Windows:根据设备选择 x64 或 ARM64 对应入口,运行官方安装包,按系统提示完成安装。需要 Cowork 时,使用当前官方支持该功能的安装方式。

Mac:下载兼容的 .dmg,双击打开,将 Claude 拖入“应用程序”。复制结束后,从“应用程序”启动。

第一次打开时,如果停在 Claude 登录页,先退出,继续配 CC Switch。DeepSeek API Key 稍后填到 CC Switch 的供应商设置里。

第二步 安装 CC Switch

打开 CC Switch 官方项目,从 Releases 进入当前稳定版下载页。也可以从项目标明的官网 ccswitch.io 进入下载。

Windows 普通 x64 电脑选择对应的 Windows .msi。Windows ARM 设备选择文件名带 Windows-arm64 的包。双击安装,按向导完成。

Mac 选择 macOS .dmg。项目当前提供 Universal 通用包,支持 Apple 芯片和 Intel;打开后将 CC Switch 拖入“应用程序”。

CC Switch 本身免费、开源,首次安装不要求先配置 Node.js。具体系统要求和安装包名称参见 CC Switch 安装指南。

第三步 获取 DeepSeek API Key

打开 DeepSeek 开放平台,用自己的账号登录。

  1. 查看账户余额。余额不足时,按页面支持的方式按需充值。
  2. 打开 API keys 或 API 密钥页面。
  3. 点击创建,名称可以填写 Claude-Desktop。
  4. 复制完整密钥,保存在自己能够妥善管理的位置。

DeepSeek 聊天页面的使用权益和 API 余额分别管理。创建密钥不会自动充值,软件调用 API 会按实际用量计费。参见 DeepSeek API 入门。

API Key 可以调用你账户里的余额。粘贴时检查有没有多出空格,公开截图要遮住;已经泄露的,就到开放平台撤销,再建一个新的。

第四步 在 CC Switch 选择正确的应用

打开 CC Switch,在应用列表中选择 Claude Desktop。

这一步容易选错。CC Switch 里的“Claude”或“Claude Code”管理的是 Claude Code;桌面端要选名称写着 Claude Desktop 的页面。

看不到该入口时,先更新 CC Switch,再到“应用”设置中确认 Claude Desktop 已显示在侧栏。详细界面说明见 CC Switch 应用界面指南。

VS Code 路线使用的 ~/.claude/settings.json 属于 Claude Code 配置。桌面端使用自己的第三方配置,按本路线在 CC Switch 的 Claude Desktop 页管理;两条路线各自配置。

第五步 添加 DeepSeek 官方供应商

在 Claude Desktop 页点击“添加供应商”或加号。

有 DeepSeek 官方预设时优先选择它,再逐项核对接口和模型。找不到合适预设时,选择自定义供应商,按下表填写:

配置项本教程填写内容
供应商名称DeepSeek 官方 API,便于自己识别即可
API Key在 DeepSeek 开放平台创建的完整密钥
上游 API 格式Anthropic Messages 或对应的 Anthropic 兼容格式
接口地址https://api.deepseek.com/anthropic
接入方式模型映射,或打开“需要模型映射”

表中的地址是 DeepSeek 官方提供的 Anthropic 兼容接口。保持接口格式与地址配套;这里只填写基础接口地址,不额外拼接 /messages。协议说明见 DeepSeek Anthropic API 使用指南。

不同版本的字段名称可能有些变化。预设会帮你填好常用项,保存前再看一遍密钥和实际请求模型。供应商表单说明见 CC Switch 添加供应商指南。

第六步 配置模型映射

首次验证时,我建议把几个角色入口都指向 deepseek-flash,配置如下:

模型角色建议菜单显示名实际请求模型
SonnetDeepSeek Flash 主对话deepseek-flash
OpusDeepSeek Flash 备用入口deepseek-flash
HaikuDeepSeek Flash 轻量入口deepseek-flash

这里的 Sonnet、Opus、Haiku 是桌面端的入口名称。按这份配置,三个入口调用的都是同一个 DeepSeek 模型。

实际请求模型填写 deepseek-flash,不照搬旧 Claude Code 配置里的 [1m] 后缀。若表单提供 1M 选项,首次验证先保留关闭;需要更大上下文时,再按该模型当时的能力说明设置。

模型映射由 CC Switch 在本机完成,相关机制见 CC Switch Claude Desktop 配置指南。DeepSeek 当前可用模型名称以 官方 API 文档 为准。

保存前看一遍接口格式、地址、密钥和模型名,确认它们配套。DeepSeek 地址要用 DeepSeek Key,别把不同服务商的配置混在一起。

第七步 切换配置并重启 Claude

保存供应商后,回到列表,在刚添加的 DeepSeek 卡片上点击“切换”或当前版本对应的启用按钮。

确认卡片显示为使用中,页面的本地路由服务显示运行中。采用模型映射时,CC Switch 会自动管理这项服务,使用过程中保留 CC Switch 运行。

接着完全退出 Claude 桌面端,再重新打开。Mac 可以使用 Command + Q;Windows 从应用菜单或托盘选择退出。只关闭一个窗口,可能仍有后台进程。

桌面端在启动时加载第三方配置。以后切换供应商后,也按这个顺序重启。参见 CC Switch 切换与生效说明。

第八步 进入第三方模式并验证

重新打开 Claude。客户端提供按已配置的第三方推理设置启动的选项时,选择对应入口。

如果仍只有普通 Claude 登录页,先回到 CC Switch,确认选中的是 Claude Desktop,重新切换 DeepSeek 并重启。官方第三方模式允许使用已配置的推理提供方启动;排查方法见 Claude 第三方模式安装与检查说明。

进入桌面对话页,选择前面配置的 DeepSeek Flash 入口,发送:

纯文本
只回复“连接成功”。不要读取或修改本地文件,不要调用工具,也不要运行命令。

收到回复后,回到 DeepSeek 开放平台查看相应时间的用量或账单。记录可能延迟,稍后刷新再核对;如果账户同时有其他调用,还要结合时间和 CC Switch 的请求记录判断。

别只看模型说“我是 DeepSeek”,也别只看菜单名称。把 CC Switch 里的供应商、实际请求模型和 DeepSeek 用量记录一起核对,才能确认请求走到了哪里。

再完全退出并重开 Claude,发一次最小验证消息,确认配置可以重复生效。这里完成的是基础对话连接;需要处理本地文件时,再选择工作模式或 Code 入口,授权 claude-test,另外验证对应工具能力。

以后如何切换其他 API

先保留已经可用的 DeepSeek 配置。等你具备其他模型服务要求的地区、账户资格和 API Key 后,再新增相应供应商:

  1. 在 CC Switch 的 Claude Desktop 页添加该提供方。
  2. 使用该提供方的官方接口地址、自己的 API Key 和当前可用模型名称。
  3. 根据预设与实际模型 ID,配置适合的直连或模型映射方式。
  4. 保存并切换,完全退出再重开 Claude。
  5. 发最小验证消息,核对对应提供方的用量和计费。

例如以后需要接入 Claude 官方 API,使用自己的 Anthropic API 凭证,按该官方预设与文档配置。CC Switch 中的 Claude Desktop Official 用于恢复 Claude 账号登录模式;Claude 官方 API 则使用 API 凭证和相应 API 账单。两种方式要分别确认,购买会员不等于获得相同金额的 API 余额。

配置保存好后,以后就在 CC Switch 里切换。某家服务能不能用,还要看它的支持范围、你的账号和网络条件。

桌面端常见问题

情况排查顺序
CC Switch 中没有 Claude Desktop更新到支持该入口的稳定版,再检查侧栏应用显示设置
改了配置但 Claude 没变化确认管理的是 Claude Desktop,再完全退出并重开 Claude
一直出现普通 Claude 登录页重新切换桌面端供应商;检查客户端版本与第三方配置状态
关闭 CC Switch 后无法请求本路线使用模型映射,需要 CC Switch 和本地路由服务保持运行
本地路由没启动查看 CC Switch 的错误提示;端口冲突时按应用说明调整,再重新切换配置
401 或鉴权失败检查密钥是否完整、有效,是否来自 DeepSeek 开放平台
余额不足登录创建该密钥的 DeepSeek 账号检查余额
模型名错误或请求被拒绝核对实际模型 ID;本路线使用 deepseek-flash,不要附加旧 CLI 的上下文标记
404 或接口路径错误核对 Anthropic Messages 与 /anthropic 地址是否配套,是否误加了请求路径
429 或服务繁忙查看限流与服务状态提示,减少同时请求,按提示稍后重试
菜单写着 Sonnet 或 Opus核对角色映射及菜单显示名;真实调用取决于实际请求模型
能聊天,但文件操作或插件失败基础连接与工具能力分别检查,继续核对模型兼容性、目录授权及本地工作环境

日常启动与更新

日常顺序是:打开 CC Switch → 确认 Claude Desktop 当前选中 DeepSeek 且本地路由运行 → 打开 Claude 桌面端。

Claude 使用官方更新入口;CC Switch 使用项目官方稳定版。更新后先发一条最小消息,确认配置仍可用,再继续原来的工作。分享截图或配置备份前,检查是否含有密钥及个人项目内容。

路线二 Claude Code 在 VS Code 中接入 DeepSeek

适合什么情况

习惯在 VS Code 里操作,或者没有 VPN 条件、所在网络不允许使用 VPN,可以看这条路线。先装 VS Code 和官方 Claude Code 扩展,把模型请求接到 DeepSeek 官方 API,再把两个界面改成中文。

以后从 VS Code 的 Claude Code 面板使用。按这里的步骤就能单独配置,不用先装 Claude 桌面端或 CC Switch,也不用先买 Claude 会员。

先确认两件事:能不能拿到软件和扩展安装包,电脑能不能连接 DeepSeek API。这两件事要分开查。模型接入 DeepSeek 后,下载扩展和使用联网工具仍各有网络要求。按所在网络允许的方式准备文件,先试基础对话,再试你需要的工具。

DeepSeek 的官方接入参数见 接入 Claude Code,扩展配置机制见 Claude Code 的 VS Code 指南。

先分清两种汉化

要设置的部分使用的扩展扩展标识
VS Code 的菜单、设置和主界面Microsoft 简体中文语言包MS-CEINTL.vscode-language-pack-zh-hans
Claude Code 扩展里的可见界面文字社区 Claude Code zh-CN 中文汉化包shanjiancaofu.claude-code-zh-cn-patch-helper

先装官方扩展 Anthropic.claude-code,再给 Claude Code 应用汉化。只装微软语言包,第三方扩展的界面不一定会跟着变成中文。

Claude Code 汉化包由社区维护,会备份并修改本机扩展的部分界面文字。它和官方 Claude Code 是两个扩展,功能与恢复方法见 汉化包项目说明。

VS Code 快速安装

  1. 从 VS Code 官网 安装与系统兼容的当前稳定版。
  2. 安装微软简体中文语言包,切换为 zh-cn 并重启。
  3. 安装官方 Anthropic.claude-code 扩展。
  4. 安装 Claude Code 中文汉化包,执行 Claude Code Zh-CN Patch: Apply Patch,确认后执行 Developer: Reload Window。
  5. 在 DeepSeek 开放平台 检查余额并创建自己的 API Key。
  6. 将本路线完整 JSON 配置保存到用户目录的 .claude/settings.json。
  7. 在 VS Code 用户设置中开启 claudeCode.disableLoginPrompt,完全退出并重开 VS Code。
  8. 打开 claude-vscode-test 文件夹和 Claude Code 面板,发送最小验证消息,核对 DeepSeek 调用记录。

扩展市场打不开时,先看下文“扩展市场打不开时使用 VSIX 安装”一节。官方扩展自带面板所需的 CLI 组件;本路线使用面板,不要求先执行 npm 全局安装命令。参见 官方扩展与 CLI 的区别。

VS Code 详细步骤

第一步 安装 VS Code

打开 VS Code 官方下载页,根据电脑选择安装包。

Windows:一般选择匹配架构的 User Installer。运行安装程序,按提示确认协议和安装位置;可保留“添加到 PATH”“使用 Code 打开”等便捷选项,安装完成后启动。

Mac:根据芯片选择 Apple Silicon、Intel 或官网提供的 Universal 包。下载的是 .zip 时先解压,再把 Visual Studio Code 拖入“应用程序”,从那里启动。

这里用电脑安装版。下载前看清系统要求,安装包打不开时,先查系统和架构是否匹配,别反复尝试同一个不兼容的包。

第二步 把 VS Code 改成中文

  1. 打开左侧“扩展 / Extensions”。Windows 按 Ctrl + Shift + X;Mac 按 Command + Shift + X。
  2. 在搜索框输入 @id:MS-CEINTL.vscode-language-pack-zh-hans。
  3. 核对名称是简体中文语言包,发布者为 Microsoft,点击安装。
  4. 按提示选择切换语言并重启。

没有出现切换提示时,打开命令面板:Windows 按 Ctrl + Shift + P;Mac 按 Command + Shift + P。搜索 Configure Display Language,选择中文简体或 zh-cn,再重启 VS Code。

重开后,文件、编辑、查看、设置等主菜单应显示为中文。参见 微软语言包页面 和 显示语言说明。

第三步 安装官方 Claude Code 扩展

回到扩展面板,输入 @id:Anthropic.claude-code,找到 Claude Code for VS Code,确认发布者为 Anthropic,点击安装。

也可以从 官方扩展市场页面 进入安装。

如果扩展打开普通 Claude 登录页,先完成后面的 DeepSeek 配置和第三方登录提示设置。不要把 DeepSeek Key 填进 Claude 账号登录窗口。

第四步 把 Claude Code 面板改成中文

  1. 扩展面板搜索 @id:shanjiancaofu.claude-code-zh-cn-patch-helper。
  2. 核对扩展标识,安装 Claude Code zh-CN 中文汉化包。
  3. 打开命令面板,执行 Claude Code Zh-CN Patch: Apply Patch。
  4. 查看它找到的目标,确认是本机刚安装的官方 Claude Code 扩展;核对预览后应用。
  5. 再执行 Developer: Reload Window,重新加载窗口。

打开 Claude Code 面板,检查主要界面是否已经显示中文。部分版本新增文字可能暂时保留英文,不影响先验证模型连接。操作说明见 汉化包市场页面。

界面改成中文后,如果回答还是英文,直接在对话里说“后续请使用简体中文回复”。界面语言和回复语言要分别设置。

第五步 准备 DeepSeek API Key

打开 DeepSeek 开放平台,登录自己的账号,查看可用余额。

打开 API 密钥页面,创建一枚便于识别的密钥,例如命名为 Claude-VSCode。复制完整密钥,稍后替换 JSON 中的占位文字。已有有效密钥的可以复用,也可以为不同应用分别创建,方便管理。

DeepSeek 网页聊天的使用权益与 API 余额分别管理。创建 Key 不会自动充值,模型调用按 API 实际用量计费。

第六步 找到正确的配置文件

VS Code 路线需要配置两份设置,作用不同:

文件或设置位置保存什么
用户目录下的 .claude/settings.jsonDeepSeek 接口地址、密钥、模型与本路线的运行选项
VS Code 用户设置claudeCode.disableLoginPrompt 等扩展界面选项

Windows 的 Claude Code 配置文件路径是:

纯文本
%USERPROFILE%\.claude\settings.json

按 Win + E 打开文件资源管理器,在地址栏输入 %USERPROFILE% 并回车。找到 .claude 文件夹;没有就创建。回到 VS Code,新建文本文件,粘贴下一步的 JSON,保存到该文件夹,文件名为 settings.json。

在文件资源管理器中显示文件扩展名,确认最终不是 settings.json.txt。实际路径类似 C:\Users\你的用户名\.claude\settings.json。

Mac 的配置文件路径是:

纯文本
~/.claude/settings.json

Finder 中可以按 Command + Shift + G,输入 ~/.claude 前往该目录。目录不存在时,在“终端”运行:

Bash
mkdir -p ~/.claude

再回到 VS Code 新建文本文件,粘贴下一步 JSON。保存时按 Command + Shift + G 输入 ~/.claude,保存为 settings.json。

已经有配置文件的,先备份,再把下面 env 里的键合并进去。其他设置保留,同一份 JSON 里只留一个 env。密钥放在自己的用户配置里,别写进准备公开的项目文件。配置位置与覆盖规则见 Claude Code 设置说明。

第七步 保存 DeepSeek 完整配置

首次创建文件时,复制下面整段,只把密钥占位文字替换为自己的完整 DeepSeek API Key。所有引号、冒号和逗号都保留英文形式。

JSON
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "在这里粘贴你的DeepSeek_API_Key",
    "ANTHROPIC_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "786432",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL": "1"
  }
}

保存文件。JSON 内不能添加 // 注释,最后一项后面不要加逗号。

接口和模型配置依据 DeepSeek 官方 Claude Code 接入指南。这里的 ANTHROPIC_ 是 Claude Code 读取的配置名称;接口地址和模型均指向 DeepSeek。

[1m] 是本路线 Claude Code 配置中的上下文标记,按示例保留。桌面端路线的“实际请求模型”字段使用自己的映射规则,不要把两条路线的模型字段直接互换。max 是努力程度设置,调用费用仍按实际用量计算。

最后两项用于减少非必要网络请求,并关闭官方插件市场的自动注册。它们不会让 API 离线运行,也不会保证所有联网功能可用;部分依赖在线开关的功能会不可用。首次跳过市场注册后,单纯删除该配置不会补做注册,以后需要时按官方文档手动添加。更新与额外插件也要按需要单独处理。说明见 Claude Code 环境变量参考。

第八步 开启第三方提供方的登录提示设置

打开 VS Code 设置:Windows 按 Ctrl + ,;Mac 按 Command + ,。

搜索 claudeCode.disableLoginPrompt,或搜索 Claude Code login,在用户范围勾选 Disable Login Prompt。

也可以从命令面板执行 Preferences: Open User Settings (JSON),在 VS Code 用户设置中合并这一项:

JSON
{
  "claudeCode.disableLoginPrompt": true
}

已有 VS Code 用户设置时,只添加对应键,保留原来其他设置。这段属于 VS Code 用户设置,上一步含 env 的配置属于 .claude/settings.json,不要合并到同一个文件。

此选项是官方为第三方提供方配置提供的设置;实际鉴权使用前面填入的 DeepSeek API Key。保存后完全退出 VS Code,再重新打开。参见 官方第三方提供方配置说明。

第九步 打开工作区并验收

在 VS Code 选择“文件 → 打开文件夹”,选择 claude-vscode-test。询问信任时,确认是自己创建的测试目录,再按提示操作。

点击 Claude Code 图标打开面板。找不到时,在命令面板中搜索 Claude Code,选择当前版本提供的打开面板或新标签页命令。权限保留手动确认或对应的 Manual 模式。

发送:

纯文本
只回复“连接成功”。不要读取或修改文件,不要调用工具,也不要运行命令。

收到回复后,到 DeepSeek 开放平台看刚才那段时间的用量或账单。记录没出来就稍后刷新。如果账号还供其他应用使用,要结合时间和当前配置核对,别只听模型自己说“我是 DeepSeek”。

再退出并重开 VS Code,重复一次最小验证。完成后应能确认:VS Code 主界面为中文,Claude Code 面板主要文字为中文,模型连接成功,并且 DeepSeek 有对应调用记录。

首次验证后,需要处理文件时再测试指定目录内的工具操作。Windows 若需要 Bash 工具,按 官方 Windows 说明 准备 Git for Windows;当前原生 Windows 也提供 PowerShell 工具路径,不把 Git Bash 当作所有基础对话的必需前提。

扩展市场打不开时使用 VSIX 安装

客户电脑能连 DeepSeek、却打不开扩展市场时,可以先在允许联网、能够访问官方来源的电脑上下载原始安装文件,再按获准的方式传过去。VSIX 可以本地安装,之后的模型对话仍要连接 DeepSeek API。

准备以下文件:

文件获取来源与注意事项
VS Code 安装包VS Code 官网,按目标电脑系统和架构选择
微软简体中文语言包 VSIX官方市场中的 MS-CEINTL.vscode-language-pack-zh-hans
Claude Code 官方 VSIX官方市场中的 Anthropic.claude-code;按目标电脑平台和架构选择
Claude Code 汉化包 VSIX该扩展的官方市场页,或维护者的 GitHub Releases

在可联网的准备电脑中,打开 VS Code 扩展面板,按扩展标识查找。右键对应条目,选择 Download VSIX 或 Download Specific Version VSIX,按提示选择适合目标设备的版本和平台。汉化包也可以从 维护者发布页 获取原始 .vsix。

将文件传到目标电脑后,先安装 VS Code,再打开扩展面板右上角的“…”菜单,选择“从 VSIX 安装 / Install from VSIX”。按顺序安装语言包、官方 Claude Code 扩展、Claude Code 汉化包,按提示重载或重启。

安装扩展后,按本页 VS Code 路线的详细步骤继续操作:切换显示语言,应用汉化补丁,填写自己的 API Key,设置第三方提供方,再验证连接。传递安装包时不附带任何人的 API Key 或账户配置。

通过 VSIX 安装的扩展,自动更新默认关闭。需要更新时,再从官方来源下载合适版本,留意汉化是否兼容。如果还提示缺少依赖或组件,就按提示补齐;看到“安装成功”后,也要实际打开面板试一次。参见 VS Code 官方 VSIX 安装与下载说明。

VS Code 常见问题

情况排查步骤
VS Code 菜单仍是英文确认微软语言包已安装,在 Configure Display Language 中选 zh-cn,重启
VS Code 已中文,Claude 面板仍英文检查社区汉化包,执行 Apply Patch 后 Reload Window
扩展市场打不开按本页“扩展市场打不开时使用 VSIX 安装”一节准备和安装
VSIX 提示不兼容核对 VS Code 版本、目标系统、架构及扩展依赖
Claude 仍要求原生账号登录检查用户级 DeepSeek 配置、Disable Login Prompt,完全退出再重开
Settings Error检查 JSON 引号、逗号、花括号、重复 env 和文件扩展名
401 或鉴权失败检查 DeepSeek 密钥全文、空格、所属账号和有效性
余额不足到创建 Key 的 DeepSeek 账号查余额,创建 Key 不代表充值
模型不存在或接口错误核对 /anthropic 接口及本路线模型名称,检查旧配置是否覆盖
一直等待或连接超时先看报错针对 DeepSeek API、扩展资源还是其他工具域名,按所在网络的管理要求排查
模型能回复,但搜索、插件或文件操作失败分别检查工具网络、依赖和本地权限;基础模型连接成功不代表全部工具可用
关闭 CC Switch 后本路线无法使用检查 Claude Code 是否仍指向 CC Switch 本地地址;按本路线直连方案核对用户配置,并选择一个配置管理方式
终端中输入 claude 找不到本路线仅要求扩展面板,自带组件不等于系统已安装独立 CLI
汉化后面板异常先恢复原文件、重载窗口,再核对官方扩展与汉化版本

更新和恢复汉化

联网更新或通过 VSIX 更新官方 Claude Code 后,先确认新版本能正常启动,再检查汉化。没有自动恢复中文时,重新执行 Claude Code Zh-CN Patch: Apply Patch,然后 Reload Window。

需要恢复英文界面时,执行:

纯文本
Claude Code Zh-CN Patch: Restore Original Files

准备卸载汉化包时,先执行:

纯文本
Claude Code Zh-CN Patch: Restore Before Uninstall

恢复完成后,再卸载汉化包、重开 VS Code。汉化已经改过本机文件,只卸载辅助扩展,旧的修改可能还在。相关问题见 汉化包使用说明 和 维护者 FAQ。

日常顺序是:打开 VS Code → 打开自己的工作目录 → 打开 Claude Code 面板。模型费用查看 DeepSeek 开放平台;软件、汉化与工具能力按各自版本和网络条件维护。

装好后检查这几项

  • 桌面端路线:CC Switch 的 Claude Desktop 配置生效,本地路由运行;Claude 能收到回复,DeepSeek 有对应调用记录,重开后仍有效。
  • VS Code 路线:编辑器主界面为中文,Claude Code 面板主要文字已汉化,API 配置和第三方登录提示设置正确;收到回复,有对应 DeepSeek 用量,重开后仍有效。
  • 需要处理本地文件或使用额外工具时,另外检查目录权限、依赖和具体工具的网络条件。

常用词

名称意思
智能体或 Agent能按授权调用工具、执行任务的程序
API软件向模型服务发起请求的接口
API Key调用凭证,可能消耗对应账户的余额
模型提供方或供应商提供模型接口、处理请求并按规则计费的服务方
客户端你在电脑上打开和操作的软件
模型映射把客户端里的模型入口转换为实际发送给服务方的模型 ID
CC Switch 本地路由在自己电脑上接收客户端请求,按保存的配置发送给模型 API 的服务
VSIXVS Code 扩展的安装文件,可在准备好文件后本地安装
环境变量程序读取的配置项;本教程的 VS Code 路线将接口与模型等设置保存在 Claude Code 用户配置的 env 中。
工作目录本次任务准备读写的文件夹,需要结合权限设置使用
Skill给智能体使用的一组操作说明与配套资源,适合反复执行同类任务
工作流一项工作分几步完成、用什么工具,以及在哪里检查结果

常用快捷键

操作WindowsmacOS
复制Ctrl + CCommand + C
粘贴Ctrl + VCommand + V
保存Ctrl + SCommand + S
打开 VS Code 扩展面板Ctrl + Shift + XCommand + Shift + X
打开 VS Code 命令面板Ctrl + Shift + PCommand + Shift + P
打开 VS Code 设置Ctrl + ,Command + ,
打开文件管理器Win + E打开 Finder
搜索应用开始菜单后输入名称Command + 空格
退出当前应用使用应用菜单或托盘中的退出Command + Q
停止当前终端程序Ctrl + CControl + C

Mac 的终端里,停止程序用 Control + C。记不住快捷键时,直接从软件菜单操作也可以。

有问题想问?

文章内容、工具使用或者发现哪里写错了,都可以告诉我。

联系二维码

扫码添加时请说明来意

欢迎反馈文章中的错误,也欢迎交流学习心得和工具使用经验。 联系时请说明对应文章或问题,请勿发送账号密码、验证码等敏感信息。隐私说明

本教程免费阅读,不需要注册或付费。返回教程列表

相关教程

AI 工具入门入门网页

Humanizer-zh 安装教程|Claude Code + Codex 小白版

面向零基础用户的 Humanizer-zh 安装与使用教程,覆盖 Claude Code 和 Codex:从检查 Node.js、全局安装 Skill,到目录位置、调用测试、常见报错排查,并附可直接复制的中文润色提示词。

Windows / macOS2026-10-18已查看 1 次
置顶AI 工具入门入门网页

Codex 安装与入门配置教程

这篇教程带你在 Windows 或 Mac 上装好 Codex,登录自己的 ChatGPT 账号,再选一个工作目录试试连接。电脑装不了桌面端时,后面还有 IDE 扩展的备用方法。

Windows / macOS2026-10-18已查看 7 次
AI 工具入门入门网页

DeepSeek Harness 桌面端安装与配置教程

这篇教程带你装好 DeepSeek Harness,登录自己的账号,检查余额并试一次模型连接。想用已有的 API Key,也可以按后面的步骤单独配置。安装或鉴权报错时,先看文末的常见问题。

Windows / macOS2026-10-18已查看 0 次