接入教程 · 截至 2026-10-07

Claude 桌面版接第三方 API：3P 网关配置、限制与常见问题

截至 2026-10-07，Claude 桌面版（Claude Desktop）能接第三方 API，但只认实现了 Anthropic Messages API 的网关；官方定位是在网关上用 Claude 模型，自动发现也只显示 Claude 型号。入口在开发者模式：Help → Troubleshooting → Enable Developer Mode，再点 Developer → Configure Third-Party Inference，推理提供方选 Gateway，填 base URL 与密钥。桌面版不读 Claude Code CLI 的 ANTHROPIC_BASE_URL 与 settings.json，GPT 也接不进去。本页按 Anthropic 官方文档与 QCode 文档整理步骤、它和 Claude Code 的区别与常见问题。

更新于 2026-10-08

#3P 模式#Anthropic Messages API#仅 Claude 模型#开发者模式

动手前先记住四件事

Gateway

推理提供方选这一项

在 Configure Third-Party Inference 窗口的 Connection 区块把 Inference provider 设为 Gateway，再填 Gateway base URL、Gateway API key 与认证方式。官方称这个窗口会边填边校验，并能对你的端点测试连接。

/v1/messages

网关必须实现的接口

官方要求网关实现 Anthropic Messages API：POST /v1/messages 必须支持流式与工具调用；GET /v1/models 可选，实现了就自动发现模型，没实现就手动填 inferenceModels。

仅 Claude

能选的模型

官方网关文档的定位就是在网关上用 Claude 模型，自动发现只显示 ID 能认出是 Claude 的型号。QCode 文档写明 GPT 系不能走 Anthropic 端点，所以 GPT 接不进桌面版。

两套配置

桌面版与 CLI 各读各的

桌面版从自己的第三方推理配置读取网关设置，不读 ANTHROPIC_BASE_URL 与 settings.json；Claude Code CLI 正好相反，靠环境变量或设置文件指向网关。

Claude 桌面版的 3P 模式是什么

截至 2026-10-07，Claude 桌面版接第三方 API，走的是官方称为 Claude Desktop on 3P 的部署模式：所有模型推理都发到你配置的提供方，可以是 Google Cloud 的 Agent Platform、Amazon Bedrock、Microsoft Foundry、你自己运营的兼容网关，或直接用 Anthropic API。官方架构表写明：标准版的推理走 Anthropic API，3P 模式改走你配置的端点；网页程序打包在应用里，不从 claude.ai 加载；用户身份只用本机身份（由 claude.ai 管理后台托管时除外）；对话存在本机磁盘。官方称 3P 模式保留 Chat、Cowork 与 Code，推理与计费由你选的提供方负责（Cowork 经 QCode 能否使用，本页未验证）。它原本面向因安全、监管或合同要求不能把数据发经 Anthropic 一方产品的组织；单机也能直接在应用里配置，官方把这条路径用于评估、试点或不用 MDM 的组织。

官方文档最近的变化（截至 2026-10-07）

截至 2026-10-07，Claude Desktop on 3P 配置变更日志里最新的一版是 v2.26454.0（2026-10-06）。和网关用户直接相关的有两点：一是官方网关文档写明，早于 v2.19675.0（2026-10-01）的版本，标准模型条目一律按 200K tokens 估算上下文窗口；新版本对能认出原生 1M 窗口的型号按 1M 估算，其余仍按 200K。二是 Gateway auth scheme 现在只接受 bearer 与 x-api-key 两个值，默认 bearer。另外，官方写明网关应保留提示缓存：剥掉 cache_control、或每次请求都改动系统提示与工具列表的网关，会让每一轮都按全价输入重新处理整段对话。QCode 的 Claude Desktop 接入文档更新于 2026-09-25。

时间线

2026-04-16

Claude Desktop v1.3036.0 加入 Gateway auth scheme 配置项，网关凭据可以用 Authorization: Bearer 头或 x-api-key 头发送。

2026-09-25

QCode 的 Claude Desktop 接入文档更新，写明依据官方第三方推理网关文档；当前版本已撤回「接了 QCode 就能免 Pro 使用 Cowork」的说法。

2026-10-07

本页步骤与引语按官方页核于此日；截至这一天，官方配置变更日志里最新的是 v2.26454.0（2026-10-06）。

已确认 vs 没核实到的

已确认（官方文档逐字可核）

