CC Switch 综合配置

统一配置 Claude Code、Claude Desktop、Codex、Gemini CLI、MCP、CLI、用量查询和通用设置。

本页将青云 TOP API 客户端接入资料按使用场景合并整理，适合第一次接入的用户，也适合需要核对协议和路径的 API 开发者。青云 TOP API 基于 New API 部署，因此 New API 官方应用教程中的兼容配置可以直接复用。

快速判断：我应该看哪一段？

只想聊天：先看桌面端的基础配置。
要接入 MCP、知识库或工作流：看 Agent/自动化章节。
要在终端写代码：看 CLI、Provider 和环境变量章节。
遇到 401、403、404 或模型不兼容：先检查本文末尾的接入检查清单，再查看对应来源章节。

CC Switch（融合自原文档）

CC Switch 教程 — 跨平台 AI CLI 管理工具，统一管理 Claude Code、Codex、Gemini CLI 的 Provider 配置、MCP 服务器与系统提示词。对接青云 TOP API 一键填入。

聊天设置选项

在青云 TOP API 控制台的系统设置->聊天设置中，可添加如下快捷选项，便于在令牌管理页一键填充到 CC Switch：

{ "CC Switch": "ccswitch" }

🔀 CC Switch 是一款开源、跨平台的 AI CLI 统一管理工具，支持 Claude Code、Codex 和 Gemini CLI 的 Provider 配置一键切换、MCP 服务器统一管理、系统提示词（Prompts）管理以及 Skills 扩展管理，让你在多个 AI 编程助手之间自由切换，无需手动编辑配置文件。

GitHub 仓库：https://github.com/farion1231/cc-switch
下载地址：GitHub Releases

核心特性

🔌 Provider 管理

一键切换 — 在 Claude Code、Codex、Gemini 的 API 配置之间一键切换，无需手动修改环境变量或配置文件
多端点支持 — 每个 Provider 可配置多个端点，支持 API Key 管理与延迟测速
4 层模型配置 — 支持 Haiku / Sonnet / Opus / Custom 四级模型粒度配置

🛠️ MCP 服务器管理

跨应用统一管理 — 单面板管理 Claude / Codex / Gemini 三端的 MCP 服务器
三种传输类型 — 支持 stdio、HTTP、SSE（Server-Sent Events）
自动同步 — 统一导入导出 + 双向同步

💬 Prompts 管理

多预设系统提示词 — 无限预设、快速切换
跨应用支持 — Claude（CLAUDE.md）、Codex（AGENTS.md）、Gemini（GEMINI.md）
Markdown 编辑器 — CodeMirror 6 + 实时预览

🌐 多平台支持

桌面应用 — Windows、macOS、Linux 原生安装包
Web 版本 — 适用于无头服务器 / SSH 远程环境的浏览器访问方案
CLI 版本 — 命令行交互模式与命令模式双支持

青云 TOP API 接入方法

CC Switch 支持 ccswitch:// Deep Link 协议，可从青云 TOP API 令牌管理页一键导入 Provider 配置。

配置步骤

在青云 TOP API 令牌管理页，点击对应令牌的下拉菜单 在菜单中选择 CC Switch 选项，系统会自动唤起 CC Switch 应用并弹出配置弹窗。

在弹窗中完成配置 !填入 CC Switch 弹窗

弹窗各字段说明：

应用：顶部切换应用类型 — Claude / Codex / Gemini，根据需要选择目标应用 名称：为该配置填写一个名称（例如 My Claude），方便后续在 CC Switch 中识别和切换
主模型（必填）— 默认使用的主力模型 Haiku 模型 — 轻量快速模型
Sonnet 模型 — 均衡模型 Opus 模型 — 最强模型

所有模型均为下拉选择，未选择时显示「请选择模型」。

完成配置 点击 「打开 CC Switch」 即可将配置导入 CC Switch 并开始使用；点击 「取消」 放弃本次操作。

安装方式

macOS（推荐 Homebrew）

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows

从 Releases 下载 .msi 安装包或便携版 .zip。

Linux

从 Releases 下载 .deb 包或 .AppImage。

ArchLinux 用户：

paru -S cc-switch-bin

Web 版本（无头 / SSH 服务器）

wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-web-linux-x64.tar.gz
tar -xzf cc-switch-web-linux-x64.tar.gz
cd cc-switch-web/
./cc-switch-web

