CC-Switch 接入 kukuai.fyi

CC-Switch 的 kukuai.fyi 中转站路由、OpenAI/Claude 协议差异、OAuth 切换和排障教程。

你有多个开发工具，需要统一切换 kukuai.fyi 路由。
你想把 OpenAI 兼容和 Claude 兼容配置分开管理。
你需要在 API Key 模型调用和 OAuth 插件能力之间切换。

准备工作

checklisttext

1. 已安装 CC-Switch
2. 已安装需要被路由的工具，例如 Codex CLI / Claude Code / Cursor
3. 已准备 kukuai.fyi API Key
4. 已确认要配置 OpenAI 兼容路由还是 Claude 兼容路由
5. 已知道插件能力需要 OAuth，模型中转使用 API Key

路由怎么填

先按协议拆成两条路由。不要把 /v1 同时填到所有协议里。

routestext

OpenAI 兼容路由
Name: kukuai-openai
Base URL: https://www.kukuai.fyi/api-proxy/china/v1
API Key: sk-你的-kukuai-api-key
Default Model: gpt-5-2-chat-latest

Claude 兼容路由
Name: kukuai-claude
Base URL: https://www.kukuai.fyi/api-proxy/china
API Key: sk-你的-kukuai-api-key
Default Model: claude-sonnet-4-6

逐步配置

flowtext

1. 打开 CC-Switch
2. 进入 Routes / Providers / API 路由配置
3. 新建 kukuai-openai 路由
4. Base URL 填 https://www.kukuai.fyi/api-proxy/china/v1
5. API Key 填 kukuai.fyi 控制台生成的 Key
6. 填一个默认聊天模型
7. 保存路由
8. 启用路由
9. 重启目标工具并验证

OAuth 场景

如果你是为 Codex 插件、ChatGPT 账号能力或类似 OAuth 能力配置，重点不是模型 Base URL，而是登录模式是否正确。

oauth-flowtext

1. 如果目标是 Codex / ChatGPT 插件能力，先退出 API Key 登录
2. 清理 OPENAI_API_KEY / OPENAI_BASE_URL 等环境变量
3. 在工具里重新走 OAuth 登录
4. 确认 CC-Switch 路由开启
5. 重新开一个干净会话测试插件是否可见

验证路由

先绕过工具层，用最小请求验证 kukuai.fyi 本身可用，再回到 CC-Switch。

smoke-test.shbash

curl https://www.kukuai.fyi/api-proxy/china/v1/chat/completions \
  -H "Authorization: Bearer $KUKUAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-2-chat-latest",
    "messages": [{"role": "user", "content": "测试 CC-Switch 路由"}]
  }'

排障清单

troubleshootingtext

1. 工具仍然走旧地址
   - 确认 CC-Switch 路由已经启用
   - 重启终端和目标工具

2. 404
   - OpenAI 兼容路由必须带 /v1
   - Claude 兼容路由通常使用根地址

3. 插件不可用
   - 不要继续在 API Key 模式排查
   - 退出 API Key 登录后改用 OAuth

4. 路由看起来开启但请求失败
   - 先用 curl 直接请求 kukuai.fyi
   - 再排查 CC-Switch 转发层

CC-Switch 接入 kukuai.fyi ​

准备工作 ​

路由怎么填 ​

逐步配置 ​

OAuth 场景 ​

验证路由 ​

排障清单 ​

下一步 ​