以下都能在 Anthropic 官方文档或 QCode 文档里逐字核到：入口是 Help → Troubleshooting → Enable Developer Mode，再到 Developer → Configure Third-Party Inference；网关必须实现 Anthropic Messages API，POST /v1/messages 要支持流式与工具调用，GET /v1/models 可选；自动发现只显示 Claude 型号；认证方式默认 Bearer，可改 x-api-key；桌面版不读 ANTHROPIC_BASE_URL 与 settings.json；网关配置生效期间 Remote Control 不可用；3P 模式没有移动端、claude.ai 网页端、语音模式、用户间分享与 Anthropic 云端会话；3P 按 token 计费、没有席位授权；QCode 上 Claude 模型只能走 Anthropic 端点，地址 https://api.qcode.cc/api。

没核实到或说法不一的

三件事本页不下结论：① Cowork：官方称 3P 模式保留 Chat、Cowork 与 Code，但 QCode 文档已撤回「接了 QCode 就能免 Pro 使用 Cowork」的说法，提醒不要把 Cowork 算进 QCode 的用法里，本页不承诺 Cowork 经 QCode 能用。② 非 Claude 模型：官方写明自动发现只显示 Claude 型号，Claude Code 网关文档也写明官方不支持经任何网关把 Claude Code 接到非 Claude 模型，本页不写在桌面版里用其它模型的配法。③ 联网搜索：未验证。官方功能表注明，不转发 Anthropic 服务端工具的网关要先配置搜索服务；QCode 文档没写桌面版里联网搜索的表现，本页也没有验证经 QCode 能否联网搜索。

和 Claude Code 桌面版、Claude Code CLI 怎么区分

对 Claude Code 桌面版

不是两个应用。官方文档写明 Claude 桌面应用有三个标签页：Chat 用于对话，Cowork 用于 Dispatch 与较长的 agent 工作，Code 用于软件开发；Claude Code 桌面版指的就是其中的 Code 标签页。3P 模式下，Code 运行与独立 CLI 相同的 Claude Code 引擎，自动继承桌面版的第三方推理配置，和 Cowork 用同一个提供方、端点与凭据。所以在桌面版里配好网关，Code 标签页一起生效，不用另配。

对 Claude Code CLI

配置入口不同。CLI 靠 ANTHROPIC_BASE_URL 加一个凭据变量指向网关（QCode 文档用 ANTHROPIC_AUTH_TOKEN），桌面版不读这些。官方写明网关凭据生效时，请求用它代替 claude.ai 订阅登录，订阅的用量限额不适用；只设 ANTHROPIC_BASE_URL、不设凭据，不会替换订阅。怎么选：官方建议想在一个窗口里管并行会话、并排看窗格、可视化审改动就用桌面版；要脚本、自动化或习惯终端就用 CLI，桌面版只支持交互，没有 --print 这类输出方式。

六步在桌面版里接上网关

① 从 claude.com/download 安装 Claude Desktop，启动后先不要登录，也不要创建 Anthropic 账号。② 在 macOS 菜单栏（Windows 在登录页左上角的 ☰ 应用菜单）点 Help → Troubleshooting → Enable Developer Mode，应用重启后会多出 Developer 菜单。③ 点 Developer → Configure Third-Party Inference…，在 Connection 区块把 Inference provider 设为 Gateway。④ Gateway base URL 填网关地址；Gateway API key 填网关发给你的密钥；Credential kind 保持默认的 Static API key；Gateway auth scheme 保持默认 Bearer，网关要求时才改 x-api-key。⑤ 模型：网关实现了 GET /v1/models 就会自动发现；没有的话，在 Models 一栏的 inferenceModels 里逐条写网关接受的完整模型 ID，第一条就是默认模型。⑥ 点 Apply Changes，再点 Save & Restart；重启后登录页会多出按这份配置启动的选项。想切回标准版，在登录页选 Anthropic 登录即可。

在 QCode 上

按 QCode 文档，第 ④ 步这样填：Gateway base URL 填 https://api.qcode.cc/api（不带 /v1，末尾不加斜杠；中国大陆网络文档推荐 https://asia.qcode.cc/api），Gateway API key 填控制台创建的 cr_ 密钥，认证方式保持默认 bearer。QCode 上 Claude 模型只能走 Anthropic 端点，桌面版里选 claude-sonnet-5-5、claude-opus-5-5、claude-sonnet-5 这类 Claude 型号即可；GPT 系不能走 Anthropic 端点，要用 GPT 请换支持 OpenAI 协议的客户端。同一把密钥也能给 Claude Code CLI 用：ANTHROPIC_BASE_URL 设为 https://api.qcode.cc/api，ANTHROPIC_AUTH_TOKEN 设为你的 cr_ 密钥。按 token 计费，各模型单价见 /models；每次请求都能在 probe.qcode.cc 输入 key 查看。

