Claude 桌面应用接入中转站：在第三方推理设置里填网关地址和 key

Claude 的桌面应用（Windows 和 macOS）可以把模型请求改走第三方网关，官方把这种用法叫“第三方推理”。接中转站用的就是它，里面的对话、Cowork 和 Code 都走这条线路。

先说一个常见的误会：给命令行的 Claude Code 配好了中转站，桌面应用不会跟着生效。 官方文档写明，桌面应用的网关设置来自它自己的第三方推理配置，不读 ANTHROPIC_BASE_URL，也不读 settings.json。要在应用里单独设置：

菜单 Help → Troubleshooting → Enable Developer Mode，应用重启后菜单栏多出 Developer；
菜单 Developer → Configure Third-Party Inference…；
Inference provider 选 Gateway，填中转站的地址和 key。

命令行的接法见 Claude Code 接入中转站。如果你还没弄清中转站是什么、有哪些风险，先读中转站是什么和用中转站有什么风险；选站可以看中转站排行榜。

开始之前：中转站要满足的条件

不是每个中转站都能接桌面应用。官方文档对网关的要求：

接口	要求	说明
`POST /v1/messages`	必须	Anthropic 的 Messages 接口，要支持流式输出和工具调用
`GET /v1/models`	可选	有的话，应用会自动读出可用的模型；没有就要自己列出模型

由此有两点要先确认：

中转站要提供 Anthropic 原生接口。 只有 OpenAI 兼容接口的中转站接不了。
只能用 Claude 模型。 自动读出的模型列表只显示能认出是 Claude 的模型名。酷站AI 的接入文档也写明，GPT、DeepSeek 等不能在 Claude 桌面应用里使用。

从中转站拿到两样东西：Anthropic 原生接口的地址，和一把能用 Claude 模型的 key。

1打开开发者模式

菜单 Help → Troubleshooting → Enable Developer Mode。官方文档说明，应用会重启，重启后菜单栏多出一个 Developer 菜单。

酷站AI 的接入文档补充了几个实际操作上的细节（中转站一方的说法）：

要在没有登录 Claude 账号的状态下做。让应用停在登录界面；已经登录的先退出登录。
Windows 上，这个菜单在登录界面左上角的 ☰ 里。
需要比较新的版本（它写的是 1.2581 及以上）。找不到 Developer 菜单时先升级应用。

2填写网关

菜单 Developer → Configure Third-Party Inference…，在 Connection 部分把 Inference provider 设成 Gateway，然后填下面的 Gateway credentials：

字段	填什么
Gateway base URL	中转站的 Anthropic 接口地址
Gateway API key	中转站的 key
Credential kind	Static API key（默认），不用改
Gateway auth scheme	`Bearer`（默认）或 `x-api-key`，看中转站要哪一种

地址：一般不带 /v1

应用会自己在地址后面接 /v1/messages。官方文档的例子是 https://llm-gateway.example.corp，后面没有路径。

所以地址通常只填到域名，或者中转站指定的前缀：

酷站AI 的文档要求只填域名 https://api.koozhan.com，末尾不带 /v1 也不带 /，并说明多写了 /v1 的话模型列表会是空的；
也有中转站把 Anthropic 接口放在单独的前缀下面，这时要填带前缀的地址。

照你用的那家中转站的文档写。

认证方式：Bearer 还是 x-api-key

这一项决定 key 放在哪个请求头里发出去：

选项	发出的请求头
`Bearer`（默认）	`Authorization: Bearer <key>`
`x-api-key`	`x-api-key: <key>`

各家要求不一样：酷站AI 的文档说两种都可以，也有中转站要求选 x-api-key。选错的表现是认证失败，换另一种再试。

保存

填好后保存并让应用重启。按钮的名字随版本不同：酷站AI 的文档写的是先点 Apply Changes，再点 Save & Restart；也有中转站的文档里写的是点 Apply locally。以你安装的版本显示的为准。

