Claude Code桌面版接入DeepSeek保姆级教程

为什么要给Claude Code桌面版接入国产模型

Claude Code作为Anthropic推出的AI编程工具，凭借出色的代码理解与生成能力，已成为不少开发者的日常利器。Anthropic成立于2021年，由前OpenAI研究副总裁Dario Amodei等人创立，专注于AI安全研究。Claude Code不仅支持代码生成、调试、重构等全流程编程任务，还通过工具调用（Tool Use）机制实现文件读写、终端执行等实际操作，使其从单纯的对话模型进化为可执行编程任务的智能体（Agent）。

这一"进化"背后有深层的技术逻辑：传统LLM仅能生成文本，而智能体模式引入了"感知-规划-执行"循环——模型不仅理解指令，还能主动调用预定义工具完成文件读写、终端命令执行、网络请求等操作。这一架构与LangChain的ReAct框架、OpenAI的Function Calling在设计思路上一脉相承，本质上是给语言模型装上了"手"。Anthropic将这套完整机制称为Computer Use，是其在AI实用化方向上的重要押注。

但对国内用户而言，有两个绕不开的痛点：一是官方Claude模型使用成本偏高，长期高频调用容易让账单快速膨胀；二是账号注册与网络门槛，让不少新手望而却步。

本文基于实操演示，围绕Claude Code桌面版（Desktop）梳理出一条完整的落地路径，核心目标是用DeepSeek^广告等国产模型替换官方模型，在保留Claude Code工具能力的同时大幅降低使用成本。整个流程涵盖五个关键环节：安装桌面版、无账号使用、中文汉化、接入DeepSeek模型、加载自定义Skill。新手跟着操作，10分钟左右即可跑通。

需要提醒的是，本文所涉及的第三方切换工具与汉化补丁均为社区方案，接入国产模型本质上是对Claude Code的路由层进行了改造，属于非官方玩法，实际使用中请注意版本兼容性与数据安全。

第一步：安装桌面版并开启无账号模式

首先进入Claude Code官方页面，找到「获取Claude Code」入口。将鼠标悬停后会展开多种使用方式，其中排在第一位的Desktop桌面版正是我们需要的。点击后页面会自动识别操作系统并匹配对应安装包，Windows用户会直接获得Windows版本。

下载完成后运行安装程序，全程傻瓜式安装，无需额外配置。安装成功后进入登录界面，官方提供了谷歌账号等多种登录方式，但本文的思路是跳过账号直接使用。

实现无账号使用的关键在于开启开发者模式：点击左上角三条横杠菜单，进入「帮助（Help）」，向下找到「Enable Developer Mode」并点击开启。系统会弹出确认提示，选择确认后Claude Code自动重启。重启完成后，即为后续接入第三方模型打开了通道。

第二步：用CC Switch切换到国产模型

无账号模式开启后，还需要一个关键中间件——CC Switch。这是一款用于统一管理AI工具工作流的软件，其核心原理是在本地启动一个代理服务，将Claude Code发出的API请求拦截并转发给DeepSeek等第三方模型的端点。

这种模式在技术上称为「API兼容层」或「模型网关」。其工程实现是：在本地或远端启动一个HTTP代理服务，对外暴露与目标客户端期望完全一致的API端点，对内则将请求格式转换并转发至实际模型提供商。由于OpenAI的API格式已成为事实标准，DeepSeek、Mistral、国内大多数模型服务均提供OpenAI兼容模式——只要目标模型实现了与Anthropic API相兼容的接口协议，客户端便无法区分底层模型的实际来源。类似的开源工具还有LiteLLM、One-API等，原理相通。简单来说，CC Switch的作用就是帮你在不同模型之间灵活切换。

这里有一个非常重要的版本提醒：必须使用3.15.0及以上版本的CC Switch。只有新版本才内置了Claude Code桌面版的配置支持，如果此前安装过旧版本，或下载了低于此版本的安装包，必须先更新，否则无法完成桌面版接入。

安装完成后打开CC Switch，界面顶部除原有的命令行入口外，新增了「桌面版」选项，旁边有一个小电脑图标，这正是支持Claude Code桌面版的标志。配置步骤如下：

1. 点击左侧「设置」，进入「路由」，找到「本地路由」并点击向下箭头开启；
2. 返回选择「桌面版」，点击右侧「添加」，选择要加载的模型（本文以DeepSeek为例）；
3. 填入DeepSeek的API Key。

API Key的获取方式很直接：打开DeepSeek开放平台，进入API文档的Key管理页面，新建一个专用于Claude Code桌面版的Key并复制回填。

关于DeepSeek：DeepSeek是由深度求索（杭州）人工智能有限公司开发的大语言模型系列，其在国际AI基准测试中的异军突起，很大程度上得益于混合专家架构（MoE）与高效训练策略。DeepSeek-V3采用MoE结构，激活参数仅为总参数量的一小部分，在推理效率上具有显著优势，这也是其API定价能大幅低于同级别闭源模型（如GPT-4或Claude）的关键原因。DeepSeek-R1则借鉴了OpenAI o1的强化学习路线，通过大规模思维链（Chain-of-Thought）训练强化推理能力，在数学、逻辑和复杂代码生成任务上表现尤为突出。对编程场景而言，日常代码补全与重构推荐V3以控制成本，涉及算法设计或复杂架构决策时可切换至R1。DeepSeek开放平台提供标准的REST API接口，兼容OpenAI的调用格式，这使其能够无缝对接各类支持自定义端点的AI客户端工具。建议为不同用途创建独立Key，方便后续管理与用量追踪。