默认端口 17666，通过浏览器访问 http://localhost:17666。

接入检查

API 地址填写青云 TOP API 的 Base URL：https://top.qingyuntop.ai/v1；应用若要求不带 /v1 的站点地址，请按页面说明填写对应格式。
API Key 只使用环境变量 $QINGYUN_TOP_API_KEY 或应用的安全密钥存储，不要把真实密钥提交到代码仓库。
模型名称必须与控制台可用模型完全一致；遇到 401/403 检查密钥、分组和模型权限，遇到 404 检查 Base URL 是否重复填写 /v1。

OpenClaw 配合 CC Switch（融合自原文档）

OpenClaw配合CC switch自定义中转站配置

第一步：安装CC switch

\\下载CC Switch并安装

下载地址：下载CC Stitch

配置CC Switch

添加供应商（中转站）

添加供应商（中转站）信息

API端点：https://top.qingyuntop.ai/v1

选择添加

同时可以选择设置为默认渠道

第二步：安装openclaw与基础初始化

首先确保你已经安装了 Node.js 环境，然后在终端执行：

全局安装：

执行引导（根据提示完成基础设置）：

caht配置引导示例
红框标注的地方为需要选择的地方

第三步：检查并启动

启动 Gateway 服务：

访问控制台：
打开浏览器访问 http://127.0.0.1:18789/

接入检查

API Key 使用 $QINGYUN_TOP_API_KEY 占位符保存，不要直接粘贴到公开代码或截图。
OpenAI 兼容客户端通常使用 https://top.qingyuntop.ai/v1；如果客户端要求完整接口路径，再按其界面说明追加路径，避免重复填写 /v1。
先用客户端的“测试连接”或发送一条短消息验证，再到控制台调用日志核对模型和状态。

CC Switch 用量查询（融合自原文档）

配置步骤

在 CC Switch 打开已经保存的青云TOP API Provider。
点击 Provider 卡片上的 配置用量查询。
开启用量查询，预设模板选择 自定义。
保持 {{apiKey}} 为掩码状态，不要在截图中显示完整令牌。
粘贴下面的配置：

({
  request: {
    url: "https://top.qingyuntop.ai/dashboard//api/usage/token/",
    method: "GET",
    headers: {
      "Authorization": "Bearer {{apiKey}}",
      "User-Agent": "cc-switch/1.0"
    }
  },
  extractor: function(response) {
    if (response.code === true && response.data) {
      return {
        isValid: true,
        planName: response.data.name,
        remaining: response.data.total_available,
        used: response.data.total_used,
        total: response.data.total_granted,
        unit: "quota"
      };
    }
    return {
      isValid: false,
      invalidMessage: response.message || "查询失败"
    };
  }
})

青云TOP API 模型令牌用量查询脚本

亚太合作伙伴平台把域名改为 https://top.qingyuntop.ai/dashboard/。点击 格式化 检查语法，再点击 测试脚本 和 保存配置。

Provider 卡片已经显示青云TOP API 已用与剩余额度

CC Switch 通用设置（融合自原文档）

下载安装

只从官方发布页或官方网站下载。macOS 根据处理器选择 aarch64 或 x64，Windows 选择匹配架构的 .msi，Linux 选择发行版对应的 .deb、.rpm 或 AppImage。安装后打开“设置 → 关于”核对版本，再回到主界面选择需要管理的客户端。 !在 CC Switch 的关于页面核对已安装版本

Windows

macOS

Linux

打开官方 Releases 页面并展开当前版本的 Assets。
普通电脑选择 Windows x64 .msi；ARM 设备选择标有 ARM64 的包。
运行安装程序，完成后从开始菜单启动 CC Switch。

使用 Homebrew 时依次执行：

brew tap farion1231/ccswitch
brew install --cask cc-switch

手工下载时，Apple Silicon 选择 aarch64，Intel 选择 x64，安装后从“应用程序”启动。

在 Releases 的 Assets 中复制当前版本的真实文件名。Debian/Ubuntu 下载 .deb 后执行：

sudo dpkg -i ./cc-switch_<version>_amd64.deb

Fedora/RHEL 使用匹配架构的 .rpm；其他发行版可使用 AppImage。不要照抄 <version>。

备份原配置

完全退出 Claude Code，然后备份配置并记录校验和。不存在的文件会自动跳过：

