解决 CC Switch 自定义 Codex Desktop 模型不显示的保姆级教程

最近在折腾代码辅助工具，为了最大化利用手头的各种 API 资源，我把 CC Switch 和 Codex Desktop 结合起来用。想法很美好：对接属于自己的 CPA（中转服务），既能用 GPT，也能时不时切到 Grok 来换换脑子干活。

但实际操作中遇到一个挺搞心态的问题：明明在 CC Switch 里配置了模型映射，也填好了 API 凭证，但在 Codex Desktop 的模型列表里死活看不到 Grok 或者其他第三方模型（比如 DeepSeek、GLM），只有默认的 GPT-4 系列选项。

如果你也遇到了类似情况，别急着怀疑软件坏了，大概率是配置环节这几个“坑”没踩对。今天就把排查思路和解决方法揉碎了讲一讲。

一、 核心问题：为什么你的模型“隐身”了？

首先要理解 CC Switch 和 Codex Desktop 的交互逻辑。Codex Desktop 调用模型时，往往需要一个标准的模型列表。如果你只是在后台对接了 API，但没有在前端“暴露”这些 ID，软件自然只能显示默认值。

出现“看不到 Grok 模型”的情况，通常有三个原因：

在 CC Switch 中正确配置模型映射是显示自定义模型的第一步。

1. 映射名称不匹配：这是最常见的坑。CC Switch 的映射规则必须与客户端请求的模型名称完全对齐。
2. API Key 权限或通道限制：你的 CPA 账号虽然配置了 Grok 的凭证，但对应的通道可能没有开启，或者是 ID 填错了。
3. 客户端缓存机制：有时候配置改对了，但客户端缓存了旧的列表信息。

二、 保姆级排查与配置步骤

想要在 GPT 和 Grok 之间无缝切换，建议按照以下步骤逐一检查。

1. 检查 CC Switch 的模型映射配置

打开 CC Switch 的后台设置，找到“模型映射”或“自定义模型”板块。这里的关键在于“伪装”和“透传”。

• 确定目标 ID：首先确认你使用的 CPA 平台 Grok 模型的真实 ID 是什么（例如 grok-beta 或者 grok-1）。
• 设置映射规则：在 CC Switch 的映射表中，你需要将 Codex Desktop 可能请求的名称（或者一个自定义的别名）指向这个真实 ID。

比如，你可以这样设定：

• 请求名称：grok-1
• 转发目标：your-cpa-grok-id

注意：有些配置只支持列表选择，如果你只填了转发目标没填列表，客户端是读不到这个选项的。必须确保 CC Switch 有一个“返回模型列表”的接口，或者你在自定义模型列表里手动把 Grok 加进去。

检查中转服务端的通道状态和凭证有效性，确保后端通路正常。

2. 验证 CPA 端的通道状态

这一步往往被忽略。回到你对接 CPA 的后台：

• 凭证有效性：确认 Grok 的 API Key 是否处于激活状态，有没有额度限制。
• 通道开关：很多中转服务是按通道管理的，检查一下 Grok 对应的通道是否被手动关闭了。
• 跨域限制：如果 CC Switch 和 CPA 之间有跨域请求，记得在 CPA 后台放行 CC Switch 的域名或 IP。

3. Codex Desktop 的连接点重置

配置完 CC Switch 后，Codex Desktop 端的操作也很关键。

• 刷新 API 端点：不要只改模型名字，把 Base URL（API 基础地址）重新填写并保存一次，强制客户端重新获取一次模型列表。
• 清除本地缓存：如果软件有缓存设置，直接点清除；或者干脆退出软件重启，让它重新拉取最新的模型配置。

三、 实用小技巧：关于多模型切换的体验优化

既然折腾是为了干活效率高，这里再分享两个小 tips：

• 使用规范命名：在自定义模型名称时，加上前缀（如 [Grok]、[Qwen]），这样在下拉菜单里一目了然，切换起来不手忙脚乱。
• 监控请求日志：如果以上都试了还是不显示，打开 CC Switch 的请求日志。当你点击“刷新模型”时，看看后端有没有报错。比如 401 说明凭证挂了，404 说明路径错了，根据日志修最快。

四、 总结

CC Switch 自定义模型这事儿，原理不难，难的是细节的打磨。出现模型列表不显示，90% 是因为映射没做好或者通道没拉通。按照上面的步骤检查一遍，把 Grok“揪”出来应该不是难事。

在 Codex Desktop 中重新填写 API 端点并刷新模型列表。

希望这篇教程能帮大家省下折腾的时间，安心写代码。