填好Key后向下滑动，会看到一个关于上下文大小的可选项，勾选后上下文可扩展至约1M Token的容量，建议开启。

上下文窗口（Context Window）是衡量大语言模型能力的核心指标之一。早期GPT-3仅支持约4K Token，GPT-4扩展至32K，而近两年主流模型已普遍突破100K甚至达到百万级别。Token的计量方式因语言而异：英文中约4个字符为1个Token，中文通常1-2个汉字对应1个Token。1M Token的上下文理论上可容纳约50-80万汉字。对代码任务而言，这意味着处理大型代码库时，模型可以同时理解多个文件的内容；进行代码重构时，前后依赖关系也能在同一上下文中完整呈现，大幅减少因上下文截断导致的理解偏差。需注意，更大的上下文也意味着每次请求消耗更多Token，会相应增加API调用费用；且当前模型在超长上下文中存在"注意力衰减"现象，对文档中部内容的理解准确率会有所下降。

配置完成后点击「添加」，随后务必点击「启动」——只有在启动状态下，配置才会真正生效。启动后可将CC Switch最小化到后台运行。

第三步：完成第三方配置并验证连通

回到Claude Code，点击左上角菜单，此时会多出「开发者」选项，其中有「配置三方」入口。点击后会发现相关信息已由CC Switch自动填入，无需手动操作。这也解释了为什么前面步骤中不能提前打开配置三方——必须等CC Switch正确配置并启动后，这里才会自动填充。

点击「Apply」并重启，Claude Code便会以DeepSeek作为底层模型进入工作状态。此时在对话框中可以看到可选的模型版本，包括Flash与Pro等。选择Flash版本后随便发送一条消息，例如「你是谁」，只要能正常返回回复，即说明接入成功。值得一提的是，模型可能仍会自称是Claude，这属于正常现象——系统提示与客户端逻辑并未改变，只有实际响应的模型被替换了，因此不影响实际使用。

第四步：中文汉化，告别全英文界面

默认状态下Claude Code桌面版为全英文界面，对国内用户不够友好。社区提供了汉化补丁，支持Windows与Mac双平台，包含简体中文、繁体中文、繁体中文（香港）等多个版本。

下载对应压缩包后解压，找到其中的.bat批处理文件双击运行。脚本提供五个选项：安装简体中文、安装繁体中文、安装繁体中文（香港）、恢复原样卸载补丁、退出。选择「1」回车即可安装简体中文。

汉化过程中脚本会自动关闭Claude Code（建议提前手动关闭更稳妥），完成后自动重启。重新打开后，「新建任务」「项目」「计划任务」「自定义」等界面元素全部变为中文，说明汉化成功。此前的对话历史同样完整保留，不会丢失。

第五步：在桌面版中加载自定义Skill

桌面版加载Skill的方式与CLI版本有明显区别。CLI版本只需在.claude目录下的skills文件夹中放置Skill文件即可；桌面版则需要以压缩包形式安装。

Skill（技能）在Claude Code中类似于可复用的「提示词模板包」或「工作流预设」。从技术本质看，Skill是对系统提示（System Prompt）的模块化封装——在大语言模型的交互架构中，系统提示处于对话上下文的最高优先级，它在用户输入之前预先设定模型的角色、行为约束、输出格式和任务逻辑。将这部分内容独立成可复用的Skill文件，开发者便能针对不同任务场景快速切换模型的"工作人格"。从软件工程视角看，这类似于设计模式中的策略模式（Strategy Pattern）——将可变的行为逻辑从固定的执行框架中解耦出来。这一机制与OpenAI的GPTs、Coze的工作流Bot在概念上相近，都是通过预定义的指令集来定制AI的行为边界。社区中已涌现出大量面向特定语言（如Rust、Go）、特定框架（如Next.js、FastAPI）乃至特定代码风格的开源Skill，对开发者而言，为不同项目类型（如前端开发、API设计、技术文档撰写）创建专属Skill，可以显著提升重复性任务的一致性和效率。

具体操作：新建一个任务，点击输入框旁的加号，依次进入「技能」→「管理技能」→「添加技能」→「上传技能」。桌面版支持.md文件、压缩包或.skill文件三种上传格式。

以演示用的IvanCreative创意Skill为例，将其打包成压缩包后拖拽上传即可。上传成功后，在对话框输入斜杠/便能选中该技能并调用，模型会按照Skill预设的逻辑进行处理并输出结果。需要注意的是，若Skill涉及图片生成功能，还需额外配置，本文仅验证纯文本Skill的可用性。

小结与实用建议

整套流程走下来，Claude Code桌面版就从一个依赖官方账号与高价模型的工具，变成了可接入DeepSeek等国产模型、界面中文化、支持自定义Skill的低成本开发助手。对于预算有限又想体验Claude Code工作流的开发者，这是一条相当务实的路径。

几点关键提醒：CC Switch务必使用3.15.0以上版本，这是桌面版接入的前提条件；配置完成后一定要点「启动」并「Apply」重启才能生效；汉化前建议手动关闭软件，避免出现异常。同时也要理性看待这套方案——第三方路由与汉化补丁并非官方支持，长期使用需关注版本更新与稳定性，处理敏感代码时更应谨慎评估数据流向：通过CC Switch代理的请求最终会发送至所选模型提供商的服务器，务必在使用前了解清楚相关数据处理政策。

核心要点

核心要点