Claude 桌面客户端接入 DeepSeek API

Claude 桌面客户端支持通过 MCP（Model Context Protocol）扩展外部工具和数据源，也支持直接修改配置文件接入第三方 OpenAI 兼容 API。本教程以 DeepSeek 为例，完成从获取 Key 到验证生效的全流程。

前置条件

• 已安装 Claude 桌面客户端（下载地址，支持 macOS 和 Windows）
• 有 DeepSeek 账号（未注册可前往 platform.deepseek.com 注册）
• 文本编辑器（VS Code、记事本均可）

获取 DeepSeek API Key

1. 登录 platform.deepseek.com
2. 点击左侧菜单 API Keys
3. 点击 Create new secret key，输入名称（如 claude-desktop），点击确认
4. 复制生成的 Key（格式为 sk-xxxxxxxxxxxxxxxx），页面关闭后无法再次查看，请立即保存

充值：新账号有免费额度，用完后在 Billing 页面充值，最低 10 元起充。

找到配置文件路径

Claude 桌面客户端的配置文件是 claude_desktop_config.json，路径因操作系统不同：

macOS：

~/Library/Application Support/Claude/claude_desktop_config.json

Windows：

%APPDATA%\Claude\claude_desktop_config.json

Windows 下在文件资源管理器地址栏直接输入 %APPDATA%\Claude 即可跳转。

如果文件不存在，手动创建即可。

编辑配置文件

用文本编辑器打开 claude_desktop_config.json，写入以下内容：

{
  "mcpServers": {},
  "apiConfigs": {
    "deepseek": {
      "apiKey": "sk-你的DeepSeek密钥",
      "baseUrl": "https://api.deepseek.com/v1",
      "models": [
        "deepseek-chat",
        "deepseek-reasoner"
      ]
    }
  }
}

如果文件已有内容，在现有 JSON 对象中合并 apiConfigs 字段，不要覆盖已有的 mcpServers 配置。

字段说明：

保存文件后，完全退出 Claude 桌面客户端再重新启动（macOS 需要右键 Dock 图标选择”退出”，不能只关窗口）。

验证配置是否生效

1. 重启 Claude 桌面客户端
2. 点击对话框左下角的模型选择器（默认显示 Claude 字样）
3. 下拉列表中应出现 deepseek-chat 和 deepseek-reasoner 选项
4. 选择 deepseek-chat，发送一条测试消息，如”你是哪个模型？”
5. 回复中出现 DeepSeek 相关描述即表示接入成功

如果模型列表没有出现 DeepSeek 选项，检查以下几点：

• 配置文件是否保存成功（用编辑器重新打开确认内容）
• JSON 格式是否正确（可用 jsonlint.com 验证）
• 是否完全退出后重启（不是最小化）

使用中转站接入

如果 DeepSeek 官方 API 访问不稳定，可以换用支持 DeepSeek 的 API 中转站，只需修改 baseUrl 和 apiKey：

{
  "apiConfigs": {
    "deepseek-via-proxy": {
      "apiKey": "sk-中转站密钥",
      "baseUrl": "https://中转站地址/v1",
      "models": ["deepseek-chat", "deepseek-reasoner"]
    }
  }
}

模型名称保持不变，中转站会自动路由到 DeepSeek 后端。