快速开始

在 xhyapi 控制台的 API Key 列表中，可以选择一键导入到 CC Switch（CCS），也可以查看完整配置后手动接入。

方法一：导入到 CCS

适合已经安装 CCS 的用户。尚未安装时，请前往 CC Switch 官方下载页，选择对应系统的安装包。

1. 登录控制台，打开 API Key 页面。
2. 找到需要使用的 API Key。
3. 点击操作栏中的“导入到 CCS”。
4. 按 CCS 的提示确认导入，然后在 CCS 中启用对应配置。

方法二：使用密钥手动配置

需要自己管理配置文件时：

1. 在 API Key 列表中点击“使用密钥”。
2. 在弹窗中选择 Codex CLI、Codex CLI (WebSocket) 或 OpenCode。
3. 选择认证模式和操作系统。
4. 按弹窗提示，将配置分别写入 config.toml 和 auth.json。
5. 保存后完全退出并重新启动客户端，再发起一次低风险测试。

保护 API Key

不要把完整 Key 发送到公开聊天、网页 AI 客服、代码仓库或未遮挡的截图中。复制配置时请确认使用的是自己的密钥。

配置完成后，可以在客户端中发起一次简单请求，并在控制台核对使用记录。若无法正常使用，请记录发生时间、客户端、模型 ID 和完整错误文字，再联系支持。