国内环境如何使用 Codex：CC Switch + 国内大模型入门

国内环境如何使用 Codex：用 CC Switch 和国内大模型接入工作流

国内环境使用 Codex 的新工作流

很多人装好 Codex 以后，真正卡住的不是“怎么提问”，而是网络和模型。

在海外网络环境里，直接用官方 Codex 往往更简单；但在国内环境里，你可能会遇到连接不稳定、模型调用慢、或者想把 Codex 接到 Qwen、DeepSeek、GLM 等国内大模型上的需求。

这时候最容易犯的错，是一上来就去手改配置文件，改到最后自己也不知道哪里错了。

更适合新手的方式，是先把路线想清楚：能直连官方就直连；不能直连或想用国内模型，就用 CC Switch 这样的配置切换器管理 Codex 配置，必要时再通过兼容网关接国内模型。

一、先说清楚：cc switch 不是 /usr/bin/cc

你在终端里输入 which cc，很多电脑会显示 /usr/bin/cc。那个 cc 是 C 编译器，不是我们这里说的 CC Switch。

这里说的 CC Switch，是一个用于管理 Claude Code、Codex、OpenAI Codex 等工具配置的桌面切换器。它的价值不是“让模型变聪明”，而是帮你少手改配置，快速切换不同供应商、Base URL、API Key 和模型。

对新手来说，这个差别很重要：你不是在终端里敲 cc switch，而是使用 CC Switch 这个应用或工具来管理配置。

二、国内环境有两条路线

配图 2：国内环境的两条路线

国内用户使用 Codex，可以先按两条路线判断：

路线 A：官方 Codex 能稳定访问，就优先用官方配置。这个路线最少折腾。

路线 B：官方访问不稳定，或者你想用国内模型，就通过 CC Switch 切到自定义供应商或兼容网关。

不要把路线 B 理解成“随便找一个 OpenAI-compatible 接口填进去就行”。Codex CLI 的接口形态、配置字段、认证方式和普通聊天 API 不一定完全一样。

三、为什么建议用 CC Switch

配图 3：用 CC Switch 切供应商

手改配置的问题是：你要记住配置文件位置、字段名、模型名、API Key、Base URL，还要避免写错格式。

CC Switch 的思路更接近“配置档案”：你可以给不同模型供应商准备不同配置，需要时切换。

适合新手的流程是：

打开 CC Switch 的 Codex 相关配置页。

新增一个自定义供应商。

填入 Base URL、API Key、模型名等信息。

保存并启用这个供应商。

重新打开 Codex 或重启 Codex Desktop，再做一次简单任务验证。

四、国内大模型怎么接：关键在兼容网关

配图 4：Codex 接国内模型的关键

很多国内模型都提供 OpenAI-compatible API，比如 Qwen、DeepSeek、GLM、Kimi 等。但这里要注意一个边界：普通 OpenAI-compatible Chat Completions 接口，不等于一定能被 Codex 直接完整使用。

更稳的理解方式是：

Codex 需要一个它能识别和调用的 provider 配置。

国内模型通常提供的是模型 API。

中间可能需要一个兼容网关或路由器，把 Codex 的请求转成上游模型能理解的格式。

CC Switch 负责管理和切换配置，不负责保证每个上游模型都天然兼容。

所以，新手不要把重点放在“我能不能随便填一个模型地址”。重点应该放在：这个网关是否明确支持 Codex；它要求的 Base URL 是什么；模型名应该填什么；API Key 存在哪里。

五、一个更安全的新手配置模板

不同版本、不同网关的字段可能不同，下面这个模板只作为思路，不要照抄成唯一答案：

配置名：Domestic Qwen / Domestic DeepSeek

Provider 类型：自定义供应商

Base URL：填写网关或模型服务给你的地址

API Key：只填写可信服务提供的 Key

Model：填写网关支持的模型名

保存后：重启 Codex，再用一个只读任务测试

第一次测试时，不要让 Codex 修改文件。你可以这样说：

请先阅读当前项目结构，不要修改任何文件。

告诉我这个项目的技术栈、入口文件和主要模块。

如果你无法读取或调用模型失败，请明确告诉我错误原因。

六、最容易踩的坑

配图 5：最容易踩的 5 个坑

把 cc 当成 CC Switch：终端里的 cc 多半是编译器，不是配置切换器。

Base URL 写错：少一个 /v1、多一个路径、协议写错，都可能导致调用失败。

模型名写错：有些网关的模型名不是官网宣传名，而是网关自己的映射名。

切换后不重启：Codex Desktop 或 CLI 可能没有立刻读取新配置。

API Key 不安全：不要把 Key 发给不可信中转服务，也不要把配置截图公开。

七、我建议的新手路线

第一步，先确认官方 Codex 是否可用。如果可用，就先用官方路线熟悉工作流。

第二步，如果网络不稳定，再考虑 CC Switch。

第三步，先接一个你最熟悉、最稳定的国内模型，不要一口气加五六个供应商。

第四步，用只读任务测试，不要一开始就让它改项目。

第五步，确认稳定后，再让 Codex 做小范围任务，比如解释项目、修一个明确 bug、生成测试。

最后

国内环境使用 Codex，不是简单换一个模型名就完事。

真正要处理的是三件事：网络路线、配置切换、模型兼容。

CC Switch 的价值，是把复杂配置变成可切换的档案；国内大模型的价值，是在本地网络和成本上更可控；兼容网关的价值，是把两边真正接起来。

新手不要急着追求“最强模型”。先用一个稳定配置，让 Codex 能读项目、能解释结构、能完成小任务。这个工作流跑通以后，再谈换模型、换网关、优化速度，才有意义。