Claude Code 桌面版接入 DeepSeek API 完整配置指南

本教程记录了如何将 Claude 桌面应用的模型后端替换为 DeepSeek API，并进一步配置远程 SSH 会话，让 Claude Code 的推理引擎运行在远程服务器上、桌面端仅作为显示界面。
重要说明：这是通过桌面应用的开发者模式实现的非官方用法，属于社区发现的可行方案，不是 Anthropic 官方支持的标准功能。使用前请了解以下几点：

• 该功能可能随桌面版更新而失效
• 需要自行承担第三方 API 计费和使用风险
• 涉及修改应用内部配置文件，存在一定操作风险

---

目录

1. 准备工作
2. 下载安装 Claude 桌面版
3. 申请 DeepSeek API Key
4. 开启开发者模式
5. 配置第三方推理网关
6. 验证 DeepSeek 接入是否生效
7. 开启全局跳过权限确认（可选）
8. 配置 SSH 远程会话
9. 常见问题排查
10. 安全与费用注意事项

---

一、准备工作

在开始之前，确保你有：

• 一台 Windows 10/11 电脑（本教程以 Windows 为例，macOS 流程类似）
• 一个可以正常访问网络的环境
• 一个 DeepSeek Platform 账号（用于获取 API Key）
• 如果要配置远程会话，还需要一台你有权限访问的远程 Linux 服务器（本教程中用 <你的服务器IP> 代替真实地址）

---

二、下载安装 Claude 桌面版

1. 访问官方下载页面：https://claude.com/download
2. 根据你的操作系统选择对应安装包（Windows / macOS / Windows ARM64）
3. 下载完成后双击安装包，按提示完成安装
4. 首次启动时，可以先不登录官方账号（走第三方 API 时不需要登录 Anthropic 官方账号）

---

三、申请 DeepSeek API Key

1. 浏览器打开 https://platform.deepseek.com
2. 使用手机号注册/登录账号
3. 左侧菜单找到 API Keys
4. 点击 创建 API Key，输入名称后创建
5. 立即复制保存生成的 Key（离开页面后将无法再次查看完整内容，格式类似 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）
6. 前往 充值 页面，预充值一定金额（DeepSeek 采用预付费模式，几元人民币即可支持较长时间的日常使用）

提示：DeepSeek 官方目前提供两个模型：

• deepseek-chat：日常对话模型，响应快，无深度思维链
• deepseek-reasoner：推理增强模型，响应较慢，但逻辑严谨性更高，会消耗更多 Token

---

四、开启开发者模式

1. 打开 Claude 桌面应用
2. 点击顶部菜单栏（如果没有显示菜单栏，尝试按 Alt 键唤出）
3. 依次点击：Help → Troubleshooting → Enable Developer Mode
4. 根据提示重启应用
5. 重启后，顶部菜单栏会新增一个 Developer 菜单项

---

五、配置第三方推理网关

1. 点击顶部菜单栏 Developer → Configure Third-Party Inference...
2. 弹出配置窗口后，左侧选择 Connection
3. 在 Connection 下拉框中选择 Gateway
4. 填写以下字段：

字段	填写内容
Credential kind	选择 Static API key
Gateway base URL	https://api.deepseek.com/anthropic
Gateway API key	填入你在第三步申请的 DeepSeek API Key
Gateway auth scheme	选择 x-api-key

重要坑点：Base URL 必须填 https://api.deepseek.com/anthropic（带 /anthropic 后缀），直接填 https://api.deepseek.com 虽然能获取到模型列表，但实际调用会报错无法使用。

5. 往下滚动，关闭 Model discovery 自动发现开关（DeepSeek 未提供标准模型发现接口，此开关开启会导致连接测试报 404）
6. 找到 Model list 区域，点击添加模型，配置如下（注意：由于桌面版限制了自定义模型 ID 的命名格式，必须使用类似 Anthropic 官方命名格式的伪装名称，否则界面会报错拦截）：

模型一（对应 deepseek-chat，日常使用）：

字段	填写内容
Model ID	claude-haiku-4-6（伪装名，实际路由到 deepseek-chat）
Display name	DeepSeek Flash（自定义显示名，方便识别）
Tier alias	haiku
Default for tier	开启

模型二（对应 deepseek-reasoner，复杂推理任务）：

