进阶：代理、统一供应商与用量统计

本页介绍 CC-Switch 中对接 ZiAI 有价值的进阶能力。只想跑通配置的话，上一页就够了。

本地代理与协议转换

这是 CC-Switch 相对「手改配置文件」最大的差异化能力，也是 ZiAI 用户最可能用到的一项。

Codex 只认 OpenAI Responses 协议，Claude Code 只认 Anthropic Messages 协议。当你要用的模型在 ZiAI 上只有 Chat Completions 通道时，直接配置必然失败。 CC-Switch 在本地起一个代理，完成双向转换：

Codex ──Responses 请求──▶ CC-Switch 本地代理 ──Chat Completions──▶ ZiAI
Codex ◀──Responses 流──  CC-Switch 本地代理 ◀──Chat SSE 流────  ZiAI

转换过程覆盖流式 SSE、推理内容与工具调用，不只是简单的请求体改写。

自动故障转移

上游渠道失败时自动切换，避免长任务因单次抖动中断。

熔断器

连续失败后暂时停止向该上游发请求，避免无谓重试拖慢速度。

端点测速

测量各 API 端点延迟，多个供应商之间挑最快的那个。

可以分别为 Claude、Codex、Gemini、Grok Build 单独配置代理，甚至精确到单个供应商 —— 不是全局开关。这意味着你可以只让 Codex 走本地转换，Claude Code 继续直连 ZiAI。

一份配置同步到多个应用，适合 ZiAI 这类多协议中转站。

操作	说明
创建	「统一供应商」Tab → 添加统一供应商 → 填名称 / API Key / 端点 → 勾选要同步的应用 → 保存
保存并同步	保存配置的同时立即同步到所有已启用应用
仅保存	只存配置，不立即同步
手动同步	在统一供应商卡片上点「同步」→ 确认 → 覆盖各应用中关联的供应商
修改	修改统一供应商后，所有关联应用配置同步更新
删除	删除统一供应商后，关联的应用配置也会删除

切换供应商时，除了密钥与地址之外的配置（插件、MCP、自定义参数等）需要跟着走，否则切一次就丢一次。

CC-Switch 用「通用配置片段」解决：

所有配置项都会保存在首次导入的默认供应商里，不会丢失。

面板	能力
MCP	一个面板管理 Claude、Codex、Gemini、Grok Build、OpenCode、Hermes 的 MCP 服务器；支持双向同步与 Deep Link 导入
Prompts	Markdown 编辑器创建预设，激活后同步到 live 文件（`CLAUDE.md` / `AGENTS.md` / `GEMINI.md`），带回填保护
Skills	从 GitHub 仓库或 ZIP 一键安装到支持的应用，支持软链接与文件复制、自定义仓库管理

对接 ZiAI 时这三项不是必需的，但如果你已经在用 MCP 工具，统一面板能省掉在多个配置文件里重复维护的麻烦。

用量仪表盘跨供应商统计：

支持把供应商数据同步到：

在多台开发机之间保持一致配置。注意同步内容包含 API 密钥，请确保所用云盘账户本身安全。

CC-Switch 支持 ccswitch:// 协议链接，点击即可导入供应商、MCP 服务器、提示词与技能：

官方提供在线生成工具用于创建 Deep Link。

设置	说明
主题	深色 / 浅色 / 跟随系统
开机自启	配合托盘快速切换使用
自动更新	版本迭代较快，建议开启
轻量模式	后台常驻时降低资源占用
关闭应用显示	用不到的工具（如 Grok Build、Hermes）可在设置里隐藏
终端选择	macOS 上可把终端设为 Otty，会话恢复、供应商终端与工具命令三处入口都可选