接入 CCSwitch

CCSwitch 适合研发团队统一切换本地 AI 编程工具的 Provider。它不替代 UWCode 的企业级 Key、用量和权限管理，而是帮助员工把本地工具快速切换到企业分配的 UWCode 通道。

适用场景

团队同时使用 Claude Code、Codex App、Gemini CLI 等多个本地研发工具。
希望管理员提供一套 Provider 配置，员工通过 CCSwitch 一键启用。
需要减少员工手工编辑 JSON、TOML 或 .env 文件的配置错误。

前提条件

员工本机已安装 CCSwitch。
UWCode 管理员已创建员工 Key 或项目 Key。
管理员已确认该 Key 可用于对应工具所需协议：
- Claude Code：Claude / Anthropic 兼容通道。
- Codex App：Responses API 兼容通道。
- Gemini CLI：Gemini API 兼容通道。

新增 UWCode Provider

在 CCSwitch 中创建 Provider 时，建议使用统一命名和清晰备注，便于员工区分企业通道与个人账号。

字段	建议值
Provider 名称	`UWCode 企业版`
API Endpoint	复制 UWCode 控制台中对应工具的接入地址
API Key	员工或项目专属 `uwc-xxxxxxxx`
Provider 类型	根据目标工具选择 Claude、Codex 或 Gemini

如果 CCSwitch 当前版本支持 Universal Provider，可以创建一个企业 Provider 后分别写入 Claude Code、Codex 和 Gemini CLI；如果版本不支持通用配置，则按工具分别创建 Provider。

推荐操作流程

打开 CCSwitch，进入 Provider 管理。
点击新增 Provider，选择目标工具或通用 Provider。
填写 UWCode 企业版、API Endpoint 和 API Key。
保存后点击 Enable 或通过系统托盘切换到该 Provider。
对 Claude Code 以外的大多数 CLI 工具，重新打开终端窗口后再验证。

团队分发建议

企业推广时建议采用以下方式：

管理员创建部门级或项目级 Provider 模板。
员工只替换个人 Key，不修改 Base URL、模型映射和协议选项。
对需要审计的团队，禁止员工启用未经授权的第三方 Provider。
切换 Provider 后要求在 UWCode 控制台确认请求日志。

验证接入

在 CCSwitch 中确认当前启用 Provider 为 UWCode 企业版。
重新打开对应工具，例如 Claude Code、Codex 或 Gemini CLI。
发起一次简短请求。
在 UWCode 控制台查看员工 Key 下是否出现调用日志。

常见问题

切换后工具仍走旧账号：重新打开终端或目标工具；部分工具只在启动时读取配置。
Claude Code 可热切换但其它工具不生效：以 CCSwitch 当前版本说明为准，通用处理方式是重启终端。
健康检查失败但工具可用：部分工具或网关会验证请求来源，健康检查失败不一定代表实际调用失败，应以目标工具内请求和 UWCode 日志为准。
企业不允许员工新增 Provider：可以通过统一配置模板和终端管理策略控制 Provider 分发范围。

官方依据

CCSwitch README：支持 Claude Code、Codex、Gemini CLI 等工具与 Provider 管理