字段	填写内容
Model ID	claude-opus-4-6（伪装名，实际路由到 deepseek-reasoner）
Display name	DeepSeek Pro（自定义显示名）
Tier alias	sonnet
Default for tier	开启

为什么要用伪装名：桌面版某次更新后新增了模型 ID 命名校验，直接填 deepseek-chat 这类名称会被界面拦截报错。用 claude-xxx 格式的名字可以骗过界面校验，实际请求依然会通过你配置的 Gateway 转发到 DeepSeek，只是显示名和内部路由标签不完全对应，不影响实际功能和计费。

7. 全部填写完成后，点击右下角 Apply Changes
8. 完全退出应用（建议从系统托盘右键退出，而非仅关闭窗口），重新打开生效

---

六、验证 DeepSeek 接入是否生效

配置完成后，有两种方式验证是否真的在使用 DeepSeek 而非 Anthropic 官方模型：

方法一：查看用量统计

1. 在 Claude 应用 Code 标签页首页，查看 Overview 面板
2. 观察 Favorite model 一栏，如果显示类似 Dee***** 4 Pro 或 Dee***** 4 Flash，说明系统内部记录到的调用确实是 DeepSeek 模型

方法二：核对 DeepSeek 账户余额

1. 登录 DeepSeek Platform，进入 用量 或 账单 页面
2. 使用 Claude 桌面版进行几轮对话后，刷新余额页面
3. 如果余额有相应扣减，说明请求确实被正确转发到了 DeepSeek，而非消耗 Anthropic 官方额度

注意：模型自身可能会在对话中自称"我是 Claude"，这是因为模型的自我认知来自训练数据，与实际请求路由的网络路径无关，属于正常现象，不代表配置未生效。以扣费记录为准。

---

七、开启全局跳过权限确认（可选）

如果希望 Claude 在执行文件操作、命令行指令时不用每次弹窗确认，可以开启此选项。该选项存在一定安全风险，请谨慎开启。

1. 点击左侧 Customize
2. 左侧栏找到 Claude Code（Settings 分类下）
3. 往下滚动，找到 Local sessions 区块
4. 打开 Allow bypass permissions mode 开关

官方警告原文：开启此模式后，"Letting Claude run arbitrary commands is risky and can result in data loss, system corruption, or data exfiltration"（允许 Claude 无限制执行命令存在风险，可能导致数据丢失、系统损坏或数据泄露，例如通过提示注入攻击）。

建议：仅在你信任的、专门用于实验的环境中开启，且工作目录不要指向存放重要数据的路径。

---

八、配置 SSH 远程会话

如果你希望 Claude Code 的推理引擎运行在远程服务器上（桌面端仅作为显示界面），而不是在本地 Windows 上跑一个独立进程，可以按以下步骤配置。

8.1 前置条件

• 远程服务器为 Linux 或 macOS（x86_64 或 arm64 架构），或 Windows（x64/arm64）
• 服务器已开启 SSH 服务，支持 SFTP 子系统
• 服务器上已安装 git
• 本机 Windows 上已通过命令行成功 SSH 连接过该服务器至少一次（这样服务器公钥会被记录到本机 ~/.ssh/known_hosts 中，桌面应用不会主动弹出"接受新密钥"的提示）
• 密钥未设置密码保护，或已加载进 SSH agent

8.2 手动开启 SSH 白名单

由于该功能默认关闭（是为了防止推理凭据被意外发送到未信任的主机），需要手动编辑配置文件开启。

1. 找到第五步中生成的第三方推理配置文件，路径大致为：

   C:\Users\<你的用户名>\AppData\Local\Claude-3p\configLibrary\<一串哈希值>.json
   

   可以用以下命令搜索该文件（在 PowerShell 中执行）：

   Get-ChildItem "$env:LOCALAPPDATA\Claude-3p\configLibrary" -Recurse
   

2. 用记事本打开该文件：

   notepad "路径\文件名.json"
   

3. 在原有配置的基础上，追加 sshHostAllowlist 字段（放在 JSON 最外层，与 inferenceModels 等字段平级）：

   {
     "inferenceGatewayBaseUrl": "https://api.deepseek.com/anthropic",
     "inferenceGatewayApiKey": "你的DeepSeek Key",
     "inferenceGatewayAuthScheme": "x-api-key",
     "modelDiscoveryEnabled": false,
     "inferenceModels": [
       ...（保留原有模型配置）
     ],
     "inferenceProvider": "gateway",
     "inferenceCredentialKind": "static",
     "sshHostAllowlist": ["<你的服务器IP或域名>"]
   }
   

   如果希望允许连接任意主机，可以填 ["*"]；如果只允许特定域名下的所有子域，可以用通配符，如 ["*.example.com"]。

