CC-Switch 接入 ModelFold

CC-Switch 是开源桌面配置管理工具，可为 Claude Code、Codex、Gemini CLI 等切换 API 供应商、Base URL、Key 和模型。它本身不是模型厂商，也不代替编程客户端。

首次缓存提示

编程 Agent 会发送工具定义、系统提示和上下文。首次请求需要处理并建立缓存，消耗可能高于后续请求；后续是否命中缓存取决于模型、上下文和缓存有效期，并非每次都能命中。可在 ModelFold 用量记录中查看实际消耗。

安装与准备

1. 从官方 Releases 下载适合系统的安装包，按官方 README 安装。
2. 准备已安装的 Claude Code 或 Codex，以及自己的 ModelFold API Key。客户端安装与接口规则分别见 Claude Code 和 Codex CLI。
3. 首次打开时，CC-Switch 会导入已有配置。保留原供应商，方便切回。

图片来自官方 README，展示供应商管理界面，并非 ModelFold 实测截图；不同版本界面文字可能略有变化。素材来源与许可。

为 Claude Code 新增 ModelFold

1. 在左侧选择 Claude Code，进入 Direct（直连） 页签。
2. 点击右上角 + / Add Provider（添加供应商），选择 Custom Configuration（自定义配置）。
3. 名称填 ModelFold，API 地址填 https://modelfold.ai/anthropic，API Key 填自己的原始 Key，不加 Bearer 前缀。协议使用 Anthropic Messages。
4. 主模型推荐 claude-opus-5-5。在模型映射或配置编辑器中同时填写 Opus、Sonnet、Haiku；具体 ID 以携带本人 Key 请求 https://modelfold.ai/anthropic/v1/models 返回的列表为准。

配置编辑器的 env 示例（替换 Key 后保存）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://modelfold.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MODELFOLD_API_KEY",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}

只保留一种凭据：若表单已生成 ANTHROPIC_API_KEY，可用它替代 ANTHROPIC_AUTH_TOKEN，不要同时保留不同 Key。不要在地址后添加 /v1/messages。

5. 点击 Add（添加），回到供应商列表后点击 ModelFold 的 Enable（启用）。官方说明 Claude Code 切换无需重启；在客户端运行 /status 核对地址，已有会话仍沿用旧模型时新开会话。

为 Codex 新增 ModelFold

1. 左侧切到 Codex → Direct（直连） → + / Add Provider → Custom Configuration。
2. 名称填 ModelFold，API 地址填 https://modelfold.ai/openai/v1，Key 填自己的 ModelFold Key，协议使用 OpenAI Responses。
3. 在 CC-Switch 的 auth.json 编辑区填写下面内容。这是供应商编辑器里的凭据字段；当前版本会自行写入客户端所需配置，不必手工覆盖本机登录文件。

{
  "OPENAI_API_KEY": "YOUR_MODELFOLD_API_KEY"
}

4. 在 config.toml 编辑区填写：

model_provider = "ModelFold"
model = "gpt-6-astra"

[model_providers.ModelFold]
name = "ModelFold"
base_url = "https://modelfold.ai/openai/v1"
wire_api = "responses"

Codex 的模型以携带本人 Key 请求 https://modelfold.ai/openai/v1/models 返回的 slug 为准。工具卡片推荐的 claude-opus-5-5 对应上面的 Claude Code 接法，不能直接当作 Codex Responses 模型使用。

5. 点击 Add，在供应商卡片点击 Enable，退出并重新启动 Codex 或终端，使新地址和模型生效。

核对与切回

• 检查当前供应商名称、API 地址和模型。官方的 **Connectivity check（连通性检查）**只验证地址可达，不验证 Key 和模型是否可用。实际生成需由你自行发起，并在 ModelFold 用量记录核对结果。
• 遇到 401 检查 Key；404 检查协议和地址是否重复拼接 /v1；模型错误则重新查看对应协议的模型列表。
• 本指南使用直连模式；若客户端显示 127.0.0.1:15721 或 PROXY_MANAGED，说明启用了 CC-Switch 本地路由，可在对应页点击 Back to direct（返回直连）。
• Gemini CLI 也是 CC-Switch 支持的工具，但需要匹配其协议，不能直接照搬上述 Claude Code 或 Codex 地址。参阅更多工具接入。
• 要恢复原配置，在 CC-Switch 中启用原供应商；Codex 需重新启动。回到官方登录时，启用内置官方供应商并按客户端登录流程操作。

更多界面说明见官方新增供应商手册。