Skip to content

CC-Switch 配置​

如果你需要在 Codex、Claude Code 等 CLI 工具之间频繁切换模型或 API Key,推荐使用 CC-Switch 统一管理配置。它可以减少手动编辑配置文件的次数,并帮助你快速切换不同的 provider。

推荐使用 CC-Switch

建议先安装 CC-Switch,再按照本页准备 yuyuflow 的 Base URL、API Key 和模型名。完成配置后,可直接前往 Codex 配置 或 Claude Code 配置。

获取 CC-Switch​

请前往 CC-Switch GitHub 仓库 查看最新版本、支持的平台和安装方式。下载前请确认版本与当前操作系统匹配,并以项目发布页的说明为准。

安全提醒

CC-Switch 会管理 API Key 等敏感配置。请只从官方仓库或正式发布页下载,不要把密钥写入公开仓库、截图、日志或第三方分享文件。

准备平台配置​

在 控制台 准备以下信息:

配置项填写内容
Provider 名称例如 yuyuflow 或 platform
Base URLhttps://art-api.yuyuflow.com,按客户端要求补充 /v1
API Key控制台创建的专用 API Key
默认模型控制台中当前可用的完整模型名

如果客户端已经自动添加版本路径,请不要重复添加 /v1。具体地址以控制台和 CC-Switch 当前版本的配置界面为准。

推荐配置流程​

  1. 安装并打开 CC-Switch。
  2. 新建一个 provider,例如 yuyuflow。
  3. 填写平台 Base URL、API Key 和默认模型。
  4. 保存后将该 provider 切换为当前使用配置。
  5. 用一个简单请求验证鉴权、模型名称和网络连接。
  6. 再开始使用 Codex 或 Claude Code。

验证配置​

可以先用 cURL 验证 API Key 和模型名:

bash
curl -X POST "https://art-api.yuyuflow.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "messages": [{"role": "user", "content": "请返回 pong"}]
  }'

验证成功后:

常见问题​

切换后仍然使用旧配置

关闭正在运行的 CLI 工具后重新打开,并确认 CC-Switch 中当前选中的 provider 与实际配置文件一致。

请求鉴权失败

先检查 API Key 是否过期、令牌分组是否有目标模型权限,再用本页 cURL 示例验证 Base URL 和请求头。

不知道该填写哪个模型

请在控制台查看当前可用模型的完整模型 ID,不要直接使用模型展示名称、供应商名称或自定义备注。