mkdir -p "$HOME/cc-switch-backup"
cp -p ~/.claude/settings.json "$HOME/cc-switch-backup/claude-settings.json" 2>/dev/null || true
shasum -a 256 ~/.claude/settings.json 2>/dev/null

备份可能包含密钥或登录态，不要上传到云盘、公开仓库或工单。

添加青云TOP API Provider

下面以 Claude Code 分支演示通用操作。截图只展示需要点击或填写的区域，令牌已经遮挡；Claude Desktop 的模型映射请参考对应教程。

第 1 步：选择客户端分支

打开 CC Switch，在顶部图标栏选择要配置的客户端。不同分支会生成不同格式的配置文件，请确认当前选中的是正确客户端。 !在 CC Switch 顶部选择目标客户端分支

第 2 步：打开自定义 Provider

点击右上角橙色 +，然后在“添加新供应商”页面选择“自定义配置”。 !点击加号后选择自定义配置

第 3 步：填写青云TOP API 信息

依次填写：

“供应商名称”填写 青云TOP API。
“官网链接”填写 https://top.qingyuntop.ai/dashboard/。
“API Key”粘贴从青云TOP API 创建的专用模型令牌。
“请求地址”按目标协议填写：Anthropic 使用 https://top.qingyuntop.ai/dashboard/，OpenAI 兼容协议使用 https://top.qingyuntop.ai/v1。
亚太地区分别改为 https://top.qingyuntop.ai/dashboard/ 或 https://top.qingyuntop.ai/v1。
模型必须使用青云TOP API /v1/models 对当前令牌返回的准确 ID。

第 4 步：保存并启用

不需要继承本机插件、Hook 或环境变量时，关闭“应用通用配置”，然后点击“保存”。返回 Provider 列表后点击青云TOP API 卡片；卡片出现蓝色边框并成为当前项，表示切换完成。 !青云TOP API Provider 已保存并切换为当前项

客户端协议	青云TOP API 地址	路径规则
Anthropic Messages	`https://top.qingyuntop.ai/dashboard/`	不追加 `/v1/messages`
亚太 Anthropic	`https://top.qingyuntop.ai/dashboard/`	不追加路径

常见问题

顶部没有目标应用：打开“设置 → 通用 → 应用可见性”确认没有隐藏。
Provider 已添加但客户端仍走旧地址：确认卡片显示“使用中”，完全退出并重启客户端。
模型不存在：用同一令牌重新查询 /v1/models，不要使用截图中的示例 ID。
同时运行桌面版和 CLI：两者可能覆盖数据库或实时配置；一次只使用一种管理方式。

验证与恢复

重启目标客户端，发送只包含 ping 的最小请求。成功回复后再启用工具调用、长上下文或自动执行等能力。测试结束后切回原 Provider，关闭本地代理或路由接管，完全退出 CC Switch，再比较配置文件校验和。若不同，先确认没有进程仍在写配置，然后从备份恢复。

Codex App 接入（融合自原文档）

Codex App 可以在兼容版本中复用 Codex CLI 的配置。请先完成 CC Switch 配置 Codex，并确认 Codex CLI 已能正常回复。

直接使用现有配置

在 CC Switch 的 Codex 分支启用 青云TOP API Provider。
在终端运行 codex，确认能够正常对话。
完全退出 Codex App；只关闭窗口可能不会结束后台进程。
重新打开 Codex App。
新建对话并发送一条简短消息。
在青云TOP API 控制台日志中核对相同时间和模型的请求。

首次启动仍显示登录页

如果应用提供 使用 API Key 或 其他方式登录：

选择 API Key 登录方式。
填写青云TOP API 客户端专用 API 令牌。
继续进入应用并发送测试消息。

如果当前版本只提供 OpenAI 账号登录，或者没有读取自定义 Provider，则不要修改 OAuth 文件、系统代理或应用程序资源来绕过登录。继续使用 Codex CLI，并等待客户端版本正式支持自定义 Provider。

切换 Provider 后没有生效

退出 Codex App。
在 CC Switch 中重新确认 青云TOP API 显示为 使用中。
检查 Codex CLI 是否仍可正常回复。
再次打开 Codex App。

CC Switch 配置 Codex（融合自原文档）

CC Switch 可以把青云TOP API 的自定义 Provider 写入 Codex 配置。下面按“安装 CC Switch、添加 Provider、安装并启动 Codex、验证请求”的顺序完成接入。