按酷站AI 的说明，应用重启后，登录界面会多出一个用这份配置启动的选项，选它进入。

3选模型

中转站实现了 GET /v1/models 时，模型选择器里会自动出现它提供的 Claude 模型，选一个就能开始用。

模型列表是空的，按下面的顺序查：

地址有没有多写 /v1；
key 是否正确，这把 key 是否开通了 Claude 模型；
中转站是否实现了 /v1/models。没有实现的话，要在配置里明确列出模型，官方的配置项叫 inferenceModels，填中转站接受的完整模型名。官方文档说明：读不到 /v1/models 时，模型选择器会改用这份清单；清单也是空的，选择器就是空的。

接入后有哪些不同

官方文档写明的几点：

云端环境和 Remote Control 不可用。 网关配置生效后，环境选择器里不再提供 Anthropic 托管的云端环境，Remote Control 也用不了。
部分实验性功能默认关闭。 走网关时，应用默认关掉 MCP 的工具搜索和 Claude Code 的其他实验性功能，因为要求严格的网关会拒绝这些功能带的请求头和字段。
公司统一下发的配置优先。 管理员已经下发了第三方推理配置时，应用里的这个表单是只读的，改不了。

想用回官方账号，按酷站AI 的说明，在登录界面选择用 Anthropic 账号登录即可。

省钱的关键：中转站有没有保住提示词缓存

这一条容易被忽略，对费用的影响却很大。

官方文档说明，Cowork 和 Code 的每一轮请求都带着缓存断点，让上游可以重复利用工具定义、系统提示词和前面的对话，不用每轮都重新处理。网关把这些字段原样转发，缓存就有效；网关把它们去掉了，或者每次请求都改动系统提示词和工具列表，上游就要每一轮都按全价重新处理整段对话，又贵又慢。

官方给的检查办法是看用量里的 cache_read_input_tokens：一个会话的第一次请求之后，大多数请求的这个数应该明显大于零。每次都是零，说明缓存没起作用。

落到中转站上：用一会儿之后，到中转站的控制台看用量记录里有没有缓存读取。一直没有的话，同样的工作你付的钱会多出很多。缓存为什么对费用影响这么大，见提示词缓存为什么这么重要。

常见问题

现象	原因和办法
找不到 Developer 菜单	还没打开开发者模式；打开了仍然没有，升级应用
提示 `Gateway was unreachable`	官方的解释是应用启动时连不上你填的地址。检查地址和网络
模型列表是空的，或者缺模型	见上面“第三步”的三项检查
认证失败（`401`）	key 不对，或者认证方式选错了，`Bearer` 和 `x-api-key` 换一种
`402`、`403`	官方的解释是凭据过期，或者网关给这个用户的额度用完了。到中转站控制台看余额和 key 的状态
`API returned an empty or malformed response`	线路上的代理、防火墙或登录页代替模型作了回答。多半是地址写错了路径
长对话提示上下文已满、压缩失败	压缩时要发一个带着整段对话的请求，中转站超时或有自己的大小限制时会失败。对话没有丢，原因解决后下一条消息会重试
配置表单是灰的，改不了	公司下发了统一配置
配置窗口显示 `Couldn't load configuration`	酷站AI 的文档说这是应用自身的问题，和 key 无关；它建议退出登录后在登录界面重新打开，或者重装最新版
命令行的 Claude Code 能用，桌面应用不能	两边的配置是分开的，桌面应用要按本文单独设置

接上之后

验证拿到的是不是真模型。 能回答不等于给你的是它声称的模型。用同一把 key 到 Veridrop 检测一次，背景见中转站怎么掺假。
这份配置连同 key 会留在这台电脑上。 换电脑、把电脑借给别人用之前，到中转站的控制台把 key 停用或换掉。
桌面应用打不开配置窗口、或者中转站不满足上面的条件时，同一把 key 可以改用命令行：Claude Code 接入中转站，或者用 CC Switch 管理配置。