Claude Desktop
在 Claude 官方桌面客户端中通过第三方推理配置使用 OminiApi
Claude Desktop 是 Anthropic 官方桌面客户端。通过它的「第三方推理」配置，可以不登录 Anthropic 账号，把请求直接发到 OminiApi。
Claude Desktop 的菜单名称会随版本变化，下文以当前版本为准，旧版本找同名选项即可。
准备工作
在控制台「API 密钥」页面创建一个密钥并复制（见 API 密钥）。密钥的分组里要有 Claude 模型，例如 claude-opus-5-5、claude-sonnet-5、claude-haiku-4-5-20251001，可在 模型广场 确认。
软件下载
打开 Claude Desktop 下载页，在 Desktop 一栏按系统下载对应的安装包。
软件安装
Windows 安装程序需要访问 Anthropic 官方服务器。如果直接双击安装报错，需要让安装程序走代理：开启代理软件的全局（TUN）模式，或用命令行强制它走代理。
确认代理软件的本地端口。以 Clash Verge 为例，默认端口是 7897。
在安装程序所在目录打开 cmd，依次运行（端口换成你自己的）：
set HTTP_PROXY=http://127.0.0.1:7897
set HTTPS_PROXY=http://127.0.0.1:7897
"Claude Setup.exe"安装程序会正常启动，按提示完成安装。
嫌手动配置麻烦？用 CC Switch
下面这套「开发者模式 + Configure third-party inference」流程菜单比较深。如果你装了 CC Switch，可以用它的 Claude Desktop 面板直接配置，也能从 Claude Code 的配置一键导入。不想装额外软件，继续往下看手动流程。
配置步骤
开启开发者模式
打开 Claude Desktop，停在登录页即可，不需要登录。
登录页上看不到菜单时：先用鼠标点一下邮箱输入框，再按 Tab 键把焦点移到左上角菜单，按回车依次进入 Help → Troubleshooting → Enable Developer Mode。
确认开启后客户端会自动重启，顶部菜单会多出 Developer。没出现的话，完全退出 Claude Desktop 再重新打开。
填写网关配置
用同样的方法打开菜单，进入 Developer → Configure third-party inference，Connection 选择 Gateway，然后按下表填写：
| 配置项 | 填写内容 |
|---|---|
| Gateway base URL | https://omini.ominiapi.top（末尾不要加 /v1 或 /v1/messages） |
| Credential kind | Static API key |
| Gateway API key | 你的 API Key |
| Gateway auth scheme | bearer（选 x-api-key 也可以） |
| Skip login-mode chooser | 打开，之后启动不再弹登录页 |
其余选项保持默认。
保存并重启
点击右下角 Apply Changes（部分旧版本显示为 Apply locally），在 Save & Restart? 提示中点击 Save & Restart，等待客户端自动重启。
验证
新建一个对话，在模型选择器里选一个 Claude 模型，发一句话，能正常回复就说明配置成功。
不用等「测试通过」
这个页面走的是第三方网关模式，不是官方账号校验，所以 Test connection 只作参考。以重启后能否正常对话为准。
日志里多了一笔小额调用？
新建对话、发出第一条消息后，客户端会额外发起一次很小的调用来生成对话标题，用的模型可能和你选的不一样。这是正常现象，花费很少。
配置速查
Connection: Gateway
Gateway base URL: https://omini.ominiapi.top
Credential kind: Static API key
Gateway API key: 你的 API Key
Gateway auth scheme: bearer排查
依次检查：