CC Switch 接入教程
使用 CC Switch 统一管理 Codex、Claude Code、OpenCode 等编程工具的 JiaPi 接入配置
适合什么场景
CC Switch 适合已经同时使用多个编程 AI 工具的用户。它不是模型服务本身，而是一个本地配置管理器，可以帮助你在 Codex、Claude Code、OpenCode、OpenClaw 等工具之间集中管理 Provider、密钥和模型。
多工具切换
同一台电脑上同时使用 Codex、Claude Code、OpenCode 时更方便。
统一管理密钥
把不同工具的 Provider、API Key、模型集中整理，减少手动改文件。
新手少改配置
通过界面添加和切换配置，降低写错 JSON/TOML 的概率。
排查更直观
能快速确认当前工具到底使用了哪组 Provider 和模型。
先安装目标 CLI
CC Switch 负责管理配置，不等于替你安装 Codex、Claude Code 或 OpenCode。使用前先确认目标工具本身已经可运行，例如 codex --version、claude --version、opencode --version。
一、准备 JiaPi 参数
如果你要通过 OpenAI 兼容工具接入 JiaPi，准备下面三项：
Base URL
https://ai-api.jiapi.com
API Key
JiaPi 控制台创建的真实密钥。
模型名称
以 JiaPi 当前可用模型为准，示例使用 gpt-5.4。
目标工具
先决定要让 Codex、OpenCode 还是 Claude Code 使用这组配置。
Claude Code 要先确认协议
Claude Code 默认使用 Anthropic/Claude 协议。只有当你的入口支持 Anthropic 兼容，或者 CC Switch 当前版本明确提供可用的协议转换/代理能力时，才适合让 Claude Code 走 OpenAI 兼容地址。新手如果只拿到 https://ai-api.jiapi.com，建议先给 Codex 或 OpenCode 配置。
二、下载和安装 CC Switch
官方入口：
推荐从官网或 GitHub Releases 下载 Windows 安装包。
安装后先打开 CC Switch，确认界面能正常启动。随后在 PowerShell 中确认你要管理的 CLI 是否可用：
codex --version
opencode --version
claude --version哪个工具提示命令找不到，就先回到对应工具教程完成安装。Codex CLI 通常还需要先准备 Node.js/npm。
推荐从官网或 GitHub Releases 下载 macOS 安装包。
如果系统提示来自未识别开发者，请按 macOS 安全设置允许打开。随后在 Terminal 中确认目标 CLI：
codex --version
opencode --version
claude --versionFinder 默认隐藏点开头目录，但 CC Switch 通常会帮你减少手动进入这些目录的次数。
Linux 用户优先查看 GitHub Releases 是否提供适合当前发行版的包。
如果你在服务器或 WSL 中使用，先确认图形环境是否可用。纯服务器场景通常更适合继续使用各工具自己的 CLI 配置文件。
codex --version
opencode --version
claude --version三、添加 JiaPi Provider
CC Switch 不同版本的界面名称可能略有差异。只要能找到 Provider、API、Model、Base URL、Key 这类入口，就按下面思路填写。
JiaPi。OpenAI Compatible、OpenAI 或允许自定义 Base URL 的选项。https://ai-api.jiapi.com。gpt-5.4。不要把 Base URL 写成控制台地址
Base URL 只填写 https://ai-api.jiapi.com。不要填写 https://console.jiapi.com，也不要在末尾追加 /chat/completions。
四、按目标工具选择用法
适合 OpenAI 兼容配置，推荐新手优先跑通。
操作思路：
- 在 CC Switch 中选择 Codex 或对应配置入口。
- 选择刚创建的
JiaPiProvider。 - 确认模型为 JiaPi 可用模型。
- 应用或写入配置。
- 重启 Codex UI 客户端，或重新打开终端运行 Codex CLI。
验证命令：
codex --version进入项目后输入：
请只阅读当前项目，不要修改文件。先说明这个项目的目录结构。适合 OpenAI 兼容配置，也适合终端开发用户。
操作思路：
- 在 CC Switch 中选择 OpenCode 或对应配置入口。
- 选择
JiaPiProvider。 - 确认 Base URL、API Key、模型名称都正确。
- 应用配置后重启 OpenCode。
验证命令：
opencode --version
opencode第一次任务建议只读项目，不要直接让它修改文件。
先确认你手上的入口是否支持 Anthropic/Claude 兼容。
如果 CC Switch 当前版本提供本地代理或协议转换能力，请按它的界面说明启用对应功能；如果没有，请不要直接把 https://ai-api.jiapi.com 填成 Claude Code 的 Anthropic Base URL。
验证命令：
claude --version
claude第一次任务建议：
请只阅读当前项目，不要修改文件。先说明项目使用了什么技术栈。五、Windows / macOS / Linux 的配置差异
Windows 上最容易混淆的是 PowerShell 和 WSL。
- 如果 Codex/OpenCode 在 Windows 原生环境运行，就在 Windows 里用 CC Switch 配置。
- 如果工具在 WSL 里运行，Windows 图形界面写入的配置不一定会自动进入 WSL。
- 遇到不生效时，先确认目标 CLI 到底从哪个用户目录读取配置。
macOS 的隐藏目录容易让新手找不到配置文件。
~/.codex、~/.claude、~/.config默认可能不在 Finder 中直接显示。- 如果 CC Switch 写入后工具不生效，先重启目标工具。
- 仍不生效时，再打开对应配置目录检查是否写入成功。
Linux / WSL 更推荐优先用 CLI 环境变量验证。
- 纯服务器环境通常没有图形界面，不一定适合 CC Switch 桌面版。
- WSL 和 Windows 原生环境默认不共享用户目录。
- 如果你在 WSL 中运行工具，请在 WSL 内完成安装和验证。
六、验证是否成功
JiaPi Provider。认证通过
没有出现 401、unauthorized、invalid API key。
模型可用
没有出现 model not found 或模型不可用。
工具读到配置
重启后仍然使用 JiaPi Provider。
能读项目
可以正常回答项目结构、技术栈或启动命令。