Claude 桌面端接入
Claude 官方桌面端通过 Developer Mode 中的「Configure Third-Party Inference」选项，可以把模型请求切到本 API 网关。无需打补丁，无需反向代理，是 Anthropic 官方提供的配置入口（"Cowork on 3P" 第三方推理模式）。
协议兼容性
本网关 /v1/messages 已经过验证，流式响应包含 Anthropic 协议要求的完整 SSE 事件序列（message_start / content_block_start / content_block_delta / content_block_stop / message_delta / message_stop），可被 Claude Desktop 正确解析。
适用版本
此入口在较新的 Claude Desktop 版本中开放。如果你的菜单里没有「Help → Troubleshooting → Enable Developer Mode」选项，请先升级到最新版本。
步骤
1. 启动但不要登录
打开 Claude 桌面端，不要点击「Sign in / 登录」。直接停在登录前的初始界面。
2. 启用 Developer Mode
在菜单栏点击：
text
Help → Troubleshooting → Enable Developer Mode启用后，菜单栏会多出一个 Developer 菜单。
3. 打开 Gateway 配置面板
在新出现的 Developer 菜单点击：
text
Developer → Configure Third-Party Inference…4. 填入配置
| 字段 | 填入值 |
|---|---|
| Backend | Gateway (Anthropic-compatible) |
| Gateway base URL | https://api.aiqizhilian.tech |
| Gateway API key | <你的 API Key> |
| Gateway auth scheme | bearer |
填完点 Apply locally 保存。
5. 重启 Claude 桌面端
完全退出 Claude 桌面端再重新打开（菜单栏 Claude → Quit Claude，不是关窗口）。
6. 选择 Gateway 启动
回到启动界面，选择 Continue with Gateway（会显示 "Local configuration"）。
进入主界面后，模型选择器会列出本网关返回的模型清单，可选用其中任意 Claude 系列模型（详见 可用模型）。
推荐模型
| Model | 建议用途 |
|---|---|
claude-sonnet-4-6 | 日常对话与文本任务 |
claude-opus-4-7 | 复杂推理、长文本、方案设计 |
claude-haiku-4-5-20251001 | 轻量、低延迟任务 |
与 Claude Code CLI 的区别
| 项目 | Claude Code CLI | Claude 桌面端 |
|---|---|---|
| 配置入口 | 环境变量 / ~/.claude/settings.json | Developer Mode → Configure Third-Party Inference |
| 配置粒度 | 终端会话级 / 项目级 / 用户级 | 应用级 |
| 模型自动发现 | 通过 /v1/models | 通过 /v1/models |
| 后台任务模型选择 | 由 ANTHROPIC_DEFAULT_*_MODEL 控制 | 由桌面端内置策略决定 |
桌面端配置好后，所有 Claude 推理请求会通过 https://api.aiqizhilian.tech/v1/messages 发出，鉴权方式与 Claude Code 一致（Authorization: Bearer）。
关于 MCP / Connectors
不要混淆
Claude Desktop 的 Connectors / MCP 能力不是用于切换模型供应商的入口。它是 Model Context Protocol，用于连接工具和数据源（远程 MCP Server、本地 MCP Server）。
- ❌ 不要把
https://api.aiqizhilian.tech填成 MCP Server URL —— 这是 LLM API，不是 MCP 服务。 - ✅ 切换底层模型一定走 Developer → Configure Third-Party Inference。
- ✅ 如果未来提供远程 MCP Server，它可以作为 Claude Desktop 的工具连接器使用，与模型 API 网关并行存在，互不干扰。
常见问题
菜单里没有 "Enable Developer Mode"
升级到最新版本：
- macOS：点击 Claude → Check for Updates
- Windows / Linux：从官网下载最新安装包覆盖安装
配置后启动界面没有 "Continue with Gateway"
请确认：
- 第 1 步是「完全退出」后再启动，而不是仅关闭窗口。macOS 上 Cmd+Q 或菜单栏 Claude → Quit Claude。
- 在 Developer 配置面板里点了 Apply locally，并看到 "saved" 之类的反馈。
401 / 403 错误
- 检查 Gateway auth scheme 是不是
bearer（其他选项会用x-api-key头，本网关不接受）。 - 检查 API Key 拼写。
- 通过 curl 预检 验证 API Key 是否可用。
Token 统计 / 上下文窗口异常
参考 Claude Code 部分的 Token 统计或上下文预估异常，原因和处理一致。
参考
- Claude Desktop 内 Developer 菜单的 Configure Third-Party Inference 是 Anthropic 官方提供的 Gateway 配置入口，适用于第三方 Anthropic 兼容 API 网关。
- 本网关
/v1/messages已经实现 Anthropic Messages 接口的核心兼容能力。流式、工具调用、计费 usage 等行为参考 流式输出 中关于网关行为的说明。