Tutorial

CCS / CC-Switch 图文教程

这一页不再讲泛泛安装说明，只讲最短实操链路：如何把 convertmodel 的订阅和 API key 导入到你自己的 CCS， 然后分别跑通 Claude Code 与 Codex。

Step-by-step
GUI 可视化
多客户端支持

Step 1 — 先在 convertmodel 后台拿到可用 key

在把配置导入 CCS 之前，先登录 convertmodel 后台，确认账号里已经有可用订阅或赠送额度， 然后在 API key 页面复制一枚以 sk- 开头的 key。

convertmodel 后台 API key 页面截图
  1. 登录 convertmodel 后台。
  2. 确认账号里已经有体验额度或已开通订阅。
  3. 进入 API key 页面，复制准备导入 CCS 的 sk-... key。
注意：如果账号没有可用额度，CCS 里就算导入成功，也只会得到空调用或报错。

Step 2 — 打开 CCS，先切到 Claude 页签

打开 CC-Switch 后，先切到 Claude 页签。 这里会列出你已经保存过的 Claude 类配置，后面导入 convertmodel 之后也会出现在这里。

CC-Switch Claude 列表截图

你可以把它理解成一个配置切换器：Claude Code 一套，Codex 一套，但都可以指向同一个 convertmodel 账号。

Step 3 — 把 Claude Code 导入到 CCS

新建一条 Claude 配置，把 convertmodel 的 Anthropic 入口填进去。 这一条会给 Claude Code 使用。

CC-Switch Claude 配置表单截图

在配置表单中填入以下关键字段：

Name 建议直接填 convertmodel，后面切换时一眼就能看懂。
Base URL https://convertmodel.net/anthropic
API Key 填入刚才从 convertmodel 后台复制的 sk-... key。
Client / Type 选择 Claude / Anthropic 兼容项，不要选 OpenAI 兼容项。
注意：Claude 这一条一定要走 /anthropic。如果你把它填成根域名，后面容易串到错误的协议口径。

Step 4 — 保存后，在 Claude 列表里确认导入成功

保存后，回到 Claude 列表，确认 convertmodel 这条配置已经出现， 并且详情里的 Base URL 与 key 都是你刚才填写的那组值。

CC-Switch Claude 配置详情截图
  1. 找到刚保存的 convertmodel 配置。
  2. 确认它位于 Claude 页签，而不是 Codex 页签。
  3. 点击 Apply / Switch，让这条配置成为当前生效项。

Step 5 — 再把 Codex 导入到 CCS

如果你也在用 Codex，同一套 convertmodel 订阅还可以再导入一条 Codex 配置。 这一条走 OpenAI 兼容入口，不走 Claude 的 /anthropic。

CC-Switch Codex 配置表单截图
Name 同样建议填 convertmodel，或者写成 convertmodel-codex 便于区分。
Base URL https://convertmodel.net
API Key 可以继续使用同一枚 sk-... key，也可以单独创建一枚新 key。
Client / Type 这里选 Codex / OpenAI 兼容项，不要填成 Claude。
注意：Codex 这一条用根域名 https://convertmodel.net。不要把 Claude 的 /anthropic 直接复用过来。

Step 6 — 最后做一次切换验证

到这里你至少会有两条配置： 一条给 Claude Code，一条给 Codex。最后做一次最小验证，确认两条都能切通。

  1. 先切到 Claude 那条配置，运行一次最小请求，确认 Claude Code 正常响应。
  2. 再切到 Codex 那条配置，跑一个最小命令，确认 Codex 正常走 convertmodel。
  3. 只要两条都能通，后面你就可以完全在 CCS 里切换，而不必再手改本地配置文件。

常见问题

503 No available accounts 先检查 key 是否真的有额度，再检查导入的是 Claude 口径还是 Codex 口径。很多问题不是 CCS 本身坏了，而是入口填错了。
配置不生效 确认你在 CCS 里已经点了 Apply / Switch，并且当前生效的是 convertmodel 这一条，而不是旧配置。
Claude 和 Codex 混填 Claude 用 https://convertmodel.net/anthropic；Codex 用 https://convertmodel.net。这两个入口不要互换。