CC-Switch 配置教程(图文)
用 CC Switch 把 apizt 接入 Claude Code、Codex、OpenCode 等工具。按下面四步操作即可。
1. 下载并安装
打开官方下载页,选择适合你电脑的安装包。
不确定下载哪个?查看安装方法
- Windows 下载与你的电脑架构对应的
.msi安装包,双击安装。可在「设置 → 系统 → 系统信息」查看系统类型。 - macOS 打开
.dmg,把 CC Switch 拖到「应用程序」。 - Linux 按系统和架构选择
.AppImage、.deb或.rpm。
2. 准备 API Key
API Key 是工具连接 apizt 用的密钥。已经有 Key?直接去选工具。
查看创建 API Key 的图文步骤。复制自己的 Key,留到下一步填写。
3. 选一个工具,跟着图配置
点你正在用的工具,按该节的 6 步完成配置。先安装目标工具,复制自己的 API Key。点击图片可以放大。
先看工具用哪种连接方式
在 CC Switch 的工具页面顶部,「路由」会让请求经过本机的 CC Switch,再转给 apizt。「直连」让工具直接请求供应商。按本页的配置选择对应方式。
- 需要开启路由 Claude Code(终端版)、Claude(桌面版)、Codex、Grok Build。桌面版用模型映射,启用后要完全退出并重新打开 Claude。
- 选择直连 Gemini CLI 使用 Gemini 原生接口,在「直连」里切换到 apizt。
- 写入客户端配置 OpenCode、OpenClaw、Hermes、Pi、MiniMax Code、Kimi Code、DeepSeek Harness、Oh My Pi。按对应小节添加或启用。
- 从供应商打开终端 Antigravity 在 apizt 卡片上启动
agy。
路由怎么开、怎么停?
在左侧选择工具,打开顶部「路由」页签,点击「开始路由」。在「路由到」里选择 apizt,再点一次「开始路由」确认。看到「路由生效中」后,保持 CC Switch 运行,再重开对应工具。

要停止这个工具的路由,在它的「路由」页点「回到直连」。CC Switch 官方路由说明
找不到工具?查看 CC Switch 侧栏
Claude Code(终端版)
- 添加供应商
打开 CC Switch,在左侧选择Claude Code,点击添加供应商,选择自定义配置。
- 填写连接信息
- 名称填
apizt,API Key 填自己的令牌,请求地址填https://api.apizt.com/v1,完整 URL 关闭。 - 展开高级选项,上游格式选 OpenAI Chat Completions(需开启路由),认证字段使用默认
ANTHROPIC_AUTH_TOKEN。

Claude Code(终端版):Chat 上游地址填写 https://api.apizt.com/v1。 - 名称填
- 设置模型
- 按下表分别填写 Sonnet、Opus、Fable、Haiku 的实际请求模型 ID,并将同一行的显示名称填写为完全相同的 ID,1M 关闭。Subagent 与默认兜底模型按需选择可用模型;本例均填
claude-sonnet-5-5,这两个字段没有独立显示名称。
模型档位 实际请求模型 ID 显示名称 Sonnet claude-sonnet-5-5claude-sonnet-5-5Opus claude-opus-5-5claude-opus-5-5Fable claude-fable-5-1claude-fable-5-1Haiku claude-haiku-5-5claude-haiku-5-5上表为 apizt 当前模型 ID 示例;换用其他版本时,从 模型价格页复制令牌可用的完整 ID,并同步填写同一行的显示名称。

选择 Chat 格式,各档位填写对应实际模型 ID;显示名称与同一行模型 ID 一致。 - 按下表分别填写 Sonnet、Opus、Fable、Haiku 的实际请求模型 ID,并将同一行的显示名称填写为完全相同的 ID,1M 关闭。Subagent 与默认兜底模型按需选择可用模型;本例均填
- 保存供应商
在表单底部点击添加。返回 Claude Code 供应商列表后,确认出现
apizt卡片。 - 启用并打开工具
本节使用路由模式。
在 Claude Code 页顶部打开路由,点击开始路由。在确认框的路由到里选择 apizt,再点开始路由。如果路由已开启,在 apizt 卡片上点击路由到此。
确认顶部显示路由生效中且目标是 apizt。保持 CC Switch 运行,退出旧的 Claude Code 会话,在终端重新运行
claude。
Claude Code(终端版) 的路由标签用于查看列表,点击“开始路由”并确认才会接管该工具。 在「路由」页点「开始路由」,在确认框选择 apizt。 - 发送消息验证
在 Claude Code 新会话中选一个已配置的模型,发送「请只回复 OK」。看到回复后,在apizt 使用日志按发送时间和令牌核对本次请求及实际模型。
查看配置细节与排错
路由接管后,Claude Code 使用本地根地址,例如 http://127.0.0.1:15721;供应商上游仍是 apizt 的 /v1 地址。端口以本机设置为准,清理会覆盖本地地址的旧环境变量。鉴权与模型权限排错。
Claude(桌面版)
- 添加供应商
打开 CC Switch,在左侧选择Claude Desktop,点击添加供应商,选择自定义配置。
- 填写连接信息
- 名称填
apizt,API Key 填自己的令牌,请求地址填https://api.apizt.com/v1。 - 在模型配置 → 接入方式中选模型映射,上游格式选 OpenAI Chat Completions(需开启路由)。

