Claude Code 桌面端接入 DeepSeek 模型：离线 Skills 国内安装教程（含 TaoToken 配置）

1. Claude Code 桌面端接入 DeepSeek 的国内落地场景与离线 Skills 需求Claude Code 桌面端本质上是把 Claude Agent SDK 的交互界面搬到本地让你在图形化窗口里完成代码生成、文档处理、任务编排这类操作。它默认走 Anthropic 官方通道国内网络环境下直接连会卡在鉴权环节所以真正能跑起来的方案是桌面端负责界面和 Agent 调度模型通道换成 DeepSeek再通过 TaoToken 这类兼容 Anthropic 协议的中转把请求转发出去。这样你既保留了 Claude Code 的操作习惯又用上了 DeepSeek 的推理能力还绕开了官方通道的连通性问题。离线 Skills 是这套方案里最容易被忽略、也最容易踩坑的部分。Skills 可以理解成给 Agent 预装的“技能包”每个技能是一组提示词、工具声明和资源文件的集合。在线模式下 Claude Code 会去远端拉取技能列表国内网络经常拉不动或者超时离线 Skills 就是把官方技能包提前下载到本地通过导入功能一次性加载之后所有技能调用都在本地完成不依赖外网。对于做文档批处理、代码审查、结构化数据抽取这类重复任务的用户离线 Skills 能省掉大量重复描述提示词的时间。这套组合适合谁我梳理了三类一是用 Claude Code 做日常编码但被网络卡住的开发者二是需要批量处理文档、又不想把数据传到不可控通道的办公用户三是想研究 Agent 技能机制、自己改技能包的技术爱好者。三类人的共同诉求是安装过程要能照着做配置片段要能直接复制报错要能对上号。环境依赖上Node.js 是硬门槛。Claude Code 桌面端的 Agent 运行时、技能加载器、工具调用桥接都跑在 Node 上版本建议 v24 及以上。低于这个版本会出现skills loader failed或者工具调用返回空结果的情况。安装 Node 时务必勾选 Add to PATH否则桌面端启动时会报Node not found这个错后面会专门讲。模型侧DeepSeek 提供 Pro 和 Flash 两个档位。Pro 适合通用开发、复杂推理Flash 主打快速响应和长上下文。你在 Claude Code 里选哪个取决于任务是“要准”还是“要快”。我实测下来代码生成和重构用 Pro文档摘要和批量分类用 Flash体感差异明显。整篇教程的路径是先装 Node再装桌面端然后配 TaoToken 通道接着导入离线 Skills最后验证模型连通性和技能生效。每一步都有可复制的命令或配置片段你跟着做就行。2. TaoToken 前置准备API Key 获取与 Claude Code 通道配置TaoToken 在这套方案里扮演的是“协议翻译 通道转发”的角色。Claude Code 桌面端说的是 Anthropic 那套 Messages API 方言DeepSeek 原生接口是另一套格式两者不能直接对话。TaoToken 提供 Anthropic 兼容端点你把 Base URL 指向它它负责把请求转成 DeepSeek 能理解的格式再把结果转回来。这样桌面端不需要改任何代码只改配置就能换模型。第一步是拿 API Key。打开 https://taotoken.net/api-keys 登录后创建一个新 Key。建议按用途分 Key比如“claude-code-deepseek”单独一个方便后面排查问题时定位是哪个 Key 出的错。Key 创建后只显示一次复制下来存到本地文本文件别直接贴在聊天窗口里。第二步是确认接入文档里的端点格式。打开 https://taotoken.net/doc 找到 Anthropic 兼容部分记下 Base URL 的写法。Claude Code 桌面端的配置项里Base URL 一般填到/v1这一层具体以文档为准。Model ID 这块要注意桌面端设置界面里显示的“DeepSeek 4 Pro / Flash”是展示名实际请求里带的 Model ID 要跟文档里列出的字符串一致否则会返回model not found。第三步是理解鉴权方式。Claude Code 桌面端支持在设置里填 API Key也支持读环境变量。我建议用设置界面填因为环境变量在 Windows 上经常因为终端没重启而不生效。填完之后桌面端会在每次请求的 header 里带上x-api-key或AuthorizationTaoToken 侧校验通过才会转发。这里有个容易混淆的点TaoToken 不是“中转非法流量”它是一个合规的 API 聚合通道做的事情是协议适配和请求转发。你在配置时只需要关心 Base URL、Key、Model ID 三个值其余交给它处理。如果你后面要用 Claude Code 的 Coding Plan 或者 Agent 长任务建议单独去 https://taotoken.net/coding-plan 看一下额度说明。长任务对 token 消耗比较大提前规划好档位能避免跑到一半断掉。配置完成后先别急着导入 Skills。先用一个最简单的请求验证通道是否通通了再往下走。验证方法在第四节这里先把 Key 和端点准备好。3. 可复制配置settings.json、Node 环境与 Skills 目录结构这一节是整篇的核心所有片段都可以直接复制。先讲 Node 环境准备再给 settings.json最后是 Skills 目录结构。Node.js 安装命令Windows 用 PowerShell 管理员模式# 下载 Node v24 LTS 安装包后执行静默安装 msiexec /i node-v24.15.0-x64.msi /qn ADDLOCALALL # 安装完成后刷新环境变量 refreshenv # 验证版本 node -v npm -v如果你用 winget也可以winget install OpenJS.NodeJS.LTS --version 24.15.0安装完必须重启终端否则 PATH 不生效。验证输出v24.15.0才算成功。接下来是 Claude Code 桌面端的配置文件。Windows 下路径通常是%APPDATA%\Claude\settings.jsonmacOS 下是~/Library/Application Support/Claude/settings.json内容如下把sk-你的Key和 Model ID 替换成实际值{ apiProvider: anthropic-compatible, baseUrl: https://taotoken.net/api/v1, apiKey: sk-你的Key, model: deepseek-4-pro, fallbackModel: deepseek-4-flash, skills: { offlineMode: true, skillsDir: C:/claude-skills, autoLoad: true }, agent: { maxTokens: 8192, temperature: 0.3, timeoutMs: 120000 }, telemetry: false }几个参数说明apiProvider固定填anthropic-compatible这是告诉桌面端走兼容协议baseUrl末尾的/v1别漏model和fallbackModel分别对应主模型和降级模型Pro 超时或限流时自动切 FlashskillsDir指向你放离线技能包的目录路径用正斜杠或双反斜杠别用单反斜杠否则 JSON 解析会报错。Skills 目录结构示例C:/claude-skills/ ├── manifest.json ├── doc-processor/ │ ├── skill.json │ ├── prompt.md │ └── tools.json ├── code-review/ │ ├── skill.json │ ├── prompt.md │ └── tools.json └──>{ version: 1.0, skills: [ { name: doc-processor, path: ./doc-processor, enabled: true }, { name: code-review, path: ./code-review, enabled: true }, { name: data-extract, path: ./data-extract, enabled: true } ] }每个技能目录下的skill.json描述技能元信息{ name: code-review, description: 对指定代码文件做静态审查并输出问题清单, entry: prompt.md, tools: [read_file, write_file] }prompt.md里写这个技能的系统提示词tools.json声明它允许调用的工具。离线导入时桌面端会读manifest.json逐个加载技能目录把提示词注册进 Agent 的上下文。如果你拿到的是官方 ZIP 包保持压缩包状态在桌面端 Skills 模块点“离线导入”选 ZIP 文件即可。桌面端会自动解压到skillsDir并生成 manifest。手动放目录的话记得 manifest 里的 path 要和实际目录名一致。配置改完后重启 Claude Code让 settings.json 重新加载。重启后进设置界面确认 Base URL 和 Model 显示正确。4. 验证请求与成功结果模型连通性与 Skills 生效检查配置写完不代表能用必须做两步验证先验模型通道再验 Skills 加载。模型连通性验证最直接的方法是在 Claude Code 里新建任务输入一句最小指令请返回当前使用的模型名称和一次简单的加法结果11如果通道正常你会看到类似输出当前模型deepseek-4-pro 11 2如果返回的是401 Unauthorized说明 Key 不对或没带上如果返回model not found说明 Model ID 写错了如果卡住不动最后超时说明 Base URL 不通或网络层被拦。这三种错在第五节展开。更严谨的验证方式是用 curl 直接打 TaoToken 端点排除桌面端干扰curl -X POST https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: sk-你的Key \ -H anthropic-version: 2023-06-01 \ -d { model: deepseek-4-pro, max_tokens: 128, messages: [ {role: user, content: 回复 OK 两个字母即可} ] }正常返回是一段 JSONcontent数组里有text字段值是OK。如果返回{error:{type:authentication_error}}就是 Key 问题返回{error:{type:invalid_request_error,message:model not found}}就是 Model ID 问题。curl 通了桌面端基本也能通。Skills 生效验证在 Claude Code 里新建任务输入列出当前已加载的 Skills并说明 code-review 技能的用途正常输出会列出doc-processor、code-review、data-extract三个技能并复述 code-review 的描述。如果只列出部分说明对应技能目录的skill.json格式有问题如果一个都没列出说明manifest.json没被读到或者skillsDir路径不对。再做一个实际调用测试选一个技能跑一次使用 code-review 技能审查以下代码 def add(a,b): return ab预期输出会包含问题清单比如“缺少类型注解”“函数名过于简单”之类。如果技能被调用但返回空多半是prompt.md内容为空或编码不对要用 UTF-8。验证通过后你可以把常用技能固定到快捷入口。桌面端 Skills 模块支持置顶置顶后新建任务时默认加载省去每次手动选的步骤。这里提醒一句Skills 生效依赖 Agent 运行时而 Agent 运行时依赖 Node。如果 Node 版本低于 v24技能加载会静默失败界面不报错但技能列表为空。所以第一步的 Node 版本验证不能省。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节按真实报错逐条对照每条给原因和解决步骤。401 Unauthorized / authentication_error报错原文一般是{error:{type:authentication_error,message:invalid api key}}原因有三种Key 复制时带了空格或换行Key 已过期或被删除桌面端读的是旧配置没重启。解决重新去 https://taotoken.net/api-keys 复制一次 Key粘贴到 settings.json 的apiKey字段确认没有多余字符重启 Claude Code再用 curl 验证一次。如果 curl 也 401就是 Key 本身的问题重新创建一个。local proxy failed / connection refused报错原文Error: local proxy failed: connect ECONNREFUSED 127.0.0.1:xxxx这是桌面端尝试走本地代理端口但没起来。原因通常是系统代理设置残留或者安全软件改了本地回环。解决进 Claude Code 设置把代理相关项清空检查系统代理设置关掉不必要的代理如果装了安全软件把 Claude Code 加入白名单。改完重启。reading choices / cannot read property choices报错原文TypeError: Cannot read properties of undefined (reading choices)这个错说明返回体格式和桌面端预期的不一致。常见原因是 Base URL 填成了 OpenAI 兼容端点而不是 Anthropic 兼容端点或者 Model ID 填成了 OpenAI 风格的名称。解决确认baseUrl是https://taotoken.net/api/v1apiProvider是anthropic-compatible确认 Model ID 跟文档里 Anthropic 兼容部分列的一致。改完重启再用 curl 验证返回体里有没有content字段。OAuth / token refresh failed报错原文OAuth error: token refresh failed, please re-loginClaude Code 桌面端默认会尝试走官方 OAuth 登录如果你没在设置里切到 API Key 模式它会一直尝试刷新官方 token国内网络下必然失败。解决进设置把鉴权方式从 OAuth 改成 API Key确认apiKey字段已填关掉“自动登录”选项。改完重启桌面端就不再走 OAuth 流程了。Skills 导入后列表为空界面不报错但技能列表是空的。原因ZIP 包被解压过或者文件名被改过或者路径含中文/空格。解决用原始 ZIP 包重新导入skillsDir路径改成全英文无空格比如C:/claude-skills检查manifest.json是否存在且格式正确。改完重启再进 Skills 模块看列表。模型返回截断 / 超时长任务跑到一半返回不完整或者直接超时。原因maxTokens设太小或者timeoutMs不够。解决把maxTokens调到 8192 或更高timeoutMs调到 180000如果还是超时把主模型从 Pro 换成 FlashFlash 响应更快、上下文更长。改完重启。排查顺序建议先 curl 验通道再验桌面端配置最后验 Skills。这样能把问题范围一步步缩小不至于到处改。6. 语义一致 CTA按场景分流到对应入口配置跑通之后你可能会遇到两类后续需求一类是通道层面的比如换 Key、调额度、看接入文档另一类是模型层面的比如想对比 Pro 和 Flash 的实际输出、验证某个技能的效果。这两类需求对应的入口不一样别混着找。通道和鉴权相关的问题直接去 API Keys 页面管理https://taotoken.net/api-keys 。接入文档在 https://taotoken.net/doc 里面列了 Anthropic 兼容端点的完整参数、Model ID 对照表、错误码说明。遇到 401 或 model not found先翻文档再改配置比盲目试快得多。想验证模型输出质量、对比不同 Model ID 的效果用模型对话页面https://taotoken.net/model-chat 。在那里可以直接发指令看返回内容和 token 消耗确认没问题再写回 settings.json。如果你打算长期用 Claude Code 跑编码任务或 Agent 长任务建议看一下 Coding Planhttps://taotoken.net/coding-plan 。长任务对 token 消耗大提前选好档位能避免跑到一半断掉。控制台在 https://taotoken.net/console 可以看用量和调用记录。最后说一个我踩过的坑改完 settings.json 一定要完全退出 Claude Code 再启动光关窗口不够进程还在后台跑旧配置。任务管理器里确认进程结束再重新打开配置才会生效。这个细节看起来小但排查半天发现是没重启的情况很常见。