第一步：安装 CC Switch

从 CC Switch 官方 Releases 下载并安装适合当前系统的版本。
打开 CC Switch，在顶部应用栏进入 Codex。
选择添加供应商（中转站）或 自定义 Provider，填写以下信息：

配置项	填写内容
供应商名称	`青云TOP API`
API Key	粘贴在控制台创建的客户端专用 API Key
API 请求地址	`https://top.qingyuntop.ai/v1`
默认模型	填写 `/v1/models` 返回且支持 Responses API 的完整模型 ID

保存配置并点击启用，确认 Provider 卡片显示“使用中”。

第二步：安装并启动 Codex

从 OpenAI Codex 官方页面下载并安装 Codex。
安装完成后启动 Codex。根据当前版本的登录界面，选择支持自定义 Provider 或 API Key 的方式；如果版本要求 OpenAI 账号登录且没有读取 CC Switch 配置，不要修改 OAuth 文件或系统代理绕过登录。
完全退出并重新打开终端，运行：

codex

连接失败时检查 config.toml

如果 Codex 反复提示连接失败，可以检查配置文件中是否包含页面提示的 OpenAI HTTP Provider 片段：

model_provider = "openai_http"

[model_providers.openai_http]
name = "OpenAI HTTP"

这段内容只用于确认 Provider 类型；API Key、Base URL 和模型仍应以 CC Switch 中保存的青云TOP API Provider 为准。修改前请备份 ~/.codex/config.toml，并在修改后完全重启 Codex。

验证是否接入成功

在 Codex 中发送一条简短消息。
确认收到正常回复。
到青云TOP API 控制台的调用日志中核对请求时间、模型和状态。

常见问题

401：检查 API Key 是否完整、是否仍在使用旧认证信息。
403：检查 API Key 分组、余额和模型权限。
404：检查 Base URL 是否重复填写 /v1，以及模型是否支持 Responses API。
仍访问官方 Provider：完全退出 Codex 和后台驻留的编辑器，再确认 CC Switch 卡片显示“使用中”。
切换后无变化：关闭终端和 Codex 后重新启动，并以控制台调用日志为最终依据。

CC Switch CLI（融合自原文档）

1\. 安装并检查

从 CC Switch CLI 官方发布页下载与系统架构匹配的版本。解压后先查看帮助：

cc-switch --version
cc-switch --help
cc-switch provider --help

不同版本的子命令可能变化，以下命令应以当前 --help 输出为准。

2\. 备份 Claude Code 配置

mkdir -p "$HOME/cc-switch-backup"
cp -p ~/.claude/settings.json "$HOME/cc-switch-backup/claude-settings.json" 2>/dev/null || true

3\. 使用交互界面

直接运行：

cc-switch

在交互界面中选择 Providers，新增自定义 Provider，然后填写：

Name: 青云TOP API
Base URL: https://top.qingyuntop.ai/dashboard/
API Key: 青云TOP API 创建的专用令牌
Model: /v1/models 返回的 Anthropic 模型 ID

保存后把青云TOP API 切换为当前 Provider，再完全退出并重启 Claude Code。

4\. 查看当前状态

先从帮助中确认当前版本支持的命令，再列出 Provider 和当前选中项。不要猜测 Provider ID，也不要把真实 API Key 放在命令行参数中。

5\. 恢复

在 CC Switch CLI 中切回原 Provider。若需要恢复文件，确认 Claude Code 和 CC Switch 都已退出，再使用备份覆盖对应配置。

CC Switch 配置 Claude Desktop（融合自原文档）

Claude Desktop 与 Claude Code 是两个独立应用分支。本页不修改 Claude Desktop 的官方账号登录流程。

添加 Provider

在 CC Switch 顶部选择 Claude Desktop。如果入口不可见，到“设置 → 通用 → 应用可见性”恢复显示。
首次进入没有 Provider 时，可从 Claude Code 导入已有青云TOP API Provider，也可点击 + 手动添加。
导入后逐个检查名称、接口地址、令牌来源和模型映射；相同 ID 不一定会覆盖，无法识别映射的项可能被跳过。
手动添加时选择“自定义配置”，名称填写 青云TOP API，API Key 填模型令牌，请求地址填 https://top.qingyuntop.ai/dashboard/；亚太地区使用 https://top.qingyuntop.ai/dashboard/。不要追加 /v1/messages。