Claude(桌面版):地址带 /v1,接入方式为模型映射,上游选择 Chat。 - 名称填
- 设置模型
- 按下表分别填写 Sonnet、Opus、Fable、Haiku 四档的实际请求模型 ID,菜单显示名复制同一行的完整模型 ID,1M 关闭。
模型档位 实际请求模型 ID 显示名称 Sonnet claude-sonnet-5-5claude-sonnet-5-5Opus claude-opus-5-5claude-opus-5-5Fable claude-fable-5-1claude-fable-5-1Haiku claude-haiku-5-5claude-haiku-5-5上表为 apizt 当前模型 ID 示例;换用其他版本时,从 模型价格页复制令牌可用的完整 ID,并同步填写同一行的显示名称。

Sonnet、Opus、Fable、Haiku 分别填写对应模型 ID,菜单显示名与各自 ID 一致,1M 关闭。 - 保存供应商
在表单底部点击添加。返回 Claude Desktop 供应商列表后,确认出现
apizt卡片。 - 启用并打开工具
本节使用模型映射与本地路由。
在 apizt 卡片上点击切换,确认卡片显示使用中。如果提示需要路由,点击「开始路由并使用它」确认。模型映射通过本地路由转发。确认页面顶部的路由服务显示运行中,若启动失败可点重试,端口被占用时可点更改端口。
保持 CC Switch 运行,完全退出并重新打开 Claude Desktop。在新对话的模型菜单里选择已配置的模型。
在 apizt 卡片上点「切换」。如果出现路由提示,按界面确认后重新打开 Claude。 - 发送消息验证
在 Claude Desktop 新对话发送「请只回复 OK」。看到回复后,在apizt 使用日志按发送时间和令牌核对本次请求及映射后的实际模型。
查看配置细节与排错
模型映射至少填写一个实际请求模型,空档会沿用第一条已填模型,Sonnet 优先。桌面客户端连接本地 /claude-desktop 网关;终端版的环境变量不能代替桌面供应商配置。
Codex
- 添加供应商
打开 CC Switch,在左侧选择Codex,点击添加供应商,选择自定义配置。
- 填写连接信息
- 名称填
apizt,API Key 填自己的令牌,API 请求地址填https://api.apizt.com/v1,完整 URL 关闭。 - 展开「高级选项」,上游格式选 Chat Completions(需开启路由)。生成配置中的
wire_api保持"responses"。

Codex:请求地址带 /v1,默认模型 gpt-6-sol,上游为 Chat Completions。 - 名称填
- 设置模型
- 在「默认模型」填当前令牌可用的模型 ID,例如
gpt-6-sol。
示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。
- 在「默认模型」填当前令牌可用的模型 ID,例如
- 保存供应商
在表单底部点击添加。返回 Codex 供应商列表后,确认出现
apizt卡片。 - 启用并打开工具
本节使用路由模式。
在 Codex 页顶部打开路由,点击开始路由。在确认框的路由到里选择 apizt,再点开始路由。如果路由已开启,在 apizt 卡片上点击路由到此。
确认顶部显示路由生效中且目标是 apizt。保持 CC Switch 运行。CLI 用户退出旧进程后重新运行
codex,桌面用户完全退出 Codex 后重新打开。要让第三方模型出现在/model列表里,先在 apizt 供应商表单里填写模型映射并保存,再重启 Codex。在「路由」页点「开始路由」,在确认框选择 apizt。 - 发送消息验证
在 Codex 新会话中使用上面配置的默认模型,发送「请只回复 OK」。看到回复后,在apizt 使用日志按发送时间和令牌核对本次请求及实际模型。
查看配置细节与排错
核对生成配置:model_provider 与 [model_providers.xxx] 名称一致,模型为 gpt-6-sol。wire_api 始终保持 "responses"。

