不可自定义供应商的客户端(cc-switch 示例)
适用于仅支持登录官方账号、无法自行修改接口地址的客户端。处理方式:通过 cc-switch 添加「自定义配置」供应商,将地址与密钥托管其中,再由 cc-switch 接管客户端。
需准备的参数
1. 选择客户端并添加供应商
打开 cc-switch,在左侧图标栏选择需配置的客户端(下文以 Codex 为例,其他客户端路径一致),点击「添加供应商」。

2. 选择「自定义配置」
在「添加供应商」页面搜索框下方点击「自定义配置」,以手动填写请求地址与密钥。

3. 填写字段并获取模型列表
- 名称:
优益AI(必填,用于在列表中识别) - 官网链接:
https://ai.youyiyun.cn - API Key:粘贴第一步复制的密钥(必填)
- API 请求地址:
https://ai.youyiyun.cn/v1(必填,需带/v1) - 点击「获取模型列表」;如失败可点击「+ 手动添加」填写模型 ID

可选字段
「备注」可留空;「子代理模型」「自动审批模型」不填写时跟随主模型,不影响首次接入。
4. 选择模型
- 在「选择模型」窗口中勾选需要使用的模型(示例为
deepseek-flash) - 点击「应用」

使用前确认单价
各模型单价不同,且可用模型会随站点更新调整。使用前请在 模型广场 核对价格。
5. 清理模型列表并保存
在「模型列表」区域删除不需要或已下架的模型,仅保留需使用的项,然后点击「添加」保存供应商。

6. 启用并重启客户端
在供应商列表中找到 优益AI,点击右侧「启用」,随后完全退出并重新打开客户端。

必须重启客户端
cc-switch 通过改写客户端配置文件生效。未重启时客户端仍使用原有地址与密钥,配置不会生效。
错误对照
| 现象 | 原因 | 处理方式 |
|---|---|---|
| 启用后仍访问官方接口 | 客户端未重启,或启用了其他供应商 | 完全退出客户端后重新打开,确认 优益AI 显示「使用中」 |
| 获取模型列表失败 | 密钥错误、地址缺少 /v1、余额不足 | 核对密钥与地址,确认钱包余额 |
| 有模型可选但请求报错 | 模型在当前分组不可用,或模型 ID 不存在 | 仅保留模型广场中确实存在的模型 ID |