> ## Documentation Index
> Fetch the complete documentation index at: https://crypto-serve.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CC Switch 接入与协议选择

> 用 CC Switch 管理客户端配置，并区分不同接口协议的适用条件。

# CC Switch 接入与协议选择

CC Switch 用于管理和切换 AI 客户端的供应商配置。安装入口：[CC Switch 官方发布页](https://github.com/farion1231/cc-switch/releases)。

使用前先准备[创建好的 API 密钥](https://crypto-serve.mintlify.site/zhang-hao-shi-yong-jiao-cheng-mao-li-she-qu/cryptoserveai/api-keys.md)，从[模型广场](https://crypto-serve.mintlify.site/zhang-hao-shi-yong-jiao-cheng-mao-li-she-qu/cryptoserveai/model-market.md)复制当前模型 ID，并确认目标应用所需的接口协议。

**本页提供配置流程和接入条件。CryptoServeAI 的 Claude Code、Codex、Gemini CLI 三条路径尚未逐一完成实测，请先确认所选模型与接口兼容，再启用新配置。** 普通文本对话可以先使用 [Cherry Studio](https://crypto-serve.mintlify.site/zhang-hao-shi-yong-jiao-cheng-mao-li-she-qu/cryptoserveai/cherry-studio.md)。

## 添加 CryptoServeAI

1. 先保留当前可用的供应商配置，记录原先启用的是哪一个。
2. 在 CC Switch 中选择目标应用，再点击新增供应商。
3. 使用自定义配置，名称填写 CryptoServeAI；网站地址填写 `https://api.cryptoserve.io`。
4. 填入为该应用创建的独立 API 密钥。
5. 根据目标应用的协议填写 API 地址和模型 ID。网站地址只是控制台入口，不能代替 API 配置。
6. 保存后检查配置，确认兼容条件满足再切换启用。

## 不同应用需要确认什么？

| 应用 | 接入前确认 |
| - | - |
| Claude Code | 使用 Anthropic Messages 原生兼容接口，还是经 CC Switch 本地代理转换 |
| Codex | 模型和平台是否支持该客户端要求的 Responses 接口与工具调用 |
| Gemini CLI | 是否支持 Gemini 协议，不能仅凭模型名称中含 Gemini 判断 |

拿到聊天补全接口的回复，并不等于编程客户端的工具调用也兼容。

## Claude Code 使用 OpenAI 兼容模型时

CC Switch 的 Claude 供应商高级设置可选择 OpenAI Chat Completions 等格式。按官方说明，非 Anthropic 格式需要启动本地代理并启用应用接管，才能转换请求与回复。

如果所用版本按根地址拼接 `/v1/chat/completions`，对应根地址为 `https://api.cryptoserve.io`；启用“完整 URL 模式”时才填写完整端点。不要把两种地址模式混用。此配置仍以模型支持所需工具能力为前提。

## 测试与恢复

切换后重新打开目标客户端，先在不含重要文件的测试目录中发送简单问题，不授权修改正式项目。再检查平台是否出现对应模型与密钥的[调用记录](https://crypto-serve.mintlify.site/zhang-hao-shi-yong-jiao-cheng-mao-li-she-qu/cryptoserveai/usage-logs.md)。

若失败，记录完整错误、客户端版本、模型 ID 与请求路径，切回原供应商。使用过本地代理接管时，按 CC Switch 的恢复操作解除接管，再重新打开客户端。不要通过删除整个客户端配置目录来排错。

参考：[添加供应商](https://github.com/farion1231/cc-switch-website/blob/main/public/docs/zh/2-providers/2.1-add.md) · [切换供应商](https://github.com/farion1231/cc-switch-website/blob/main/public/docs/en/2-providers/2.2-switch.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.