接管后 Codex 使用本地 /v1 地址,例如 http://127.0.0.1:15721/v1。PROXY_MANAGED 是路由管理的占位凭据,真实上游 Key 由 CC Switch 保存并注入。端口以本机设置为准。Codex 配置排错。
Gemini CLI
- 添加供应商
打开 CC Switch,在左侧选择Gemini CLI,点击添加供应商,选择自定义配置。
- 填写连接信息
- 名称填
apizt,API Key 填自己的令牌,请求地址填根地址https://api.apizt.com。

Gemini CLI:填写根地址和可用的 Gemini 原生模型,模型占位值需替换。 - 名称填
- 设置模型
- 模型填当前令牌可用的 Gemini 原生模型 ID。截图中的
YOUR_AVAILABLE_GEMINI_MODEL_ID是占位值,保存前替换为真实模型 ID。
- 模型填当前令牌可用的 Gemini 原生模型 ID。截图中的
- 保存供应商
在表单底部点击添加。返回 Gemini CLI 供应商列表后,确认出现
apizt卡片。 - 启用并打开工具
本节使用直连模式。
在 Gemini CLI 页打开直连,点击 apizt 卡片上的切换。如果本机正用路由,先按页面提示回到直连,再切换到 apizt。退出正在运行的 Gemini CLI,在终端重新运行
gemini,让客户端读取新的 Key、地址和模型。在「直连」页找到 apizt 卡片,点「切换」。 - 发送消息验证
在 Gemini CLI 新会话发送「请只回复 OK」。看到回复后,在apizt 使用日志按发送时间和令牌核对本次请求,确认实际模型是所填的 Gemini 模型。
查看配置细节与排错
表单没有 Chat 格式下拉。客户端在根地址后构造 /v1beta/models/模型ID:generateContent;本节方案无需 CC Switch 协议转换或本地路由。切换后检查 ~/.gemini/.env 中的 GEMINI_API_KEY、GOOGLE_GEMINI_BASE_URL、GEMINI_MODEL,以及 settings.json 的认证与模型设置。
Grok Build
- 添加供应商
打开 CC Switch,在左侧选择Grok Build,点击添加供应商,选择自定义配置。
- 填写连接信息
- 名称填
apizt,API Key 填自己的令牌,请求地址填https://api.apizt.com/v1。 - 展开「高级选项」,上游格式选 Chat Completions(需开启路由)。

Grok Build:Chat 上游地址带 /v1,后续使用需要启用该应用的本地路由。 - 名称填
- 设置模型
- 填写当前令牌可用的模型 ID,例如
gpt-6-sol。上下文窗口按模型实际支持的容量填写。
示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。
- 填写当前令牌可用的模型 ID,例如
- 保存供应商
在表单底部点击添加。返回 Grok Build 供应商列表后,确认出现
apizt卡片。 - 启用并打开工具
本节使用路由模式。
在 Grok Build 页顶部打开路由,点击开始路由。在确认框的路由到里选择 apizt,再点开始路由。如果路由已开启,在 apizt 卡片上点击路由到此。
确认顶部显示路由生效中且目标是 apizt。保持 CC Switch 运行,退出旧的 Grok Build 会话,在终端重新运行
grok。在「路由」页点「开始路由」,在确认框选择 apizt。 - 发送消息验证
在 Grok Build 新会话中使用所配模型,发送「请只回复 OK」。看到回复后,在apizt 使用日志按发送时间和令牌核对本次请求及实际模型。
查看配置细节与排错
Grok Build 的客户端 api_backend 保持 responses。CC Switch 管理 ~/.grok/config.toml 的 models.default 与对应模型表,由本地路由完成 Chat 转换;表单预填的上下文值不代表模型的实际能力。
OpenCode
- 添加供应商
打开 CC Switch,在左侧选择OpenCode,点击添加供应商,选择自定义配置。
- 填写连接信息
- 供应商标识填
apizt,名称填apizt。 - 接口格式选 OpenAI Compatible,API Key 填自己的令牌,Base URL 填
https://api.apizt.com/v1。