CC Switch Claude Desktop 分支中的青云TOP API 官网、已打码 API Key、请求地址和模型映射开关

开启“需要模型映射”，API 格式选择 Anthropic Messages（原生）。

配置模型映射

点击“获取模型列表”，分别为 Sonnet、Opus、Fable、Haiku 选择青云TOP API 模型列表中的准确 ID。下面使用已验证支持 Anthropic Messages 的 claude-haiku-4-5-20251001 演示四个角色；你的账户应以当前模型列表为准。只有模型明确支持 1M 上下文时才勾选 1M。 !CC Switch 中 Claude Desktop 的青云TOP API Anthropic Messages 模型映射模型映射只改变角色到模型 ID 的对应关系，不会把不支持 Anthropic Messages 的模型转换为 Anthropic 模型。点击“添加”后青云TOP API 卡片会显示“需要路由”。开启左上角路由开关，确认出现“路由服务已启动”和本地监听地址；下面截图中的其他 Provider 已遮挡。 !CC Switch 已为青云TOP API Claude Desktop Provider 启动本地路由服务完全退出并重启 Claude Desktop，发送一条短消息，再到青云TOP API 日志核对请求。关闭 Claude Desktop 后不再使用该路由时，也要关闭 CC Switch 左上角路由开关。

完成配置

部分版本会显示供应商“测试”入口。保存配置后仍需完全退出并重新打开 Claude Desktop，在对话页发送一条短消息，再到青云TOP API 日志核对请求。对话页出现账号登录或官方服务提示时，不要覆盖官方 OAuth 文件；先确认 CC Switch 是否仍接管、Provider 是否启用、应用是否真正退出重启。

CC Switch 配置 Claude Code（融合自原文档）

开始前完成通用备份，并在青云TOP API 模型列表中确认目标模型支持 Anthropic Messages 协议。

添加 Provider

打开已安装的 CC Switch，确认初始 Provider 页面能正常显示。
在顶部应用切换栏选择 Claude Code，不要停留在 Claude Desktop。

点击右上角 +，选择“自定义配置”。

在青云TOP API 创建适用于 Anthropic Messages 的专用令牌并复制；不要使用账号访问令牌。

