CC Switch 接入 XQAPI

在 CC Switch 中分别添加 Claude Code 和 Codex 供应商。XQAPI 原生提供 Messages 与 Responses 接口，无需本地协议转换。

准备工作

1. 1
   选择目标应用

   在 CC Switch 顶部选择 Claude Code 或 Codex，然后点击右上角 +。

2. 2
   填写 XQAPI 配置

   按下方对应配置添加供应商，并通过 Fetch Models 读取公开模型。

3. 3
   启用供应商

   保存后在供应商卡片上点击启用，再启动对应的 Coding Agent。

配置

复制与你的客户端对应的最小配置，再把占位密钥和模型 ID 替换为自己的值。

应用：Claude Code
预设：Custom
Endpoint URL：https://ai.kuo.la
API Format：Anthropic Messages
API Key：your-xqapi-key
Model：从 XQAPI Claude 模型中选择

应用：Codex
预设：OpenAI Compatible
Endpoint URL：https://ai.kuo.la/v1
API Format：OpenAI Responses
API Key：your-xqapi-key
Model：gpt-5.4

验证

• 在供应商编辑页运行 Stream Check 或连接测试。
• 启用供应商后确认卡片显示正确的 Endpoint URL 和模型。
• 分别启动 Claude Code 或 Codex 发送短请求，并在 XQAPI 请求日志中核对结果。

常见问题

• Claude Code 使用站点根地址和 Anthropic Messages；Codex 使用带 /v1 的地址和 OpenAI Responses。
• 这两种接口都可直接请求 XQAPI，不需要启用 Local Routing 做协议转换。
• 切换 Codex 供应商后应重启 Codex，让模型目录和供应商配置重新加载。