OpenCode:接口格式选 OpenAI Compatible,供应商标识 apizt。 - 供应商标识填
- 设置模型
- 找到模型区,点击「手动添加」新增一行。
- 添加模型:ID 填
gpt-6-sol,显示名称填gpt-6-sol。
示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。
- 保存供应商
在表单底部点添加,回到 OpenCode 的供应商列表,确认出现 apizt 卡片。
- 启用并打开工具
本节直接写入客户端配置。
如果卡片在「可添加」,点卡片上的添加,确认移到「已添加」。重新打开 OpenCode。终端版运行
opencode,输入/new新建会话,再输入/models,选择apizt/gpt-6-sol。桌面版新建会话后,用模型选择器选 apizt 下的同一模型。若填写了其他模型 ID,请选择实际填写的模型。在「可添加」里点 apizt 右侧的「添加」,再打开 OpenCode 选模型。 - 发送消息验证
发送「请只回复 OK」。收到回复后,到 apizt 使用日志核对这次请求的时间和模型 ID。
查看配置细节与排错
配置写入 ~/.config/opencode/opencode.json,已有 opencode.jsonc 时优先使用它;供应商使用 @ai-sdk/openai-compatible。新增供应商不会替你修改全局默认模型,需在 OpenCode 中选择模型。本节直接调用 Chat 接口,无需 CC Switch 本地路由。
OpenClaw
- 添加供应商
打开 CC Switch,在左侧选择OpenClaw,点击添加供应商,选择自定义配置。
- 填写连接信息
- 供应商标识填
apizt,名称填apizt。 - API 协议选 OpenAI Completions,API 端点填
https://api.apizt.com/v1,API Key 填自己的令牌。

OpenClaw:API 协议选 OpenAI Completions,端点带 /v1。 - 供应商标识填
- 设置模型
- 添加模型:ID 填
gpt-6-sol,显示名称填gpt-6-sol。
示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。
- 添加模型:ID 填
- 保存供应商
在表单底部点添加,确认 OpenClaw 的供应商列表出现 apizt 卡片。
- 启用并打开工具
本节直接写入客户端配置。
如果卡片在「可添加」,先点添加。在「已添加」的 apizt 卡片右侧点更多(⋯)→ 设为默认。如果展开模型列表,选
gpt-6-sol或你实际填写的模型。确认卡片显示「默认」。打开 OpenClaw 并新建会话。已启动 Gateway 时,也可运行
openclaw tui进入终端界面。在 apizt 卡片的「更多」菜单中选择「设为默认」。 - 发送消息验证
在 OpenClaw 新会话发送「请只回复 OK」。看到回复后,打开apizt 使用日志,核对请求时间、模型 ID 和成功状态。
查看配置细节与排错
新增写入 ~/.openclaw/openclaw.json 的 models.providers.apizt。设为默认后,默认模型为 apizt/gpt-6-sol,对应 agents.defaults.model.primary。本节使用原生 Chat 兼容协议,无需 CC Switch 本地路由。
Hermes
- 添加供应商
打开 CC Switch,在左侧选择Hermes,点击添加供应商,选择自定义配置。
- 填写连接信息
- 供应商标识填
apizt,名称填apizt。 - API 模式选 OpenAI Chat Completions,API 端点填
https://api.apizt.com/v1,API Key 填自己的令牌。

Hermes:API 模式选 OpenAI Chat Completions,第一项模型为 gpt-6-sol。 - 供应商标识填
- 设置模型
- 模型列表第一项的 ID 填
gpt-6-sol,显示名称填gpt-6-sol。
示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。
- 模型列表第一项的 ID 填
- 保存供应商
在表单底部点添加,确认 Hermes 的供应商列表出现 apizt 卡片。
- 启用并打开工具
本节直接写入客户端配置。
如果卡片在「可添加」,先点添加。在「已添加」的 apizt 卡片右侧点更多(⋯)→ 设为默认,确认卡片显示「默认」。Hermes 会使用配置中排在第一位的模型。
在终端运行
hermes chat,输入/new新建会话。图中 apizt 卡片已显示「默认」。如未设为默认,从卡片的「更多」菜单选择「设为默认」。 - 发送消息验证
在 Hermes 新会话发送「请只回复 OK」。看到回复后,打开apizt 使用日志,核对请求时间、模型 ID 和成功状态。
查看配置细节与排错
配置写入 ~/.hermes/config.yaml 的 custom_providers。切换为默认供应商后,检查 model.provider = apizt 与 model.default = gpt-6-sol。显示名称仅用于界面。本节直接使用 Chat 接口,无需 CC Switch 本地路由。
Pi
- 添加供应商
打开 CC Switch,在左侧选择Pi,点击添加供应商,选择自定义配置。
- 填写连接信息
- 供应商标识填
apizt,名称填apizt;新增时设置标识,编辑时不可更改。 - 接口格式选 OpenAI Chat Completions,API Key 填自己的令牌,Base URL 填
https://api.apizt.com/v1。

