一个为所有人的API使用指南
返回官网 ↗
使用指南工具接入教程

CC Switch

CC Switch 是配置管理工具,不是负责回答你的 AI。选好它要管理的客户端后,把平台信息写进去,再启动对应 Agent。

开始前,把三样信息放在手边

已经装好工具即可继续。打开官网「自助服务」,登录后创建或查看自己的 API 密钥,并复制页面提供的 API 地址;从「模型与价格」复制完整模型 ID。别把官网首页、登录密码或模型的宣传名称填进去。确认账户和密钥都有可用额度。

下面的 API_HOST、YOUR_API_KEY、YOUR_MODEL_ID 都是占位文字,使用前逐个换成你的实际信息。地址里 /v1 是否保留,要看本篇要求;不要追加 /chat/completions 或 /responses。示例不会自动连接,也不会自动带入你的密钥。

1. 先选要管理哪个工具

在 CC Switch 左侧选「Codex」或「Claude Code」,再点右上角「+ / 添加供应商」。这两个标签会写入不同工具的配置,不能混用。下面按你的客户端选一条分支即可。

2. 添加自定义供应商

选自定义配置,名称可叫 My API;API Key 填自己的平台密钥。不要选其他 API 平台的预设后保留它的地址,否则请求会发错地方。保存前检查当前目标客户端。

3. Codex 分支:使用 Responses

选择 Responses 对应格式,Base URL 填 https://API_HOST/v1,模型填平台支持 Responses 的真实 ID。配置预览里确认 wire_api = "responses";思考强度只选该模型支持的值。若表单没有对应字段,查看工具提供的配置预览。

字段示意 · 非软件截图
Codex
Responses · https://API_HOST/v1
Claude Code
Messages · https://API_HOST
API Key
YOUR_API_KEY
Provider name
My API

4. Claude Code 分支:使用 Messages

API 格式选 Anthropic Messages,地址填平台提供的 Messages 根地址,本例是 https://API_HOST,凭证字段采用 ANTHROPIC_AUTH_TOKEN。模型映射里的 Sonnet/Opus/Haiku 是客户端的用途档位,不是凭空出现的模型;仅映射到你有权限且确认兼容的真实模型。

5. 启用并验证,别停在保存

保存后在该供应商卡片点击「启用」,确认成为当前配置;然后重新打开对应客户端或终端。初次接入先走直接连接,不必开启本地路由或聚合。接下来在实际的 Codex 或 Claude Code 内完成下面两项测试,CC Switch 卡片显示启用不等于模型请求成功。

验证一:收到第一条回复

新建一个空的测试文件夹,在工具中选择它作为工作区,再新开一个会话。确认当前选中的是刚添加的提供方和模型,发送下面这句话。收到正常回复且没有错误,才说明基本连接成功;它不能证明所有工具都已接通。测试会产生正常的 API 用量。

请只回复:连接成功。

预期:工具显示模型回复「连接成功」。若是登录页、报错或一直转圈,先查看下方排查表,不要反复发送。

验证二:让它实际读取一个文件

在刚才的测试文件夹里,用文本编辑器新建 hello.txt,内容写「API connection test 27」。保存后发送下面的要求;出现读取权限提示时,只允许访问这个测试文件夹。

请使用文件读取工具打开当前工作区的 hello.txt,告诉我文件内容,不要修改任何文件。

预期:能看到读取 hello.txt 的工具执行记录,回答包含 API connection test 27。只有一段口头回复、没有读取记录,不算工具调用验证成功。确认结束后,可以自行删除这个测试文件夹。

遇到问题,先按现象检查

401 / Invalid API key

确认地址和密钥来自同一个平台,密钥完整、未过期或被禁用。不要把完整密钥发给客服。

404 / model not found

先核对地址是否多写或少写 /v1,再核对模型 ID 和协议;模型列表可见也不代表所有协议都能使用。

429 / quota / balance

查看账户余额、密钥额度和请求频率,按错误提示处理;提高思考强度不能解决额度问题。

能聊天,不能读文件

确认模型支持工具调用、软件给了工作区读取权限,且工具执行过程没有报错。

没有思考强度选项

先检查模型能力声明,再检查当前模型与客户端版本是否支持可调档位。模型支持思考,不一定支持多个强度。

官方说明与适用范围

配置说明核对于 2026-11-08。工具更新后菜单可能变化,以下官方资料可用于核对;教程中的 API 信息始终以本平台当前提供的内容为准。