1. Windows 上装 Codex 到底卡在哪如果你刚在 Windows 上接触 Codex大概率会遇到一个很别扭的局面应用装好了但登录、模型、接口地址这几件事全绑在一起想换一套 API 就得重新折腾一遍。Codex 本身是 OpenAI 推出的编码助手能在对话里读写代码、跑命令、解释报错适合日常写脚本、改项目、排查构建问题的开发者。问题在于很多人手里不只有一套 API 配置可能公司一套、自己测试一套来回切换时如果每次都手动改配置文件很容易把 Key 和地址搞混。我试过直接在 Codex 里硬填一套配置结果换环境时忘了改回来请求一直打到错误的地址上排查了半天才发现是配置没切。后来用 CC Switch 把多套 API 配置管起来切换变成点一下的事settings.json 也有了固定骨架整个流程才顺下来。这篇就按 Windows 初次部署的角度把安装、CC Switch 配置、settings.json 骨架、最小验证请求这条链路讲清楚你跟着做就能跑通。核心检索词先摆出来Windows 安装 Codex、Codex 接入自己的 API、CC Switch 配置、settings.json 骨架。适合谁适合在 Windows 上第一次部署 Codex、手里已经有兼容 API 的开发者尤其是需要同时维护多套配置的人。2. 装 Codex 之前先把 CC Switch 准备好Codex 在 Windows 上可以通过微软商城获取搜索 ChatGPT 或 Codex 就能找到目前两者已经合并成同一个应用。安装完成后先别急着启动因为默认它会走官方登录流程而你如果打算接自己的 API最好先把 CC Switch 装好避免第一次启动就写进一堆默认配置。CC Switch 的作用可以理解成一个「配置开关盒」它不替代 Codex也不替代你的 API 服务只负责在多个供应商配置之间做切换。你可以在里面存官方登录、存自建 API、存不同模型的组合切换时 Codex 读到的就是当前选中的那套。安装 CC Switch 时从官方渠道下载装完打开先点左上角设置建议开启两个选项非接管切换时保留官方登录、统一 Codex 会话历史。这两个选项的意义在于你在官方账号和自定义 API 之间来回切时登录状态和历史对话不会丢省去反复登录的麻烦。这里要提醒一句API Key 属于敏感信息不要截图发群也不要写进会被提交到 Git 的明文文件里。后面 settings.json 骨架里我会用占位符你替换成自己的真实值即可。3. settings.json 骨架与 CC Switch 切换步骤这一节是整篇的核心分两部分先给可复制的 settings.json 骨架再讲 CC Switch 里怎么把配置填进去并切换。3.1 可复制的 settings.json 骨架Codex 的配置通常落在用户目录下的配置文件中Windows 上一般在%USERPROFILE%\.codex\这类路径下。下面是一个通用骨架字段名以你实际使用的版本为准重点是结构{ model: your-model-name, api_key: sk-xxxxxxxxxxxxxxxx, base_url: https://taotoken.net/api, provider: custom, timeout: 60, max_tokens: 4096 }几个字段说明一下。model填服务商实际支持的模型名不要凭感觉写api_key填你申请到的密钥base_url填接口地址一般以/v1或服务商给的路径为准TaoToken 的 API 地址是https://taotoken.net/api注意这里不加任何多余参数timeout和max_tokens按需调整初次验证可以先保守一点。如果你要管理多套配置不建议把所有内容塞进同一个文件而是让 CC Switch 去管多份Codex 只读当前激活的那份。这样切换时不会互相污染。3.2 CC Switch 添加供应商打开 CC Switch回到首页先点顶部的 Codex 图标再点右上角的进入「添加新供应商」。选择「自定义配置」然后填字段填写内容说明供应商名称自定义如 tao-codex方便自己识别API Key你的密钥敏感信息勿外泄API 请求地址服务商接口地址以实际为准默认模型服务商支持的模型名不要写错填完展开「高级选项」点「获取模型列表」。能正常读取到模型说明 Key 和地址基本没问题点右下角「添加」保存。如果读不到先别急着反复点按下一节的排查顺序来。3.3 切换并让 Codex 生效回到 CC Switch 首页选中刚添加的供应商。必要时重启 Codex让它重新读取配置。然后新建一个对话发一条最小请求比如「你好」。能正常回复就说明安装和接入都通了。如果你需要长期在编码场景里用建议把常用配置固定成一个 Coding Plan 式的组合减少每次切换的成本。TaoToken 的 Coding Plan 入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content适合需要稳定跑编码任务的场景。4. 用一条最小请求验证接入是否生效验证这一步很多人会跳过结果后面出问题不知道是配置错还是网络错。最小请求的意义就是把变量降到最少只发一句话看有没有正常返回。操作顺序是这样确认 CC Switch 里当前选中的是你刚加的供应商重启 Codex新建对话发送「你好」。如果返回正常再发一条稍微带点技术含量的比如「用 Python 写一个读取 JSON 文件的函数」看它能不能给出可运行代码。这一步能同时验证模型是否真的可用而不只是接口通。如果你更想先在网页端确认模型对话是否正常可以走模型对话入口https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。在那边发一条消息能回就说明 Key 和模型没问题再回到 Codex 里排查客户端侧。验证通过后建议把这次成功的配置在 CC Switch 里另存一份命名清晰的副本比如「tao-codex-可用」以后换环境时直接切回来不用重新填。5. 本篇常见错排查配置过程中最容易卡在几个固定位置按顺序排查效率最高。第一类获取模型列表失败。先检查 API Key 有没有多余空格很多人复制时会带上首尾空白再检查请求地址是否完整少一段路径就会 404然后确认服务商是否支持当前接口格式有些服务只兼容特定协议最后核对默认模型名是否拼错。第二类Codex 里发消息没反应或报错。先确认 CC Switch 当前选中的供应商是不是你要用的那套切换后没重启 Codex 是高频原因再看 settings.json 里的base_url和 CC Switch 里填的是否一致两处不一致时以实际生效的那份为准。第三类切换后官方登录掉了。这通常是设置里没开「非接管切换时保留官方登录」回去把那个选项打开再切一次。第四类请求超时。把timeout调大一点或者换一个网络时段重试如果一直超时先回到模型对话入口确认服务本身是否可达排除客户端问题。排查时记住一个原则一次只改一个变量。同时改 Key、地址、模型出问题就不知道是谁的锅。6. 配置跑通之后怎么继续用跑通之后日常使用其实就三件事切配置、发请求、看结果。CC Switch 负责切Codex 负责发你负责看。多套配置并存时给每套起一个能一眼看懂的名字比什么都重要。如果你后面要接更多模型或做密钥轮换API Keys 管理入口在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content遇到字段不确定时以文档为准。控制台入口是https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要看用量或调整配置时从那里进。最后给一个实用习惯每次改完 settings.json 或 CC Switch 配置都发一条「你好」验证别攒着一起测。配置这东西越早发现错越省时间。