4. 保存文件，完全退出并重启 Claude 应用

8.3 新建 SSH 会话

1. 进入 Code 标签页
2. 点击左上角 "+ New"
3. 在下方环境选择按钮（默认显示 "Local"）处点击，此时下拉菜单中应已出现新增的服务器选项
4. 如果这是第一次添加该主机，可能需要填写：
   • Name：给这个连接起一个好记的名字
   • SSH Host：格式为 用户名@主机地址
5. 选择完成后，会弹出 "Select Remote Folder" 对话框，选择你希望作为工作目录的远程文件夹
6. 确认后，Claude Desktop 会自动通过 SFTP 将远程引擎程序部署到服务器的 ~/.claude/remote/ 目录下，首次连接可能需要几秒到几十秒

8.4 权限问题排查

如果部署过程中遇到类似如下报错：

Couldn't upload to the remote (server binary): a required file or directory is missing [ENOENT]

这通常是因为服务器上 ~/.claude 目录的所有权不属于当前登录用户（例如之前用 root 身份操作过该目录）。

排查方法：SSH 登录服务器后执行：

ls -la ~/.claude

如果发现该目录或其中部分内容的所有者是 root 而非当前登录用户，执行以下命令修复权限（需要 sudo 权限）：

sudo chown -R <你的用户名>:<你的用户名> ~/.claude

修复后，回到桌面应用点击 "Try again" 重新连接。

---

九、常见问题排查

问题：模型自称是 "Claude Haiku" 而不是 DeepSeek

这是正常现象，不代表配置失败。模型的自我认知来自其训练数据，与实际网络请求路由无关。请以 DeepSeek 平台的余额消耗记录作为判断依据。

问题：deepseek-reasoner 响应时间明显变长，甚至耗费较多 Token

DeepSeek 的推理模型（reasoner）会生成一段内部思维链再给出答案，复杂任务下思考时间可能达到数十秒甚至数分钟，属于该模型的正常特性。如果对费用敏感，建议：

• 简单任务优先使用 chat/flash 档位
• 只有明确需要深度推理的任务才手动切换到 reasoner/pro 档位
• 定期查看 DeepSeek 平台余额消耗速度，避免超支

问题：图片无法被正确识别，模型却给出了看似正常的回答

DeepSeek 官方模型（chat 和 reasoner）目前不支持图像理解能力。如果发送图片，模型可能会基于上下文文字信息"编造"一个回答，而非真正读取了图片内容。如果需要频繁处理截图、图片分析类任务，建议为该场景单独切换回 Anthropic 官方模型。

问题：桌面版和命令行版（CLI）是否存在能力差异

两者共用同一套底层推理引擎，模型能力（推理水平、知识储备）完全一致，不存在"某一版更聪明"的情况。差异仅体现在操作界面和工作流层面：CLI 支持更细粒度的启动参数、更适合并行多会话；桌面版提供可视化 diff 对比、图形化会话管理等便利功能。

---

十、安全与费用注意事项

1. API Key 保管：配置文件中的 API Key 以明文形式存储在本地磁盘，请勿将该配置文件分享给他人或上传至公开仓库。

2. 费用监控：建议养成定期查看 DeepSeek 平台余额和用量统计的习惯，尤其是在使用推理模型（reasoner）执行复杂任务时，避免因为模型长时间"思考"而产生超出预期的费用。

3. 权限模式风险：如果开启了"跳过权限确认"模式，请确保工作目录不包含重要数据，同时留意不要让模型执行来源不明的指令（例如网页内容、文件内容中隐藏的指令），以防范提示注入类风险。

4. 该方案的稳定性：由于这是利用桌面应用开发者模式实现的非官方用法，不排除后续版本更新会调整或限制相关功能，配置前请做好可能需要重新调整的心理准备。

5. 官方功能限制：走第三方 API 网关后，将无法使用部分 Anthropic 官方独占功能（例如 Computer Use 操作电脑能力，该功能目前仅对官方 Pro/Max 订阅开放）。

---

本教程基于实际配置过程整理，具体界面文字、路径可能随应用版本更新而变化，请以实际操作界面为准。