![青云TOP API API 密钥页面中的创建 API 密钥按钮](https://docs.qingyuntop.ai/images/青云TOP API-api-key-create.png) 在创建表单中填写名称并选择能访问目标 Anthropic 模型的分组；下面截图中的 auto 仅展示表单位置，实际分组以当前模型列表和账户权限为准。 ![青云TOP API 创建 API 密钥表单中的名称与分组设置](https://docs.qingyuntop.ai/images/青云TOP API-api-key-form.png)

名称填写 青云TOP API，API Key 填写模型令牌；请求地址填写 https://top.qingyuntop.ai/dashboard/，亚太地区填写 https://top.qingyuntop.ai/dashboard/。不要追加 /v1 或 /v1/messages。

!CC Switch 中青云TOP API Provider 的名称、官网、已打码 API Key 和请求地址配置 API Key 会显示为圆点；确认截图或录屏中没有展开明文。继续向下检查请求地址： !CC Switch 中青云TOP API Claude API 请求地址为 https://top.qingyuntop.ai/dashboard/

没有合并需求时关闭“应用通用配置”，点击“添加”，确认返回 Provider 列表并出现青云TOP API 卡片。
点击卡片右侧“启用”，确认显示“使用中”。

打开“设置 → 通用”，开启“跳过 Claude Code 初次安装确认”。

完全退出并重新打开终端；下面以 Ghostty 为例启动 Claude Code。

在 Ghostty 中启动

claude --version
claude

下面是在 Ghostty 中实际启动 Claude Code 后的界面。顶部应显示 Claude Code 版本、当前模型和工作目录；不应再跳转到官方登录页。 !在 Ghostty 中启动由 CC Switch 配置的 Claude Code 在 Claude Code 输入框发送一条短消息，并在青云TOP API 控制台日志中核对模型、状态和请求时间。若需要固定模型，在 Claude Code 配置中使用青云TOP API 实际返回的 Anthropic 模型 ID，不要照抄截图中的示例模型。

独立接口检查

curl "https://top.qingyuntop.ai/v1/messages" \
  -H "Authorization: Bearer $QINGYUN_TOP_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-anthropic-model","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

排错

仍出现官方登录：核对“跳过初次安装确认”、Provider 启用状态和 ANTHROPIC_BASE_URL 的实际来源。
CC Switch 自检失败：某些令牌分组可能限制第三方探测；不能据此断定 Claude Code 对话失败。
对话使用错误模型：核对令牌可见模型与 CC Switch 的主模型/快速模型映射。
切换后无变化：完全退出 Claude Code，而不是只关闭当前窗口。

CC Switch（融合自原文档）

CC Switch 可以在图形界面中保存多个 Provider，并把当前选中的配置写入对应客户端。

使用顺序

安装 CC Switch，并备份目标客户端配置。
在青云TOP API 创建客户端专用 API 令牌。
选择正确的应用分支，添加自定义 Provider。
填写青云TOP API 地址、令牌和模型。
保存并启用，再重启目标客户端。

教程

统一接入检查与故障排查

401/403：确认 API Key 未过期、令牌分组允许目标模型，且没有把示例占位符原样提交。
404：核对应用要求的 Base URL 形式；https://top.qingyuntop.ai/dashboard/、https://top.qingyuntop.ai/v1 和完整路径不能重复拼接。
模型为空或不可用：调用 GET /v1/models，复制返回的完整模型 ID，并确认应用使用的协议（OpenAI Chat Completions、Responses 或 Anthropic Messages）。
切换 Provider 后仍访问旧地址：完全退出并重启客户端，检查环境变量、代理和 CC Switch 路由是否覆盖了新配置。
生产环境安全：不要把真实密钥放进前端代码、截图、公开仓库、Deep Link 或工作流导出文件；先用低额度测试令牌验证。

> 本页保留每个来源教程的具体字段、命令、截图和高级选项；重复的 API Key、Base URL 和验证说明已统一到本页开头与本节。

发布前检查

以下检查适用于客户端中选择 OpenAI 兼容 或 Responses 提供商的场景；如果你选择的是 Anthropic、Gemini 等原生协议，请按对应协议的接口和返回结构配置。

模型 ID：先用目标 API Key 请求 GET https://top.qingyuntop.ai/v1/models，把返回的 data[].id 原样填入客户端。截图、教程和历史配置中的模型名不保证仍可用。
协议选择：新 OpenAI 集成优先选择 Responses；只有客户端或模型明确要求 Chat Completions 时才选择 Chat。Responses 的返回从 output 读取，Chat 的返回从 choices[].message 读取。
Base URL：通常填写 https://top.qingyuntop.ai/v1，也就是只保留一个 /v1。要求完整接口地址的客户端才追加 /responses 或 /chat/completions，不要重复追加。
流式与重试：流式响应必须按所选协议解析事件；连接中断后不要盲目重放可能已被服务端接受的生成请求。对 429 和 5xx 使用带抖动的退避，并设置连接、读取和总超时。
上线前验证：分别验证普通文本、流式文本、工具调用或结构化输出中实际用到的能力，并记录 request id、HTTP 状态、业务状态和完成原因，避免只根据 HTTP 200 判定成功。

快速判断：我应该看哪一段？

CC Switch（融合自原文档）

核心特性

🔌 Provider 管理

🛠️ MCP 服务器管理

💬 Prompts 管理

🌐 多平台支持

青云 TOP API 接入方法

配置步骤

安装方式

macOS（推荐 Homebrew）

Windows

Linux

Web 版本（无头 / SSH 服务器）

相关链接

接入检查

OpenClaw 配合 CC Switch（融合自原文档）

OpenClaw配合CC switch自定义中转站配置

第一步：安装CC switch

第二步：安装openclaw与基础初始化

第三步：检查并启动

接入检查

CC Switch 用量查询（融合自原文档）

CC Switch 通用设置（融合自原文档）

Codex App 接入（融合自原文档）

CC Switch 配置 Codex（融合自原文档）

第一步：安装 CC Switch

第二步：安装并启动 Codex

连接失败时检查 config.toml

验证是否接入成功

常见问题

CC Switch CLI（融合自原文档）

CC Switch 配置 Claude Desktop（融合自原文档）

CC Switch 配置 Claude Code（融合自原文档）

CC Switch（融合自原文档）

统一接入检查与故障排查

发布前检查