快速接入 Agent

CC-Switch

CC-Switch 是 Claude Code、Codex、Gemini CLI 与 Grok Build 等多款 CLI 的服务商切换管理工具。将 Yomi API 添加为自定义服务商后，即可在不同服务商之间一键切换，无需每次手动修改环境变量或配置文件。

前置准备

已安装 Claude Code / Codex / Gemini CLI / Grok Build 中至少一款 CLI，安装步骤见本章「Claude Code 命令行」「Codex 命令行」两篇。
从 CC-Switch 官网或其开源仓库的发布页下载并完成安装。
在 Yomi API 控制台「秘钥管理」创建密钥并复制保存，密钥仅创建时可见。

配置 Yomi API

在 CC-Switch 中通过「添加服务商/供应商」类入口新建自定义服务商，Claude Code、Codex、Gemini CLI 与 Grok Build 需分别添加。

为 Claude Code 添加

名称：Yomi API（自定义名称，便于识别即可）
API 地址：https://api.yomiapi.com
API Key：YOUR_API_KEY（替换为您的密钥）

如界面提供默认模型选项，填写模型 id，如 claude-sonnet-5 或 claude-opus-4-8。

为 Codex 添加

名称：Yomi API
API 地址：https://api.yomiapi.com/v1
API Key：YOUR_API_KEY

如需填写模型，使用 gpt-5.6-sol 等模型广场中的 id。

为 Gemini 添加

名称：Yomi API
API 地址：https://api.yomiapi.com（不带 /v1，Gemini CLI 会自动拼接 /v1beta 路径）
API Key：YOUR_API_KEY

如需填写模型，以模型广场在售的 Gemini 模型 id 为准。

为 Grok Build 添加

名称：Yomi API
API 地址：https://api.yomiapi.com/v1（带 /v1，Grok Build 走 OpenAI 兼容格式）
API Key：YOUR_API_KEY

如需填写模型，使用 grok-4.6 等模型广场中的 id。

四个场景的 API 地址不同：Claude Code 与 Gemini 走原生格式，填 https://api.yomiapi.com（不带 /v1）；Codex 与 Grok Build 走 OpenAI 兼容格式，填 https://api.yomiapi.com/v1（带 /v1）。填反会导致请求失败。

CC-Switch 添加服务商入口 — CC-Switch 主界面：顶部选择 Claude Code 标签，点击右上角「+」添加服务商。

开始使用与验证

在 CC-Switch 中将当前服务商切换为 Yomi API。
重新打开终端，或重启正在运行的 Claude Code / Codex 会话，使新配置生效。
运行 claude / codex / gemini / grok 对应命令，发送一条测试指令，正常返回即接入成功。
可在 Yomi API 控制台用户中心「用量统计」中确认调用记录，说明请求已经由平台处理。

常见问题

切换后不生效，仍连原服务商

切换只对新启动的会话生效。请关闭并重新打开终端，再启动 Claude Code / Codex；同时确认 CC-Switch 中当前选中的确实是 Yomi API。

返回 401 认证失败

API Key 填写有误、复制时带入了多余空格，或密钥已被删除。到「秘钥管理」核对后，在 CC-Switch 中更新对应服务商的密钥。

提示模型不可用

模型名需使用模型广场中的 id（如 claude-sonnet-5、gpt-5.6-sol），不要填显示名；另请确认密钥所属分组包含该模型。

导入时报 Invalid provider app type: 'grokbuild'

Grok Build 需要 CC-Switch v3.18.0（2026-07-17）及以上版本才支持，请升级 CC-Switch 后重试。