文章目录(40 节)
- 安装前准备
- 先看电脑系统和芯片
- 账号和工作目录
- 下载或登录失败时
- 路线一 Claude 桌面端通过 CC Switch 接入 DeepSeek API
- 软件与模型分工
- 桌面端安装前准备
- 桌面端快速安装
- 桌面端详细步骤
- 第一步 安装 Claude 桌面端
- 第二步 安装 CC Switch
- 第三步 获取 DeepSeek API Key
- 第四步 在 CC Switch 选择正确的应用
- 第五步 添加 DeepSeek 官方供应商
- 第六步 配置模型映射
- 第七步 切换配置并重启 Claude
- 第八步 进入第三方模式并验证
- 以后如何切换其他 API
- 桌面端常见问题
- 日常启动与更新
- 路线二 Claude Code 在 VS Code 中接入 DeepSeek
- 适合什么情况
- 先分清两种汉化
- VS Code 快速安装
- VS Code 详细步骤
- 第一步 安装 VS Code
- 第二步 把 VS Code 改成中文
- 第三步 安装官方 Claude Code 扩展
- 第四步 把 Claude Code 面板改成中文
- 第五步 准备 DeepSeek API Key
- 第六步 找到正确的配置文件
- 第七步 保存 DeepSeek 完整配置
- 第八步 开启第三方提供方的登录提示设置
- 第九步 打开工作区并验收
- 扩展市场打不开时使用 VSIX 安装
- VS Code 常见问题
- 更新和恢复汉化
- 装好后检查这几项
- 常用词
- 常用快捷键
适用系统: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 桌面端安装与设备要求。
桌面端快速安装
- 从 Claude 官方下载页 安装桌面应用;首次打开出现登录页时,先退出,完成下面的第三方配置。
- 从 CC Switch 项目发布页 安装当前稳定版。
- 在 DeepSeek 开放平台 登录,检查余额并创建 API Key。
- 打开 CC Switch,选择 Claude Desktop,进入添加供应商。
- 选择 DeepSeek 官方预设,或使用自定义配置,填写 DeepSeek API Key。
- 使用本路线的模型映射方案:上游格式选 Anthropic Messages,接口地址填
https://api.deepseek.com/anthropic,实际请求模型填deepseek-flash。 - 添加后切换到该供应商,确认本地路由服务运行,再完全退出并重开 Claude 桌面端。
- 按客户端提供的第三方配置入口进入对话,发送验证消息,并核对 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 开放平台,用自己的账号登录。
- 查看账户余额。余额不足时,按页面支持的方式按需充值。
- 打开 API keys 或 API 密钥页面。
- 点击创建,名称可以填写
Claude-Desktop。 - 复制完整密钥,保存在自己能够妥善管理的位置。
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,配置如下:
| 模型角色 | 建议菜单显示名 | 实际请求模型 |
|---|---|---|
| Sonnet | DeepSeek Flash 主对话 | deepseek-flash |
| Opus | DeepSeek Flash 备用入口 | deepseek-flash |
| Haiku | DeepSeek 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 后,再新增相应供应商:
- 在 CC Switch 的 Claude Desktop 页添加该提供方。
- 使用该提供方的官方接口地址、自己的 API Key 和当前可用模型名称。
- 根据预设与实际模型 ID,配置适合的直连或模型映射方式。
- 保存并切换,完全退出再重开 Claude。
- 发最小验证消息,核对对应提供方的用量和计费。
例如以后需要接入 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 快速安装
- 从 VS Code 官网 安装与系统兼容的当前稳定版。
- 安装微软简体中文语言包,切换为
zh-cn并重启。 - 安装官方
Anthropic.claude-code扩展。 - 安装 Claude Code 中文汉化包,执行
Claude Code Zh-CN Patch: Apply Patch,确认后执行Developer: Reload Window。 - 在 DeepSeek 开放平台 检查余额并创建自己的 API Key。
- 将本路线完整 JSON 配置保存到用户目录的
.claude/settings.json。 - 在 VS Code 用户设置中开启
claudeCode.disableLoginPrompt,完全退出并重开 VS Code。 - 打开
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 改成中文
- 打开左侧“扩展 / Extensions”。Windows 按
Ctrl + Shift + X;Mac 按Command + Shift + X。 - 在搜索框输入
@id:MS-CEINTL.vscode-language-pack-zh-hans。 - 核对名称是简体中文语言包,发布者为 Microsoft,点击安装。
- 按提示选择切换语言并重启。
没有出现切换提示时,打开命令面板: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 面板改成中文
- 扩展面板搜索
@id:shanjiancaofu.claude-code-zh-cn-patch-helper。 - 核对扩展标识,安装 Claude Code zh-CN 中文汉化包。
- 打开命令面板,执行
Claude Code Zh-CN Patch: Apply Patch。 - 查看它找到的目标,确认是本机刚安装的官方 Claude Code 扩展;核对预览后应用。
- 再执行
Developer: Reload Window,重新加载窗口。
打开 Claude Code 面板,检查主要界面是否已经显示中文。部分版本新增文字可能暂时保留英文,不影响先验证模型连接。操作说明见 汉化包市场页面。
界面改成中文后,如果回答还是英文,直接在对话里说“后续请使用简体中文回复”。界面语言和回复语言要分别设置。
第五步 准备 DeepSeek API Key
打开 DeepSeek 开放平台,登录自己的账号,查看可用余额。
打开 API 密钥页面,创建一枚便于识别的密钥,例如命名为 Claude-VSCode。复制完整密钥,稍后替换 JSON 中的占位文字。已有有效密钥的可以复用,也可以为不同应用分别创建,方便管理。
DeepSeek 网页聊天的使用权益与 API 余额分别管理。创建 Key 不会自动充值,模型调用按 API 实际用量计费。
第六步 找到正确的配置文件
VS Code 路线需要配置两份设置,作用不同:
| 文件或设置位置 | 保存什么 |
|---|---|
用户目录下的 .claude/settings.json | DeepSeek 接口地址、密钥、模型与本路线的运行选项 |
| 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.jsonFinder 中可以按 Command + Shift + G,输入 ~/.claude 前往该目录。目录不存在时,在“终端”运行:
mkdir -p ~/.claude再回到 VS Code 新建文本文件,粘贴下一步 JSON。保存时按 Command + Shift + G 输入 ~/.claude,保存为 settings.json。
已经有配置文件的,先备份,再把下面 env 里的键合并进去。其他设置保留,同一份 JSON 里只留一个 env。密钥放在自己的用户配置里,别写进准备公开的项目文件。配置位置与覆盖规则见 Claude Code 设置说明。
第七步 保存 DeepSeek 完整配置
首次创建文件时,复制下面整段,只把密钥占位文字替换为自己的完整 DeepSeek API Key。所有引号、冒号和逗号都保留英文形式。
{
"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 用户设置中合并这一项:
{
"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 的服务 |
| VSIX | VS Code 扩展的安装文件,可在准备好文件后本地安装 |
| 环境变量 | 程序读取的配置项;本教程的 VS Code 路线将接口与模型等设置保存在 Claude Code 用户配置的 env 中。 |
| 工作目录 | 本次任务准备读写的文件夹,需要结合权限设置使用 |
| Skill | 给智能体使用的一组操作说明与配套资源,适合反复执行同类任务 |
| 工作流 | 一项工作分几步完成、用什么工具,以及在哪里检查结果 |
常用快捷键
| 操作 | Windows | macOS |
|---|---|---|
| 复制 | Ctrl + C | Command + C |
| 粘贴 | Ctrl + V | Command + V |
| 保存 | Ctrl + S | Command + S |
| 打开 VS Code 扩展面板 | Ctrl + Shift + X | Command + Shift + X |
| 打开 VS Code 命令面板 | Ctrl + Shift + P | Command + Shift + P |
| 打开 VS Code 设置 | Ctrl + , | Command + , |
| 打开文件管理器 | Win + E | 打开 Finder |
| 搜索应用 | 开始菜单后输入名称 | Command + 空格 |
| 退出当前应用 | 使用应用菜单或托盘中的退出 | Command + Q |
| 停止当前终端程序 | Ctrl + C | Control + C |
Mac 的终端里,停止程序用 Control + C。记不住快捷键时,直接从软件菜单操作也可以。
有问题想问?
文章内容、工具使用或者发现哪里写错了,都可以告诉我。
- 微信Bienberlain_1024
- 邮箱bienberlain@outlook.com

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