CC-Switch 使用教程

CC-Switch 是第三方开源工具，用来管理多个 AI CLI 的 provider、模型、MCP、提示词和技能配置。添加 AveMujicaAPI provider 后，可以在 Codex、Claude Code 兼容模式、Cline/Gemini 兼容模式之间切换。

什么时候用

• 同时使用 Codex、Claude Code、Cline/Gemini、OpenCode 等 AI CLI 的用户。
• 需要在官方 API、AveMujicaAPI、测试环境和团队环境之间切换的用户。
• 不想手动编辑多个配置文件的用户。

基本流程

1. 完成 环境检查。
2. 打开 CC-Switch Releases，下载与你系统匹配的安装包并安装。
3. 打开 令牌管理 页面，点击“添加令牌”创建 API Key。
4. 在 CC-Switch 中添加 AveMujicaAPI provider：Codex 选择 Responses，其它工具选择 OpenAI-compatible。
5. 切换目标 CLI 到新 provider；其它工具按兼容模式配置。
6. 运行最小对话验证。

provider 填写表

客户端	Base URL	Token	协议/备注
Codex	https://api.avemujica.moe/v1	<YOUR_AVEMUJICA_API_KEY>	wire_api = "responses"
Claude Code 兼容模式	https://api.avemujica.moe/v1	<YOUR_AVEMUJICA_API_KEY>	需要桥接层支持 OpenAI-compatible
Cline/Gemini 兼容模式	https://api.avemujica.moe/v1	<YOUR_AVEMUJICA_API_KEY>	选择 OpenAI-compatible provider

相关工具

• Skills
• oh-my-codex
• oh-my-claudecode

子章节

• 通用步骤
• Codex 配置
• Claude Code 兼容配置
• Gemini/Cline 兼容配置
• CC-Switch CLI 使用