常见问题

Claude 桌面版能接第三方、自定义或中转 API 吗？

能，但只能接实现了 Anthropic Messages API 的网关；官方定位是用 Claude 模型，自动发现只显示 Claude 型号。截至 2026-10-07，官方把这种用法叫 Claude Desktop on 3P：在开发者模式里打开 Configure Third-Party Inference，推理提供方选 Gateway，填 base URL 与密钥。网关必须支持 POST /v1/messages，并支持流式与工具调用。不进 3P 模式的标准版，推理走的是 Anthropic API。

能在 Claude 桌面版里用 GPT 吗？

不能。官方要求桌面版接的网关实现 Anthropic Messages API，自动发现也只显示 Claude 型号；QCode 文档写明 GPT 系不能走 Anthropic 端点。QCode 文档的建议是：要在桌面端用 GPT，选支持 OpenAI 协议的客户端。

我在 settings.json 里设了 ANTHROPIC_BASE_URL，桌面版为什么不走它？

因为桌面版不读它。官方 Claude Code 网关文档写明，桌面应用从自己的第三方推理配置读取网关设置，而不是从 ANTHROPIC_BASE_URL 或 settings.json 读取；这两样只管 Claude Code CLI。要让桌面版（包括其中的 Code 标签页）走网关，就在 Developer → Configure Third-Party Inference 里配置。如果这个窗口是只读的，说明管理员已经下发了配置，它的优先级更高。

用第三方网关还要登录 Claude 账号或订阅 Pro 吗？

不用登录。官方单机配置步骤写明启动后不要登录、也不要创建 Anthropic 账号；配好后登录页会提供跳过 Anthropic 认证、按提供方配置启动的选项。官方写明 3P 模式按 token 计费、由提供方收费，没有席位授权；使用桌面应用本身仍受 Anthropic 商业服务条款约束。代价是少了一些功能：官方功能表里 3P 模式没有移动端、claude.ai 网页端、语音模式、用户间分享与 Anthropic 云端会话。想切回标准版，在登录页选 Anthropic 登录即可。

模型下拉框是空的，或者提示 Gateway was unreachable，怎么办？

先查地址，再查模型列表。Gateway was unreachable 的官方含义是应用启动时连不上你配置的 base URL，要检查地址和网络路径。下拉框为空时，官方建议检查网关的 GET /v1/models 响应和 inferenceModels 列表：/v1/models 连不上或报错时下拉框改用 inferenceModels，这个列表也空，下拉框就是空的。QCode 文档另外提醒：base URL 末尾不要加斜杠，密钥必须以 cr_ 开头且无前后空格；仍为空就手动在 inferenceModels 里写 claude-sonnet-5-5 这类完整 ID。

桌面版和 Claude Code CLI 能同时用、共用一把 QCode 密钥吗？

能。官方写明桌面版与 CLI 运行同一个底层引擎，可以在同一台机器、甚至同一个项目上同时运行。QCode 文档写明两者各自读取配置：桌面版读自己的配置，CLI 读 ~/.claude/settings.json，共用同一个 QCode API Key，互不冲突。要注意的是，把 CLI 会话转进桌面版的 /desktop 命令，官方写明要用 Claude 订阅登录，API key 认证下不可用。

信息来源

3P 模式与网关配置：Anthropic 官方的 Claude Desktop on 3P 文档（claude.com/docs 下的概览、功能对照、安装与设置、应用内配置、LLM 网关、模型与 effort、Chat、Code、法律与合规页，以及配置变更日志），2026-10-07 抓取。桌面版与 CLI 的关系：Claude Code 官方文档（code.claude.com 的桌面应用页、连接 LLM 网关页与其他 LLM 网关页），同日抓取。QCode 侧的地址、密钥与端点规则：QCode 文档的 Claude Desktop 接入页（更新于 2026-09-25）、接入点与 API 格式页、环境变量配置页、订阅与 QCode Key 页，同日抓取。

在 Claude 桌面版里接上 QCode

推理提供方选 Gateway，地址填 https://api.qcode.cc/api，密钥填 cr_ 开头的 QCode 密钥，模型选 Claude 系列。按 token 计费，各模型单价见 /models。

创建账号浏览模型查看定价