[{"data":1,"prerenderedAt":24},["ShallowReactive",2],{"$f_u8VozWVMYeHO2LBg_uEtJ0PDkyV9HNmPGk9Ih8vQnE":3},{"id":4,"documentId":5,"title":6,"summary":7,"content":8,"author":9,"category":10,"tags":11,"icon":16,"views":17,"isTop":18,"isNew":18,"publishDate":19,"createdAt":20,"updatedAt":21,"publishedAt":22,"slug":23},202,"ncc67gbxx0u5m8e4ilhywuug","不用 GPT Plus，Codex 也能跑起来：接国产大模型全流程（Mac + Windows）","Codex 客户端接国产大模型完整安装配置教程，Mac 和 Windows 双平台。不用开 GPT Plus、不用外网、不用信用卡，含 CC Switch 路由配置与常见报错排查。","\u003Cp>\u003Cdiv class=\"article-content\" style=\"font-family: 'Microsoft YaHei', '微软雅黑', sans-serif; line-height: 1.8; color: #333;\">\n\n\u003Ch1>不用 GPT Plus，Codex 也能跑起来：接国产大模型全流程（Mac + Windows）\u003C/h1>\n\u003Cp>很多人装 Codex，是卡在第一步的。\u003C/p>\n\u003Cp>不是不会装，是\u003Cstrong>卡在那张信用卡上\u003C/strong>。\u003C/p>\n\u003Cp>官方客户端下下来了，打开一看要登录，登录完发现要 GPT Plus。然后就是绕不完的圈：支付方式、网络环境、封号风险……工具还没用上，先耗掉一个晚上。\u003C/p>\n\u003Cp>这篇讲的就是绕开这一整套：\u003Cstrong>Codex 客户端 + 国产大模型 + 一个中间层\u003C/strong>，不用开 Plus，不用外网，不用信用卡。\u003C/p>\n\u003Cp>Mac 和 Windows 我都走一遍，跟着做就行。\u003C/p>\n\u003Chr>\n\u003Ch2>先说清楚：为什么必须有 CC Switch\u003C/h2>\n\u003Cp>这一段别跳过。它决定了你后面配置的时候，会不会一脸懵。\u003C/p>\n\u003Cp>Codex 和国产大模型，其实\u003Cstrong>说的不是一种话\u003C/strong>。\u003C/p>\n\u003Cp>Codex 这边用的是 \u003Cstrong>Responses API\u003C/strong>，国产模型这边用的是 \u003Cstrong>Chat Completions API\u003C/strong>。这是两套不同的接口协议——你把 GLM 的地址直接填进 Codex，两边根本对不上话。\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_01_bridge_9852e472f4.png\" alt=\"Codex 与国产模型说的不是一种接口方言，CC Switch 是中间的翻译层\">\u003C/p>\n\u003Cp>\u003Cstrong>CC Switch 就是中间那个翻译。\u003C/strong>\u003C/p>\n\u003Cp>所以它不是"可装可不装"的加速工具、也不是什么可选优化项，它是\u003Cstrong>必需的一层\u003C/strong>。这句话先记住，等下配置到关键那一步你就明白了。\u003C/p>\n\u003Chr>\n\u003Ch2>开始之前，准备三样东西\u003C/h2>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_02_prep_052129df98.png\" alt=\"准备三样东西\">\u003C/p>\n\u003Cp>\u003Cstrong>第一，Codex 桌面客户端。\u003C/strong>（现在已经并入 ChatGPT 客户端，Mac 和 Windows 都有）\u003C/p>\n\u003Cp>**第二，一个国产大模型的 API Key + base_url。**这是模型厂商给你的"原材料"，官方直连或中转站都行，我这里用智谱 GLM 演示。\u003C/p>\n\u003Cp>**第三，CC Switch。**上面刚讲过，翻译层。\u003C/p>\n\u003Cp>三样备齐再往下看，不然中间会卡。\u003C/p>\n\u003Chr>\n\u003Ch2>Mac 安装\u003C/h2>\n\u003Cp>\u003Cstrong>下载地址\u003C/strong>：\u003Ca href=\"https://openai.com/zh-Hans-CN/codex/\">https://openai.com/zh-Hans-CN/codex/\u003C/a>\u003C/p>\n\u003Cp>进官网，点 macOS 版本下载，按提示一步步装完。\u003C/p>\n\u003Cp>装完打开，会提示你登录。\u003C/p>\n\u003Cp>\u003Cstrong>这里直接把它关掉。\u003C/strong>\u003C/p>\n\u003Cp>这一步反直觉，但没错——我们不走官方登录那条路，账号体系等下由 CC Switch 接管。你现在登录反而白费劲。\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_03_mac_login_9300cc5256.png\" alt=\"Mac 安装完成后提示登录\">\u003C/p>\n\u003Chr>\n\u003Ch2>Windows 安装\u003C/h2>\n\u003Cp>\u003Cstrong>下载地址\u003C/strong>：\u003Ca href=\"https://openai.com/zh-Hans-CN/codex/%EF%BC%88%E5%92%8C\">https://openai.com/zh-Hans-CN/codex/（和\u003C/a> Mac 同一个页面）\u003C/p>\n\u003Cp>Windows 这边流程一样，但有两个地方不同，单独说。\u003C/p>\n\u003Cp>\u003Cstrong>第一，它会把你引到微软商店下载。\u003C/strong>\u003C/p>\n\u003Cp>\u003Cstrong>第二，如果商店打不开、或者下载特别慢，试试切换一下网络环境。\u003C/strong>\u003C/p>\n\u003Cp>这个坑挺反直觉的：平时你挂着代理软件是为了访问更顺，但微软商店在这种情况下反而经常卡住。把代理关掉、或者换成手机热点，速度立刻就正常了。\u003C/p>\n\u003Cp>装完打开，同样会提示登录，\u003Cstrong>同样直接关掉\u003C/strong>。\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_04_win_store_4f26ed9b69.png\" alt=\"Windows 微软商店下载\">\u003C/p>\n\u003Chr>\n\u003Ch2>配置 CC Switch（关键部分）\u003C/h2>\n\u003Cp>\u003Cstrong>下载地址\u003C/strong>：\u003Ca href=\"https://ccswitch.io/zh/\">https://ccswitch.io/zh/\u003C/a>\u003C/p>\n\u003Cp>进 CC Switch 官网，下载安装，打开。\u003C/p>\n\u003Cp>\u003Cstrong>① 进 OpenAI 选项卡，添加供应商\u003C/strong>\u003C/p>\n\u003Cp>点顶部的 Tab 切到 \u003Cstrong>OpenAI\u003C/strong> 这一栏，然后点右上角的「\u003Cstrong>添加新供应商\u003C/strong>」。\u003C/p>\n\u003Cp>在列表里选你要用的国产大模型，我这里选\u003Cstrong>智谱 GLM\u003C/strong>。\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_05_add_provider_c7b2552027.png\" alt=\"CC Switch 添加新供应商\">\u003C/p>\n\u003Cp>\u003Cstrong>② base_url 不用管，只填 API Key\u003C/strong>\u003C/p>\n\u003Cp>往下滑你会发现，\u003Cstrong>base_url 它已经帮你预设好了\u003C/strong>，不需要单独配置。\u003C/p>\n\u003Cp>只需要填 API Key。\u003C/p>\n\u003Cp>点「获取 API Key」，它会跳转到对应的官网。登录，创建一个自己的 API Key，复制。\u003C/p>\n\u003Cp>回到 CC Switch 粘贴进去。\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_06_apikey_05bfdb5d0c.png\" alt=\"填入 API Key，API 请求地址已预设好\">\u003C/p>\n\u003Cp>可以看到「API 请求地址」这一栏它已经填好了（智谱这里是 \u003Ccode>https://open.bigmodel.cn/api/coding/paas/v4\u003C/code>），下面还有一行提示：\u003Cstrong>填写兼容 OpenAI Response 格式的服务端点地址\u003C/strong>——这正好印证了开头讲的接口方言问题。\u003C/p>\n\u003Cp>\u003Cstrong>③ 获取模型列表，选模型\u003C/strong>\u003C/p>\n\u003Cp>继续往下滑，点「\u003Cstrong>获取模型列表\u003C/strong>」。\u003C/p>\n\u003Cp>它会把这个 API Key 关联的\u003Cstrong>所有文本大模型\u003C/strong>都列出来。我这里选 \u003Cstrong>GLM-5.2\u003C/strong>。\u003C/p>\n\u003Cp>再往下，点「添加」保存。\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_07_models_8c23a7cd0f.png\" alt=\"获取模型列表\">\u003C/p>\n\u003Cp>\u003Cstrong>④ 打开路由开关 —— 这一步最容易漏\u003C/strong>\u003C/p>\n\u003Cp>前面说过，国产大模型的接口格式和 Codex 那套不一致，所以需要 CC Switch 这个中间代理层来翻译。\u003C/p>\n\u003Cp>保存完回到列表页，你会看到两张卡片的标签\u003Cstrong>完全不一样\u003C/strong>：\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_08_route_entry_66a4041a32.png\" alt=\"Zhipu GLM 标「需要路由」，OpenAI Official 标「不支持路由」；设置入口在左上角齿轮\">\u003C/p>\n\u003Cul>\n\u003Cli>\u003Cstrong>OpenAI Official\u003C/strong> 标的是「\u003Cstrong>不支持路由\u003C/strong>」——它本来说的就是 Codex 听得懂的话，不用翻译\u003C/li>\n\u003Cli>\u003Cstrong>Zhipu GLM\u003C/strong> 标的是「\u003Cstrong>需要路由\u003C/strong>」——得经过翻译才能和 Codex 对上话\u003C/li>\n\u003C/ul>\n\u003Cp>这一个标签之差，就是开头那段话的全部意思。\u003C/p>\n\u003Cp>\u003Cstrong>点左上角的设置齿轮 → 选择「路由」→ 打开路由总开关 → 再打开 Codex 那个开关。\u003C/strong>\u003C/p>\n\u003Cp>打开之后，你会看到下面显示：\u003Cstrong>它给你开了一个本地的代理\u003C/strong>。\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_09_router_876ab13bd6.png\" alt=\"开启路由：路由总开关运行中，Codex 开关已打开，服务地址 127.0.0.1:15721\">\u003C/p>\n\u003Cp>注意看几个地方：\u003C/p>\n\u003Cul>\n\u003Cli>\u003Cstrong>路由总开关\u003C/strong>要处于「运行中」\u003C/li>\n\u003Cli>下面「路由启用」里有 Claude / \u003Cstrong>Codex\u003C/strong> / Gemini 三个，\u003Cstrong>只需要打开 Codex 这个\u003C/strong>（这就是在给上面那张标着「需要路由」的卡片接上翻译）\u003C/li>\n\u003Cli>打开后右上角会弹「codex 路由已启用」\u003C/li>\n\u003Cli>最下面的\u003Cstrong>服务地址\u003C/strong>，就是它给你开的本地代理：\u003Ccode>http://127.0.0.1:15721\u003C/code>\u003C/li>\n\u003C/ul>\n\u003Cp>到这里，整个配置就完成了。\u003C/p>\n\u003Cblockquote>\n\u003Cp>补充一句原理：路由开关打开后，CC Switch 会自动接管翻译，并把 Codex 配置里的地址改写成上面这个本地端口。所以你在 Codex 配置文件里看到的 base_url，\u003Cstrong>不是 GLM 的地址，是本机的 15721 端口\u003C/strong>——这是路由生效后的结果，不需要你手动去填。\u003C/p>\n\u003Cp>另外这里还有一行小字提醒：\u003Cstrong>改地址或端口后要重启路由服务才生效\u003C/strong>，别改完发现没反应。\u003C/p>\n\u003C/blockquote>\n\u003Chr>\n\u003Ch2>回到 Codex，验证能不能干活\u003C/h2>\n\u003Cp>打开 Codex 客户端，先进引导页，按自己的需求选就行。\u003C/p>\n\u003Cp>进去之后看\u003Cstrong>右下角的模型名称\u003C/strong>——已经变成你在 CC Switch 里配置的那个名字了。这就说明通了。\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_10_model_name_f98fa0dcc3.png\" alt=\"Codex 右下角显示配置的模型\">\u003C/p>\n\u003Cp>插件、技能，还有「已安排」里的定时任务、新建任务——\u003Cstrong>Codex 客户端的所有功能都能正常用\u003C/strong>，没有阉割。\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_11_plugins_skills_1ef42b2208.png\" alt=\"插件和技能都能正常使用\">\u003C/p>\n\u003Cp>光看配置成功没意义，\u003Cstrong>得跑个真任务\u003C/strong>。\u003C/p>\n\u003Cp>我输入了一句：\u003C/p>\n\u003Cblockquote>\n\u003Cp>帮我做一个 todo list 的桌面 HTML，放到桌面上\u003C/p>\n\u003C/blockquote>\n\u003Cp>Codex 接到请求后，会通过 CC Switch 调用我们配置的 GLM-5.2 来执行。\u003C/p>\n\u003Cp>跑完了。直接点生成的 HTML 超链接，会用 \u003Cstrong>Codex 内置的浏览器\u003C/strong>打开。\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_12_todo_demo_ba3720f734.png\" alt=\"生成的 todo list\">\u003C/p>\n\u003Cp>在里面加了两个任务、勾了完成、切了日间/夜间模式——\u003Cstrong>整个完成度还是可以的\u003C/strong>。\u003C/p>\n\u003Cp>到这儿，你的 Codex 就能正常干活了。\u003C/p>\n\u003Chr>\n\u003Ch2>装完之后，你大概率会撞的第一堵墙\u003C/h2>\n\u003Cp>还有件事得提前说，不然你迟早要踩。\u003C/p>\n\u003Cp>\u003Cstrong>你上传一张图片让它识别，或者点「注释模式」，会发现它直接报错。\u003C/strong>\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_13_image_error_3000fb8302.png\" alt=\"粘图后报 HTTP 400\">\u003C/p>\n\u003Cp>报错原文长这样：\u003C/p>\n\u003Cpre>\u003Ccode>CC Switch local proxy failed while handling Codex endpoint /responses.\nProvider: Zhipu GLM; model: glm-5.2; upstream_status: HTTP 400;\ncause: messages.content.type 参数非法，取值范围 ['text']\n\u003C/code>\u003C/pre>\n\u003Cp>翻译成人话：\u003Cstrong>你发过去的内容里有"图片"这个类型，但上游只认"文本"。\u003C/strong>\u003C/p>\n\u003Cp>所以这不是你配错了。大多数情况下，原因是——\u003Cstrong>你用的是文本大模型，不是多模态大模型。\u003C/strong>\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_14_model_modality_75ab16536e.png\" alt=\"不是每家都支持图片\">\u003C/p>\n\u003Cul>\n\u003Cli>\u003Cstrong>Qwen 3.6\u003C/strong> —— 全能型，文本、图像、音频、视频都支持\u003C/li>\n\u003Cli>\u003Cstrong>Kimi 2.6\u003C/strong> —— 超长文本 + 视觉理解\u003C/li>\n\u003Cli>\u003Cstrong>GLM-5.2\u003C/strong> —— 我用的这个，\u003Cstrong>只支持文本\u003C/strong>\u003C/li>\n\u003C/ul>\n\u003Cp>粘图报错，是模型本身的能力边界，不是配置问题。\u003C/p>\n\u003Cp>那有没有解？有。\u003C/p>\n\u003Cp>如果你和我一样开通了国内大模型的 \u003Cstrong>coding plan 套餐\u003C/strong>（主要是冲着 token 给得多去的），先去看看你开通的厂商\u003Cstrong>有没有赠送视觉理解 MCP\u003C/strong>。\u003C/p>\n\u003Cp>以智谱为例，官方 FAQ 里写得很清楚：\u003Cstrong>Lite / Pro / Max 三档套餐都能调用视觉理解 MCP\u003C/strong>，只是额度不同——Lite 只给少量额度尝鲜，Pro 和 Max 的联网搜索/网页读取/开源仓库 MCP 分别是每月 1 千次和 4 千次。\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_15_glm_plan_mcp_5e12ef6c94.png\" alt=\"智谱套餐对视觉理解 MCP 的支持情况\">\u003C/p>\n\u003Cp>也就是说，\u003Cstrong>只要你开了套餐，这个能力大概率你本来就有，只是没配上。\u003C/strong>\u003C/p>\n\u003Cp>配好之后是这个效果——同样是丢一张图进去让它识别，这次它调用了视觉 MCP，把图里的内容一条条讲了出来：\u003C/p>\n\u003Cp>\u003Cimg src=\"https://aigongsheng.com/uploads/codex_install_16_vision_success_3cfc3baa26.png\" alt=\"配置视觉理解 MCP 后，成功识别图片内容\">\u003C/p>\n\u003Cp>\u003Cstrong>视觉理解 MCP + CC Switch\u003C/strong>，就能把识图能力补回来。\u003C/p>\n\u003Cp>这个配置过程有点绕，\u003Cstrong>下一期专门讲\u003C/strong>。\u003C/p>\n\u003Chr>\n\u003Ch2>最后\u003C/h2>\n\u003Cp>到这里，你应该已经有一个能正常干活的 Codex 了：不用 GPT Plus，不用外网，不用信用卡。\u003C/p>\n\u003Cp>下期讲怎么把识图能力补上——这个解法是通用的，不只 GLM，Qwen、DeepSeek 一样能用。\u003C/p>\n\u003Cp>我是 AI 共生阁，我们下期见。\u003C/p>\n\u003Chr>\n\u003Cp>\u003Cstrong>本文相关链接\u003C/strong>\u003C/p>\n\u003Cul>\n\u003Cli>\u003Cstrong>Codex 官网下载\u003C/strong>（Mac / Windows）：\u003Ca href=\"https://openai.com/zh-Hans-CN/codex/\">https://openai.com/zh-Hans-CN/codex/\u003C/a>\u003C/li>\n\u003Cli>\u003Cstrong>CC Switch 官网下载\u003C/strong>：\u003Ca href=\"https://ccswitch.io/zh/\">https://ccswitch.io/zh/\u003C/a>\u003C/li>\n\u003Cli>\u003Cstrong>智谱 GLM 开放平台\u003C/strong>（拿 API Key）：\u003Ca href=\"https://open.bigmodel.cn\">https://open.bigmodel.cn\u003C/a>\u003C/li>\n\u003Cli>\u003Cstrong>AI 共生阁博客\u003C/strong>（图文教程合集）：\u003Ca href=\"https://aigongsheng.com\">https://aigongsheng.com\u003C/a>\u003C/li>\n\u003C/ul>\n\n\u003C/div>\u003C/p>","Up Spark","AI编程",[12,13,14,10,15],"Codex","CC Switch","GLM","安装教程","📝",0,false,"2026-08-01","2026-08-01T00:54:47.751Z","2026-08-01T01:22:21.661Z","2026-08-01T01:22:21.676Z","codex-install-domestic-llm",1785547362805]