Claude 系列客户端接入
本节适用于只能通过 Anthropic 协议接入的官方客户端：
- Claude Code CLI：Anthropic 官方命令行工具
- Claude 官方桌面端：macOS / Windows / Linux 桌面应用
两者都通过 /v1/messages（Anthropic Messages 兼容接口）调用本网关，鉴权方式都是 Authorization: Bearer <你的 API Key>。
如果你用的是支持 OpenAI 自定义 Base URL 的通用客户端（Cherry Studio、LobeChat、OpenCat、自写代码用 OpenAI SDK 等），请走 通用客户端接入。
适用范围
| 客户端 | 接入方式 | 详细文档 |
|---|---|---|
| Claude Code（CLI） | 环境变量 / ~/.claude/settings.json | Claude Code CLI 接入 |
| CC Switch | Claude Code 多配置切换 | CC Switch 接入 |
| Claude 官方桌面端 | Developer Mode → Configure Third-Party Inference | Claude 桌面端接入 |
仅支持 Claude 系列模型
通过 Anthropic 协议接入只能调用 Claude 系列模型（claude-opus-4-7 / claude-opus-4-6 / claude-sonnet-4-6 / claude-haiku-4-5-20251001）。完整清单见 Messages → 可用模型。
如需同时使用 GPT、Gemini、国内大模型等，请改用支持 OpenAI 协议的通用客户端，详见 通用客户端接入。
不要混淆 MCP
Claude Desktop 的 Connectors / MCP 是连接工具和数据源的协议（远程 / 本地 MCP Server），不是切换模型供应商的入口。不要把 https://api.aiqizhilian.tech 填成 MCP Server URL。
接入信息
| 项目 | 值 |
|---|---|
| 服务域名 | https://api.aiqizhilian.tech |
| Claude Messages 接口 | POST /v1/messages |
| 鉴权方式 | Authorization: Bearer <你的 API Key>（Claude Code 使用 ANTHROPIC_AUTH_TOKEN） |
必须使用 ANTHROPIC_AUTH_TOKEN
请使用 ANTHROPIC_AUTH_TOKEN，不要用 ANTHROPIC_API_KEY。原因：后者会让 Claude Code 发送 x-api-key: <key> 头部，与本网关接受的 Authorization: Bearer <key> 不一致，会返回 401。
下一步
- 接入步骤 — Claude Code CLI：环境变量、
settings.json持久化、连通性测试 - CC Switch 接入 — 使用 CC Switch 在 macOS / Windows 上切换到 AIQizhilian 配置
- Claude 桌面端接入 — Claude Desktop：Developer Mode 配置步骤
- 常见问题 —
/model看不到模型、token 统计异常、tool/thinking 问题