辅助接入
辅助工具概览
区分 Provider 切换与账户、多实例、配额和启动管理。
准备:先理解工具边界
准备好要管理的客户端、Provider 和独立 API Key。辅助工具不会替代 API 文档,也不会自动证明 Key、分组或模型可用;先用 cURL验证连接。
两类辅助工具
| 工具 | 用途 | 不负责什么 |
|---|---|---|
| CC Switch | 在受支持的开发工具之间切换 Provider 配置 | 不是模型聊天或代码客户端,不替代 API 请求验证 |
| Cockpit Tools | 账户、多实例、配额和启动器管理 | 不是普通 API 客户端,不是直接发送业务请求的通用界面 |
操作步骤
- 明确要解决的是 Provider 切换,还是账户、多实例、配额与启动管理。
- 为每个工具或环境创建独立、可撤销、有限额的 Key。
- 先备份现有配置,再一次只导入或切换一个 Provider/实例。
- 重启目标客户端,用短请求验证,并在用量页核对实际 Key 和模型。
成功标志
目标实例使用预期 Provider 启动,短请求成功,用量页显示预期 Key、模型和端点;切回原配置也能恢复。
失败时先检查
先检查工具是否写入了目标客户端真正读取的配置位置,以及客户端是否完全重启。若 cURL 失败,先处理 Key、分组或模型;若 cURL 成功,检查配置覆盖顺序、Provider 名称和实例选择。
安全边界
这类工具可能读取或改写本地凭据和配置。安装前核对来源与权限,导出配置前删除完整 Key;不要用同一把生产 Key 管理所有实例,也不要把含密钥的备份同步到公开仓库。
