03 · 使用 CC Switch 接入 Freecode#
CC Switch 用于管理编程工具的供应商配置。Freecode 的 API 密钥页提供 CC Switch 导入入口，目前可选择 Claude、Codex 和 Gemini。本文以 GPT 和 Claude 接入为例。
1. 安装#
从 CC Switch 官方发布页 下载当前稳定版，安装并启动一次，使系统注册 ccswitch:// 协议。
2. 从 Freecode 导入#
- 登录 Freecode。
- 打开 API 密钥，为目标工具创建独立密钥，并选择包含目标模型的分组。
- 在该密钥所在行打开操作菜单，选择「CC Switch」。
- 选择 Claude 或 Codex，填写供应商名称，例如
Freecode Claude或Freecode Codex。 - 选择主模型；Claude 可进一步选择 Haiku、Sonnet 和 Opus 模型。
- 点击「Open CC Switch / 開啟 CC Switch」，允许浏览器打开应用。
- 在 CC Switch 的确认界面核对名称、地址、密钥和模型，然后完成导入并确认当前启用的供应商。
推荐示例：Codex 选择 gpt-6.1-sol；Claude 主模型选择 claude-sonnet-4-6。模型选择框可能列出账号可见模型，使用前仍需确认当前这把密钥的分组有权调用。
3. 核对地址#
Freecode 导入器会按工具设置地址：
| 应用 | 地址 | 主要接口 |
|---|---|---|
| Codex | https://api.freecode.cc/v1 |
Responses |
| Claude Code | https://api.freecode.cc |
Anthropic Messages |
如果需要手动添加供应商，也使用上述地址、自己的 Freecode 密钥和对应模型。不要在 Base URL 中填入完整接口路径。
Claude 的可选槽位可填写：
| 槽位 | 示例模型 |
|---|---|
| 主模型 / Sonnet | claude-sonnet-4-6 |
| Opus | claude-opus-4-6 |
| Haiku | claude-haiku-4-5 |
4. 验证#
完全退出并重新打开对应 CLI，开始新会话，发送一句话。收到真实回复后，在 Freecode 使用日志 核对调用记录。
Claude Code 使用 /status 检查配置；Codex 检查当前模型和供应商。若你同时使用 CC Switch 和手动配置文件，要确认最终生效的是哪一套，避免互相覆盖。
常见问题#
- 点击后没有打开应用：先启动 CC Switch，确认浏览器允许打开外部应用。
- 导入后没有生效：在 CC Switch 确认已启用 Freecode 供应商，然后重新打开 CLI。
- 模型不可用：核对密钥分组、模型限制和精确 ID。
- 需要切回原服务：在 CC Switch 重新启用原供应商。
导入链接中包含真实密钥，不要转发链接或截图。其他错误见 常见问题。