客户端接入
CC Switch
说明 InfiniteX 当前 CC Switch 导入入口、已验证边界和发布前必做的端到端检查
目标
理解 InfiniteX 能向 CC Switch 生成导入配置，但只有“创建独立 provider、发起请求并在使用日志出现”全部通过后，才能把本机配置判定为可用。
前置条件
- 已安装 CC Switch；本文检查版本为
3.16.5，应用内提示可更新到3.17.0。 - 已创建只用于该客户端的低额度、短有效期、单模型 Key。
- 不编辑或覆盖正在使用的其他 provider。
准确入口
条件操作步骤
- 在可用渠道选择一个当前可用且标有 CC Switch 导入能力的公开路线，或在 API 密钥行打开“CC Switch”。
- 选择自己专门创建的临时 Key，让 InfiniteX 生成
ccswitch://导入链接。不要复制或公开 deep link，它可能携带敏感配置。 - 打开 CC Switch 后确认落到预期客户端类型和新 provider 预览；不要覆盖现有使用中的 provider。
- 保存前核对 provider 名称、Base URL、协议和模型都来自当前 InfiniteX 页面。
- 切换到新 provider，发送最小文本请求，再在 InfiniteX 使用日志核对 endpoint、模型、费用和 request ID。
- 验证后撤销临时 Key；不再使用时删除测试 provider。
当前验证结论
InfiniteX ccswitch:// deep link 已实测能打开 CC Switch 的 Codex 页面，CC Switch 3.16.5 能显示当前原有 provider 状态。但本次没有创建 InfiniteX 测试 provider，也没有从 CC Switch 发出真实请求，因此 不能判定端到端 PASS，本页不承诺“已验证支持”。
成功结果
当前已达到的结果仅是 deep link 打开正确客户端页面。完整成功必须同时满足：新建独立 InfiniteX provider、选择运行时可用模型、完成最小文本请求、InfiniteX 使用日志出现对应记录、撤销测试 Key；任一步缺失都不能标记为支持。
常见错误
| 现象 | 可执行检查 |
|---|---|
| 导入按钮禁用 | 该渠道当前不可用，或还没有选择自己的 API 密钥 |
| deep link 无反应 | 确认 CC Switch 已安装并注册 ccswitch:// 协议 |
| 打开了错误客户端类型 | 返回 InfiniteX 重新选择对应路线，保存前核对 provider 页面 |
| 请求失败 | 核对 Base URL、协议、模型和 Key 限制，并查使用日志 |
| 原 provider 被覆盖 | 立即切回原 provider；测试应创建独立 provider |
截图状态
CL-03 未发布：Windows 图形捕获对 CC Switch 返回窗口边框捕获失败，虽然 UI Automation 可读版本和 provider 状态，但端到端请求尚未完成，不能用不完整截图暗示验证通过。
安全与计费影响
deep link 与导入配置可能包含 Key，不得进入文档、截图、聊天或 issue。测试 provider 使用独立低额度 Key；不要编辑用户当前在用的 provider。
下一步
端到端验证完成前，优先使用已通过真实请求的Codex或Claude Code。
最后更新于