Claude Desktop

Claude Desktop 的 第三方推理 / Gateway 模式 使用独立配置面板，不从 Claude Code CLI 的 ANTHROPIC_BASE_URL 或 settings.json 读取网关路由。桌面端按本页操作；终端命令请看 Claude Code。

前置条件

网关路由需要支持 /v1/messages、流式输出和工具调用。完成配置不代表所有 ApiGo 模型都能用于 Desktop。Anthropic 的第三方接入文档面向 Claude 模型，不应仅因其它模型出现在列表中就认定其可用。

macOS 使用顶部菜单栏；Windows 使用登录页左上角的应用菜单：

如果组织策略使表单只读，需要管理员更新策略；本地配置不能覆盖受管网关设置。参见官方应用内配置说明。

这套静态 Key 方案不填写 OIDC / Interactive sign-in 字段。Base URL 不带 /v1 或 /v1/messages。应用前先使用面板的连接测试。参见 Gateway 配置参考。

Desktop 自动发现的列表与 ApiGo 模型目录并不相同。Desktop 可以请求网关的 /v1/models，但自动发现会筛选能识别为 Claude 的模型 ID。模型未出现在选择器中，不一定是 API Key 错误。

需要固定网关模型 ID 时，在配置面板的 Models 中填写显式模型列表。对应的 inferenceModels 值结构如下：

[
  {
    "name": "YOUR_MODEL_ID",
    "labelOverride": "My ApiGo model"
  }
]

将 YOUR_MODEL_ID 替换为网关的准确模型 ID。在面板的模型列表编辑区填写名称和可选显示标签；上面的 JSON 用于说明导出配置的字段结构，不是可直接写入 claude_desktop_config.json 的完整文件。第一项为默认模型；应用并重启后，在客户端选择该模型。

显式列表只控制模型选择，不进行协议转换，也不补齐缺失能力。非 Claude 模型请先向 ApiGo 支持确认兼容性，不要将其它模型改名为 Claude 来暗示支持。若希望通过 Messages 尝试自定义模型，Claude Code CLI 指南提供了直接指定模型 ID 的方法。

仅在路由已验证支持后，才开启扩展上下文或 tier 能力。参见模型列表配置参考。

点击 Apply locally，保存到当前设备并重新启动。如果应用没有自动重启，请完全退出后重新打开；出现启动选项时进入已配置的 Gateway。组织批量部署可以从同一面板导出受管配置。

发一条短请求，到调用日志核对实际模型、完成状态和用量。使用 Code 或 Cowork 时，再验证一次工具操作与完整回复。连接测试成功不等于完整 Agent 流程验收。

入口	配置位置
Claude Code 终端	CLI 环境变量或用户设置
Desktop Gateway 模式	Third-Party Inference 面板或受管配置
Desktop MCP 连接器	工具和数据源配置，不替换推理 Provider

不要把终端 export 命令复制到 MCP 配置中。登录普通 Claude 聊天也不代表请求已走 ApiGo，应核对 Gateway 配置和对应 ApiGo 日志。参见 Desktop 路由说明。

现象	检查项
找不到 Developer 菜单	启用 Developer Mode 并重启，检查客户端版本及组织策略。
配置表单只读	当前受管配置优先，需要管理员调整。
Gateway unreachable / 401	地址、网络、静态 Key 凭据类型、鉴权方案和 Key 状态。
只显示 Claude 模型	Desktop 自动发现存在过滤；对已支持的网关 ID 使用显式列表，选中不等于兼容。
模型可选但调用失败	准确 ID、Messages 协议、权限、流式与工具兼容性。
CLI 可用而 Desktop 不可用	两者使用独立 Provider 配置，重新核对 Desktop Gateway 面板。