Pi:供应商标识 apizt,接口格式 OpenAI Chat Completions,显示名称 gpt-6-sol。 - 供应商标识填
- 设置模型
- 找到模型区,点击「添加模型」新增一行。
- 至少添加一个模型,ID 填
gpt-6-sol,显示名称填gpt-6-sol。
示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。
- 保存供应商
在表单底部点添加,确认 Pi 的供应商列表出现 apizt 卡片。
- 启用并打开工具
本节直接写入客户端配置。
如果卡片在「可添加」,点卡片上的启用,确认移到「已添加」。在终端重新运行
pi开始新会话,输入/model,选择 apizt 下的gpt-6-sol或你实际填写的模型。在「可添加」里点 apizt 右侧的「启用」,再打开 Pi 选模型。 - 发送消息验证
在新会话里发送「请只回复 OK」。收到回复后,到 apizt 使用日志核对请求时间和模型 ID。
查看配置细节与排错
配置写入 ~/.pi/agent/models.json 的 providers.apizt。若已有卡片尚未加入客户端配置,可点击卡片的启用后再在 Pi 中选模型。CC Switch 不修改 Pi 的 defaultProvider 或 defaultModel,本节无需本地路由。
MiniMax Code
- 添加供应商
打开 CC Switch,在左侧选择MiniMax Code,点击添加供应商,选择自定义配置。
- 填写连接信息
- 供应商标识填
apizt,名称填apizt。 - 接口格式选 OpenAI Chat Completions,API Key 填自己的令牌,Base URL 填
https://api.apizt.com/v1。

MiniMax Code:接口格式选 OpenAI Chat Completions,Base URL 填 https://api.apizt.com/v1。 - 供应商标识填
- 设置模型
- 找到模型区,点击「手动添加」新增一行。
- 在模型列表添加
gpt-6-sol,显示名称填gpt-6-sol。

