> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnimux.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop 接入

> 将 Claude Desktop 连接到 OmniMux

## 概述

<Note>
  OmniMux 网关统一使用 Base URL：`https://api.omnimux.ai`（OpenAI 兼容客户端通常填 `https://api.omnimux.ai/v1`）。控制台为 [omnimux.ai/dashboard](https://omnimux.ai/dashboard)。文中的模型 ID 仅为示例，请以控制台或 `GET /v1/models` 为准。
</Note>

Claude Desktop 是 Anthropic 官方桌面客户端，适合在本地电脑上直接使用 Claude。

本文介绍如何将 Claude Desktop 连接到 **OmniMux API**，并通过 OmniMux 访问兼容 Anthropic Messages API 的模型能力。

**本文包含：**

* 安装 Claude Desktop
* 开启开发者模式
* 配置 OmniMux 连接参数
* 重启并选择模型

## 使用前准备

在开始配置之前，请先准备好 OmniMux API Key。

### 获取 OmniMux API Key

* 登录 [OmniMux 控制台](https://omnimux.ai/dashboard)
* 在控制台中找到 API Keys，点击"创建新Key"按钮，然后复制生成的 Key
* API Key 通常以 `sk-` 开头，请妥善保存

## 第一步：下载 Claude Desktop

访问 [Claude Desktop 下载页](https://claude.com/download)，根据您的操作系统下载并安装对应版本。

**提示：** 如果您还没有安装 Claude Desktop，请先完成安装再继续后续配置。

### 安装后检查

安装完成后，建议先确认 Claude Desktop 可以正常启动。

## 第二步：开启开发者模式

启动 Claude Desktop 后，点击菜单栏 **Help → Troubleshooting**，在弹出的面板中启用开发者模式（Enable Developer Mode）。

启用后，菜单栏会出现 **Developer** 入口，用于后续配置第三方推理。

**提示：** 如果菜单中没有出现 Developer 入口，请确认您的 Claude Desktop 版本支持开发者模式和第三方推理配置。

如果后续要使用 Gateway / Cowork 模式，请先启用 Windows 的虚拟机平台功能：

1. 按 `Win + R`
2. 输入 `optionalfeatures`，然后按 `Enter`
3. 在 **Windows 功能** 窗口中，勾选 **虚拟机平台**
4. 点击 **确定**
5. 如果系统提示重启，请重启电脑

完成后启动 Claude Desktop，点击菜单栏 **Help → Troubleshooting**，在弹出的面板中启用开发者模式（Enable Developer Mode）。

启用后，菜单栏会出现 **Developer** 入口，用于后续配置第三方推理。

**提示：** 如果菜单中没有出现 Developer 入口，请确认您的 Claude Desktop 版本支持开发者模式和第三方推理配置。

## 第三步：打开第三方推理配置

在开发者菜单中，进入第三方推理配置面板，按下表填写：

| 字段                  | 说明                                                                                              |
| ------------------- | ----------------------------------------------------------------------------------------------- |
| Gateway base URL    | OmniMux 的网关地址，建议填写 `https://api.omnimux.ai`                                                     |
| Gateway API key     | 直接填写您的 OmniMux API Key 本身，不需要加 `Bearer` 前缀                                                      |
| Gateway auth scheme | `bearer`                                                                                        |
| Model list          | 建议填写。请只添加支持 Anthropic Messages API 的文本/聊天模型 ID。您也可以直接跳到文末的 [支持的模型](#supported-claude-models) 表格 |

**说明：** 如果您的 Claude Desktop 版本中字段名称略有不同，请以实际界面为准，但含义应保持一致。

## 第四步：保存并重启

保存配置后，完全退出 Claude Desktop，再重新启动。

重启后，Claude Desktop 应该会使用新的第三方推理配置。

**预期结果：** 启动后可以看到可用模型列表，且请求会通过 OmniMux 转发。

## 第五步：选择模型

重启后，在模型选择区域确认可用模型是否正常出现。

## 工作方式

Claude Desktop 通过 Anthropic 兼容的 Gateway 与 OmniMux 交互：

1. Claude Desktop 将请求发送到您配置的 Gateway 地址。
2. OmniMux 接收请求并转发到对应的模型服务。
3. 返回结果后，Claude Desktop 继续在本地展示对话结果。

这个流程不需要额外安装本地代理程序。

## 支持的模型

如果您想在 `Model list` 中手动限制可见模型，可以使用下面这些模型 ID。

| 模型 ID                        |
| ---------------------------- |
| `claude-haiku-4-5-20251001`  |
| `claude-sonnet-4-5-20250929` |
| `claude-opus-4-5-20251101`   |
| `claude-sonnet-4-6`          |
| `claude-sonnet-5`            |
| `claude-opus-4-6`            |
| `claude-fable-5`             |
| `claude-opus-5`              |
| `claude-opus-4-8`            |
| `claude-opus-4-7`            |
| `deepseek-v4-flash`          |
| `deepseek-v4-pro`            |

## 常见问题

### 开发者菜单没有出现

请确认您已开启开发者模式，并且已完整重启过 Claude Desktop。

### 配置后无法连接

请检查以下内容：

* Base URL 是否填写正确
* API Key 是否有效
* 认证方式是否为 `bearer`
* 是否已经完全退出并重新打开 Claude Desktop

### 没有看到模型

请确认账号和网络状态正常，再检查第三方推理配置是否已成功保存。

### `Model list` 要不要填？

建议填写。请只添加支持 Anthropic Messages API 的文本/聊天模型 ID。

### 如果要手动指定模型，应该填什么？

填写上方"支持的模型"表格中的模型 ID，多个模型按 Claude Desktop 支持的格式填写即可。