客户端集成
CC Switch
Claude Code / Codex 配置与连接排查
按客户端填写
| 字段 | Claude Code 标签页 | Codex 标签页 |
|---|---|---|
| 服务商 | 自定义 / YunQi AI | 自定义 / YunQi AI |
| API 格式 | Anthropic Messages（原生） | OpenAI Responses |
| Base URL | https://www.yunqiai.chat | https://www.yunqiai.chat/v1 |
| 最终请求路径 | /v1/messages | /v1/responses |
| API Key | 控制台创建的 YunQi Key | 控制台创建的 YunQi Key |
| 模型 ID | 客户选定的 Claude 完整型号 | 客户选定的 GPT 完整型号 |
Claude Code 的认证字段可选 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN，只保留一种有效来源。不要将完整 /v1/messages 填成 Base URL，也不要在 Claude 标签页使用 OpenAI Chat 格式。
Codex 保持 wire_api = "responses"，provider 名称与 model_provider 一致。配置文件字段见 Codex；Claude 主模型和别名字段见 Claude Code。
保存与调用
- 保存并启用服务商
确认它是对应客户端标签页的当前服务商；只添加条目不会自动让所有客户端使用它。
- 检查实际配置
退出旧客户端会话后重启。若启用 CC Switch 本地代理接管，本地回环地址可能是正常代理入口；确认代理进程在运行，不要同时手改由 CC Switch 管理的文件。
- 发送真实请求
使用选定模型发送短消息，检查完整回复，再检查流式和工具调用。地址测速、模型列表和真实生成分别验证不同环节，不能相互替代。
连接失败排查
| 现象 | 检查项 |
|---|---|
| DNS / TLS / timeout | 核对域名 www.yunqiai.chat 的拼写、系统时间、DNS、代理以及证书链；这类失败通常尚未进入模型接口 |
| 域名失败、IP 可用 | 检查 DNS、IPv4/IPv6 路由、域名代理规则、SNI 与证书；HTTP IP 成功不能证明 HTTPS 域名链路正常 |
| 401 / 403 | 检查当前启用的服务商、有效 Key、认证字段冲突及密钥权限 |
| 404 | 检查最终路径是否重复 /v1 或拼入 /messages；检查完整模型 ID |
| 429 / 503 | 读取错误正文，区分额度、限流、分组与渠道问题；保留请求 ID |
客户端之间可能使用不同代理和证书存储。不要关闭证书校验、使用 --insecure，也不要将带密钥的请求降级到 HTTP。HTTPS IP 地址只有证书也覆盖该 IP 时才能通过校验。
字段界面随 CC Switch 版本变化；以最终写入的配置与请求地址为准。参考 CC Switch 服务商配置。