MiniMax Code 模型配置:模型 ID 与显示名称都填 gpt-6-sol。 示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。
- 保存供应商
在表单底部点添加,确认 MiniMax Code 的供应商列表出现 apizt 卡片。
- 启用并打开工具
本节直接写入客户端配置。
如果卡片在「可添加」,点卡片上的添加,确认移到「已添加」。重新运行
mcode开启新会话,在会话中输入/provider,选择 apizt 下的gpt-6-sol或你实际填写的模型。在「可添加」里点 apizt 右侧的「添加」,再打开 MiniMax Code 选模型。 - 发送消息验证
发送「请只回复 OK」。收到回复后,到 apizt 使用日志核对请求时间和模型 ID。
查看配置细节与排错
新增写入 ~/.minimax/config.yaml 的 custom_provider.apizt,不会替你修改 defaultModel 或 defaultLightModel。本节使用原生 Chat 接口,无需 CC Switch 本地路由。
Kimi Code
- 添加供应商
打开 CC Switch,在左侧选择 Kimi Code,点击添加供应商,选择自定义配置。
- 填写连接信息
- 供应商标识填
apizt,名称填apizt。 - 接口格式选 OpenAI Chat Completions,Base URL 填
https://api.apizt.com/v1,API Key 填自己的令牌。
- 供应商标识填
- 设置模型
- 找到模型区,点击「手动添加」新增一行。
- 添加一个当前令牌可调用的模型。模型 ID 可参考
gpt-6.1-sol,显示名称填同一个 ID。 - 展开模型这一行,在「上下文长度」填写该模型支持的实际值。
填写 Chat 接口和模型。上下文长度按所选模型填写。 示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。
- 保存供应商
点表单底部的添加,回到供应商列表,确认出现 apizt 卡片。
- 启用并打开工具
本节直接写入客户端配置。
如果 apizt 卡片还显示添加,点一次,确认它进入已添加。退出旧的 Kimi Code 会话,在终端运行
kimi。输入/model,选中apizt分组里刚添加的模型。在「可添加」里点 apizt 右侧的「添加」,再打开 Kimi Code 选模型。 - 发送消息验证
在这个 Kimi Code 会话里发送「请只回复 OK」。收到回复后,在apizt 使用日志中核对刚才的请求时间、模型和成功状态。
DeepSeek Harness
- 添加供应商
打开 CC Switch,在左侧选择 DeepSeek Harness,点击添加供应商,选择自定义配置。
- 填写连接信息
- 供应商标识填
apizt,名称填apizt。 - 接口格式选 OpenAI Chat Completions,Base URL 填
https://api.apizt.com/v1,API Key 填自己的令牌。
- 供应商标识填
- 设置模型
- 找到模型区,点击「手动添加」新增一行。
- 添加一个当前令牌可调用的模型。模型 ID 可参考
gpt-6.1-sol,显示名称填同一个 ID。
接口格式选择 OpenAI Chat Completions,Base URL 带 /v1。 示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。
- 保存供应商
点表单底部的添加,回到供应商列表,确认出现 apizt 卡片。
- 启用并打开工具
本节直接写入客户端配置。
如果 apizt 卡片还显示添加,点一次,确认它进入已添加。重新打开 DeepSeek Harness 桌面端,或在终端运行
dsh web打开网页界面。在模型选择器里选中 apizt 下刚添加的模型。在「可添加」里点 apizt 右侧的「添加」,再打开 DeepSeek Harness 选模型。 - 发送消息验证
在 DeepSeek Harness 新建会话,确认仍选中刚才的模型,发送「请只回复 OK」。收到回复后,在apizt 使用日志中核对请求时间、模型和成功状态。
查看配置细节与排错
如果使用网页界面,可以运行 dsh web 打开。查看 DeepSeek Harness 官方配置说明。
Antigravity
- 添加供应商
打开 CC Switch,在左侧选择 Antigravity,点击添加供应商,选择自定义配置。
- 填写连接信息
- 名称填
apizt,API Key 填自己的令牌。 - 请求地址填根地址
https://api.apizt.com,不带/v1。
- 名称填
- 设置模型
- 点「获取模型列表」选择 Antigravity CLI 支持的 Gemini 模型显示名称,并确认当前 API Key 可调用该模型。
Antigravity 使用根地址,模型填写 Gemini 模型显示名称。 - 保存供应商
点表单底部的添加,回到 Antigravity 供应商列表,确认出现 apizt 卡片。
- 启用并打开工具
本节使用供应商专用终端。
在 apizt 卡片上点终端图标使用此供应商打开终端。如果弹出目录选择,选好工作目录,再点打开终端。等新终端中的
agy会话启动。在 apizt 卡片上点「使用此供应商打开终端」。 - 发送消息验证
在刚打开的
agy会话里发送「请只回复 OK」。收到回复后,在apizt 使用日志中核对刚才的请求时间、Gemini 模型和成功状态。
查看配置细节与排错
请求地址和 Key 仅传给这次打开的终端会话。
Oh My Pi
- 添加供应商
打开 CC Switch,在左侧选择 Oh My Pi,点击添加供应商,选择自定义配置。
- 填写连接信息
- 供应商标识填
apizt,名称填apizt。 - 接口格式选 OpenAI Chat Completions,Base URL 填
https://api.apizt.com/v1,API Key 填自己的令牌。
- 供应商标识填
- 设置模型
- 找到模型区,点击「添加模型」新增一行。
- 添加一个当前令牌可调用的模型。模型 ID 可参考
gpt-6.1-sol,显示名称填相同的 ID。 - 手动添加模型时,展开该行,按模型实际能力填写「上下文长度」和「最大输出 Token 数」。
选择 OpenAI Chat Completions,添加一个当前令牌可调用的模型。 示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。
- 保存供应商
点表单底部的添加,回到供应商列表,确认出现 apizt 卡片。
- 启用并打开工具
本节直接写入客户端配置。
如果 apizt 卡片还显示启用,点一次,确认它进入已添加。在终端运行
omp,输入/model,选中apizt下刚添加的模型。在「可添加」里点 apizt 右侧的「启用」,再打开 Oh My Pi 选模型。 - 发送消息验证
在这个 Oh My Pi 会话里发送「请只回复 OK」。收到回复后,在apizt 使用日志中核对刚才的请求时间、模型和成功状态。
4. 发一条消息测试
打开刚配置好的工具,发送一条短消息。回到 apizt 控制台,核对使用记录里的时间、模型和状态。
使用遇到问题?查看排错和参考资料
- 出现 401 或 403 时,检查 API Key 和令牌的模型权限。
- 出现 404 或协议错误时,核对对应工具章节中的请求地址和接口格式。
- 使用路由的工具需要保持 CC Switch 和本地服务运行。切换供应商后可重新打开工具再试。