ccm，一个极简、轻量、快捷的 AI 账号与 API 渠道切换器。
极简：只选一个。 CCM 把 Codex、Claude Code、Pi、Grok Build 的官方 OAuth 账号和已保存的第三方 API 渠道，收进同一个轻量切换器。一个 Agent 同一时间只保留一个当前渠道：选中即可切换，切回官方账号即可恢复干净的官方配置。
轻量：不再加一层复杂系统。 不需要手动改 config.toml、auth.json 或环境变量；不需要搭建代理、路由规则、负载均衡或模型网关。CCM 不做路由器，只安全地切换你当前要用的渠道，并在写入前创建本机回滚备份。
快捷：装好就能切。 特别适合同时使用多个 AI 账号、却不想研究复杂配置的人。对于使用 ChatGPT Desktop 的 Windows 用户，只需解压、双击安装器、再双击桌面的 CCM.cmd，即可进入交互式切换界面；以后只要选择保存好的渠道。所有账号凭据、API Key、渠道注册表和备份都只保留在本机，CCM 不托管也不上传它们。
- 极简：一个 Agent 同一时间只激活一个渠道；官方账号与第三方 API 一键切换。
- 轻量：本地 Node.js CLI，无常驻服务、无云端账户、无代理转发层。
- 不需要成为技术人员：特别适合需要切换多个 AI 账号、但不想研究配置文件、路由规则或终端命令的用户；Windows 安装后可从桌面
CCM.cmd打开交互式界面，也可用ccm --ui打开本地 Web 界面。 - 安全可回退：切换前自动备份；切回官方账号时自动清理遗留的第三方 provider、Base URL 和密钥配置。
- 日常整理也保持轻量：在终端交互界面中管理 Codex / Claude 的 Skills、Plugins 与历史会话，无需另装管理平台。
- 跨平台：Windows、macOS（Intel / Apple Silicon）和 WSL2 使用各自的正确安装包与配置目录。
CCM 不只帮助你切换渠道，也提供轻量的日常整理功能。运行 ccm 或 ccm --tui 后，用左右方向键切换 Channels / Skills / Sessions 页面，用 Tab 在 Codex 与 Claude 之间切换。
- 查看 Codex Skills 和 Claude Plugins 的状态与说明。
- 新建或安装、启用或停用、备份、删除或卸载条目；Codex Skill 还可直接编辑。
- 删除 Codex Skill 时会先备份并移入 CCM 回收站，而不是直接永久删除。
- 查看 Codex 与 Claude 的本地历史会话，并从选中的会话继续工作。
- 为会话收藏、添加标签、绑定一个渠道；恢复会话时，CCM 会先切换到它绑定的渠道。
- 可归档会话、移入 CCM 回收站，或批量清理指定天数前未收藏的会话。
这两项功能只读取和整理本机已有的 Skills、Plugins、会话文件及 CCM 元数据；不会上传内容，也不会把 CCM 变成复杂的路由或云端管理服务。
| 平台 | CCM 状态和备份 | Codex 配置 |
|---|---|---|
| Windows | %LOCALAPPDATA%\ccm |
%USERPROFILE%\.codex |
| macOS | ~/.local/share/ccm |
~/.codex |
| WSL2 独立模式 | ~/.local/share/ccm |
~/.codex |
| WSL2 共享模式 | WSL 的 ~/.local/share/ccm |
Windows %USERPROFILE%\.codex |
渠道注册表和回滚备份可能含有 API Key。不要将这些目录、auth.json、config.toml 或截图中的密钥提交到 GitHub、发送到 Issue 或分享给他人。
切换 Codex 第三方渠道时，CCM 会自动设置当前渠道的 OPENAI_BASE_URL 与 OPENAI_API_KEY：Windows 写入当前用户环境，让重启后的 ChatGPT Desktop 读取；macOS / WSL2 写入带 CCM 标记的 shell 配置块。切回官方账号时，这两个第三方变量会自动清除，官方 OAuth 登录缓存保留在本机。
- 在 GitHub Releases 下载
CCM-Windows-v*.zip，解压后双击Install-CCM.cmd。 - 双击桌面新出现的
CCM.cmd，在交互式界面中选择 Codex 和要使用的渠道；也可以在 PowerShell 输入ccm --ui使用本地 Web 界面。 - 如果你使用 ChatGPT Desktop，完成 Codex 渠道切换后请完全退出并重新打开 ChatGPT Desktop。
第一次使用官方账号时，选择官方渠道并按提示完成浏览器登录即可。只有需要添加第三方 API 时，才在 CCM 中填写一次 Base URL、API Key 和模型；以后只需选择保存好的渠道。
请从 GitHub Releases 下载与操作系统对应的压缩包；不要跨平台使用安装器。
| 系统 | 下载文件 | 支持范围 |
|---|---|---|
| Windows | CCM-Windows-v*.zip |
Windows 10 / 11 |
| macOS | CCM-macOS-v*.zip |
Intel 与 Apple Silicon |
| WSL2 | CCM-WSL2-v*.zip |
原生 Linux 配置或共享 Windows Desktop 配置 |
- Node.js 22 或更高版本
- 安装你计划使用的 Agent CLI，并保证相应命令在终端可用：
codex、claude、pi、grok - WSL 用户必须在 WSL2 发行版内部 安装 Node.js 以及需要管理的 Agent CLI；不支持 WSL1。选择共享 Windows Desktop Codex 配置时，必须在 WSL 内安装
codex。
如未安装 Codex CLI，可按官方安装方式执行：
# Windows PowerShell
irm https://chatgpt.com/codex/install.ps1 | iex# macOS 或 WSL2
curl -fsSL https://chatgpt.com/codex/install.sh | sh解压 CCM-Windows-v*.zip，双击 Install-CCM.cmd。安装完成后，新开一个 PowerShell 并检查：
ccm --doctor
ccm --ui安装器将 CCM 安装到 %LOCALAPPDATA%\Programs\CCM，并创建 ccm 命令和桌面快捷启动脚本。
解压 CCM-macOS-v*.zip，在解压目录执行：
bash ./install.sh
exec "$SHELL" -l
ccm --doctor
ccm --uiCCM 安装到 ~/.local/share/ccm，命令位于 ~/.local/bin/ccm。zsh 会更新 ~/.zshrc，bash 会更新 ~/.bashrc。
解压 CCM-WSL2-v*.zip 后，在 WSL2 终端执行：
bash ./install.sh安装器会要求选择运行模式：
| 模式 | 使用的 Codex 配置目录 | 适用场景 |
|---|---|---|
independent |
WSL 中的 ~/.codex |
WSL 与 Windows Desktop 的账号、会话和渠道彼此独立。 |
shared |
Windows 的 %USERPROFILE%\.codex |
WSL 与 Windows ChatGPT Desktop 共享同一套官方登录和渠道配置。 |
共享模式会在 WSL shell 配置中设置 CODEX_HOME=/mnt/c/Users/<Windows-user>/.codex。这与 OpenAI 官方 WSL 配置说明 一致。
打开本机 Web 界面：
ccm --ui打开后选择或新建第三方渠道；CCM 会保存该渠道的 Base URL、模型和本机 API Key。切回已保存的渠道：
ccm --tool codex --list
ccm --tool codex --use <渠道名称或 ID>切换到 Codex 官方账号并在默认浏览器中登录：
ccm --tool codex --login-officialCCM 会先清理第三方 provider、模型覆盖和 OPENAI_BASE_URL，再启动 codex login。如果使用 ChatGPT Desktop，请在渠道切换后完全退出并重新打开应用。
Claude 也可按相同方式切换：
ccm --tool claude --list
ccm --tool claude --use <渠道名称或 ID>
ccm --tool claude --login-officialPi 和 Grok Build 的官方登录与第三方渠道也已支持：
# Pi 会打开交互界面；在 Pi 内输入 /login 完成官方订阅登录
ccm --tool pi --login-official
ccm --tool pi --use <渠道名称或 ID>
# Grok Build 官方登录；WSL2 会自动走设备授权
ccm --tool grok --login-official
ccm --tool grok --use <渠道名称或 ID>在 ccm --ui 中分别选择 Pi、Grok Build 标签页即可新增第三方渠道。Pi 必填模型 ID 和协议（openai-completions、openai-responses、anthropic-messages、google-generative-ai）；Grok 必填模型 ID 和后端（responses、chat_completions、messages）。Pi 的第三方 provider 写入 ~/.pi/agent/models.json，Grok 的自定义模型写入 ~/.grok/config.toml；两者都会在切换前备份，并保留各自的官方登录凭据与无关配置。参见 Pi Provider 文档 和 Grok Build 配置文档。
其他入口：
ccm # 终端交互界面
ccm --tui # 终端交互界面
ccm --doctor # 检查运行环境与当前配置
ccm --import-wsl --dry-run
ccm --import-wsl # 导入 WSL 中的已有渠道（Windows）提交 Issue 时，请提供操作系统、CCM 版本、ccm --doctor 的脱敏输出、复现步骤和报错文本。不要粘贴 API Key、Cookie、auth.json 或完整 config.toml。
本项目采用 MIT License。