Codex CCSwitch配置教程Windows/Mac关键词Codex配置教程、CCSwitch使用方法、Codex API设置、OpenAI兼容接口配置、aisz API接入、Codex客户端启动大家好 这里是「代码简单说,欢迎大家关注同名公众号,不定时更新更多实用有趣的教程 也欢迎大家在评论区一起讨论交流!~V1原始方案问题说明在默认情况下Codex 客户端通常存在以下几个问题只能使用官方 API不支持第三方转发模型配置不灵活无法快速切换不同模型Windows / Mac 配置差异较大手动配置容易出错因此需要通过CCSwitch OpenAI兼容API的方式进行统一管理。V2整体实现方案核心思路如下使用第三方平台提供 OpenAI 兼容 API通过 CCSwitch 管理模型与配置Codex 读取本地配置文件启动Windows / Mac 分开配置适配一、准备工具1. Codex客户端下载https://codexdown.cn/2. CCSwitch下载夸克工具下载地址CCSwitchhttps://pan.quark.cn/s/1345770b19d5二、注册并创建 API Key1. 注册账号访问https://api.aisz.mom/sign-up?aff5kRW注册并完成登录。2. 创建 API Key进入https://api.aisz.mom/keys操作步骤点击「创建 API 密钥」选择对应分组保存配置⚠️ 注意API Key 请勿泄露。三、CCSwitch 配置 Codex1. 添加配置在 CCSwitch 中添加 OpenAI 兼容接口Base URL 设置https://api.aisz.mom/v1API Key 填入刚刚生成的 key2. 模型名称配置将模型名称统一改为你在模型广场选择的模型名模型列表查看https://api.aisz.mom/pricing注意模型必须在 key 对应分组内可用否则会报 403 或 model not found3. 启动方式配置完成后点击 CCSwitch → 选择模型保存重启 Codex 客户端或终端执行codex四、手动配置 Codex核心如果 CCSwitch 不生效可以手动配置。1. 配置目录Windows此电脑 Windows 用户 用户名 .codexMacOS~/.codex2. 创建文件在.codex目录下创建两个文件auth.jsonconfig.toml如果已有旧文件建议删除后重新创建3. auth.json 配置{OPENAI_API_KEY:sk-替换成你的key}4. Windows 配置config.tomlmodel_provider OpenAI model gpt-5.5 review_model gpt-5.5 model_reasoning_effort xhigh disable_response_storage true network_access enabled windows_wsl_setup_acknowledged true model_context_window 400000 model_auto_compact_token_limit 320000 [model_providers.OpenAI] name abc base_url https://api.aisz.mom/v1 wire_api responses requires_openai_auth true [windows] sandbox elevated5. Mac 配置config.tomlmodel gpt-5.5 review_model gpt-5.5 model_provider abc model_reasoning_effort xhigh openai_base_url https://api.aisz.mom/v1 model_context_window 400000 model_auto_compact_token_limit 320000 approval_policy on-request sandbox_mode workspace-write [sandbox_workspace_write] network_access true五、关键注意点1. 模型必须匹配CCSwitch 模型名API 分组权限pricing 页面模型三者必须一致。2. API Key 不可泄露泄露后可能导致额度被刷账号异常模型不可用3. Windows 常见问题如果无法启动检查.codex路径是否正确确认 toml 后缀不是 txt重启终端或系统六、常见问题排查FAQQ1codex 启动报错 model not found通常是模型名写错key 分组不支持该模型Q2CCSwitch 不生效检查 base_url 是否正确重启 Codex清理旧 configQ3Mac 无法读取配置确认路径为~/.codex文件必须是.toml后缀七、总结该方案本质是用 CCSwitch 做“模型路由层”Codex 做“执行端”aisz API 做“兼容中间层”。优点可切换模型兼容 OpenAI 接口Windows / Mac 通用配置可迁移如果你需要我可以再帮你做一版CCSwitch 可视化配置图解版Codex Claude / GPT 双模型切换方案或者 Docker 一键部署版本