CC-Switch

CC-Switch 是一款开源桌面应用（Windows / macOS / Linux），专门用来管理 Claude Code 和 Codex CLI 的多个 Provider 配置，一键切换、一键导入。Picklyone 做了深度集成——控制台里点一下就能把 Picklyone 作为 Provider 推送到 CC-Switch。

💡 为什么推荐 CC-Switch：Claude Code 和 Codex 的配置都在环境变量 / 配置文件里，手工来回改很折腾。CC-Switch 把所有 Provider 统一管理，界面里点一下切换，不用再去改 ~/.bashrc 或 ~/.codex/auth.json。

第 1 步：下载 CC-Switch

在 GitHub Releases 页下载对应系统的安装包：

Windows：.exe 或 .msi 安装包
macOS：.dmg（注意 Apple Silicon / Intel 版本区分）
Linux：.AppImage 或 .deb

安装完成后打开一次 CC-Switch，让它完成 ccswitch:// 系统协议注册。

第 2 步：导入 Picklyone 配置

方式 A：一键导入（推荐）

登录 Picklyone，进入 API 密钥页
选中想用的 Key，点右侧下拉里的 配置指南
在弹窗左侧选择 CC-Switch
点 一键导入 Claude Code 或 一键导入 Codex
浏览器会弹窗提示"打开 CC-Switch"，确认即可
CC-Switch 窗口会自动激活，Picklyone Provider 已经填好所有参数

⚠️ 安全提示：一键导入通过系统的 ccswitch:// 协议将完整密钥传给本机 App。请只在你信任的个人设备上用；公用 / 他人电脑请走下方 方式 B 手动配置。原因：同一台机器上如果还有恶意程序抢注了 ccswitch:// 协议，它能看到这次传递的 Key。

方式 B：手动配置

如果你不想走 URL 协议，或者 Key 创建时没点一键（一键只在 创建时 可用，因为之后密钥只显示为掩码）：

打开 CC-Switch，点 添加 Provider，类型选 Custom
按下表填入参数：

Claude Code 配置

字段	值
名称	Picklyone
API 地址	`https://api.picklyone.com`
API Key	`pk_live_xxxxxxxxxxxxxxxx`
默认模型	`claude-sonnet-4-6`
Haiku 映射	（留空）
Sonnet 映射	`claude-sonnet-4-6`
Opus 映射	`claude-opus-4-7`

Codex 配置

字段	值
名称	Picklyone
API 地址	`https://api.picklyone.com/v1`
API Key	`pk_live_xxxxxxxxxxxxxxxx`
默认模型	`gpt-5.4-mini`

保存并启用
重启终端，让 Claude Code / Codex 加载 CC-Switch 写入的新配置

第 3 步：验证

打开终端，分别验证两个工具：

# Claude Code
claude "hi, tell me your model name"

# Codex CLI
codex "list files in this folder"

收到回复即接入成功。之后在 CC-Switch 里点 Provider 列表就能在 Picklyone、官方 Anthropic、官方 OpenAI 之间自由切换。

Picklyone 使用建议

CC-Switch 只是配置管家：它不过流量，只负责替你改 ~/.bashrc 和 ~/.codex/。切到 Picklyone 后，真实请求仍然直接从你的终端发到 api.picklyone.com。
切换 Provider 不影响 Picklyone 余额：你切到官方 Anthropic 时扣的是 Anthropic 的钱，切回 Picklyone 才开始消耗 Picklyone 余额。平时对比测试非常方便。
同一个 Picklyone Key 两边共用：CC-Switch 的 Claude Code 和 Codex 两个 Provider 可以填同一个 pk_live_* Key。Picklyone 的 Key 本来就同时支持 Anthropic 和 OpenAI 协议。
团队分发配置：CC-Switch 支持导出 Provider 配置成 JSON，拷给同事可以直接导入，不需要每人再走一遍 Picklyone 控制台（但导出文件里会含 Key 明文，按敏感文件对待）。

常见问题

点 "一键导入" 没反应 / 浏览器报 "无法打开链接"：CC-Switch 没装，或者 ccswitch:// 协议没注册成功。先打开一次 CC-Switch 让它注册，再重试；仍不行就走 方式 B 手动配置。
Claude Code 还是走老的 Key：Claude Code 的环境变量只在 终端启动时 加载。切完 Provider 后要 重启终端（或重新 source ~/.zshrc）才生效。
Codex 报错 "invalid wire_api"：CC-Switch 的 Codex 模板默认写的是 responses，和 Picklyone 匹配。如果你手动改过 wire_api，改回 responses 即可。
一键导入按钮是灰色的：这是因为 Key 已经显示为掩码（pk_live_****xxxx），浏览器这边没有完整 Key 可传。解决方法：创建新 Key 时立即一键导入，或者走 方式 B 用你自己保存的完整 Key。