Codex 结合 CCSwitch 配置指南（Windows / Mac 双端）
配置 Codex 客户端时，很多用户会遇到一个尴尬的局面：官方 API 固然稳定，但灵活性不足，模型选择受限，想换个模型还得重新折腾环境。
先描述一下默认情况下的痛点：Codex 默认只认官方 API，第三方转发基本没戏；模型配置死板，没法灵活切换；加上 Windows 和 Mac 的配置方式差异不小，手动折腾时稍不注意就会翻车。
所以，核心思路很明确：通过 CCSwitch 这类工具，把 Codex 和兼容 OpenAI 接口的第三方 API 桥接起来，统一管理模型与配置，让 Codex 读取本地配置文件后直接启动。下面直接上实操流程。
准备工作：下载两个核心工具
先把东西备齐。第一步，下载 Codex 客户端，官网地址是 https://codexdown.cn/。第二步，下载 CCSwitch，夸克网盘链接：https://pan.quark.cn/s/1345770b19d5。
注册第三方 API 并创建 Key
接下来需要一个兼容 OpenAI 接口的第三方平台。以 aisz API 为例：访问 https://api.aisz.mom/sign-up?aff=5kRW 注册并登录。然后进入 https://api.aisz.mom/keys，点击“创建 API 密钥”，选择对应分组后保存生成的 Key。
⚠️ 注意：API Key 务必保密，泄露后不仅额度可能被刷，账号也会异常。
CCSwitch 配置 Codex：最快方案
在 CCSwitch 中添加 OpenAI 兼容接口。Base URL 填 https://api.aisz.mom/v1，API Key 填入刚才生成的 Key。然后配置模型名称，模型名一定要和你从模型广场（https://api.aisz.mom/pricing）选择的保持一致。
需要注意一点：这个模型必须在 Key 对应的分组内可用，否则会报 403 或 model not found。
配置完成后，在 CCSwitch 里选择模型并保存，然后重启 Codex 客户端，或者在终端执行 codex 命令启动。
手动配置 Codex（核心步骤，CCSwitch 不生效时使用）
如果 CCSwitch 配置后不生效，或者你更喜欢纯手动方式，可以按下面的流程来。
1. 找到配置目录
- Windows：路径为
此电脑 > Windows > 用户 > 用户名 > .codex - MacOS：路径为
~/.codex
2. 创建两个文件
在 .codex 目录下，新建 auth.json 和 config.toml 两个文件。
3. auth.json 配置
写入：
{"OPENAI_API_KEY": "sk-替换成你的key"}
4. Windows 版 config.toml
model_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 = "elevated"
5. Mac 版 config.toml
model = "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
关键注意点
- 模型必须三者匹配：CCSwitch 中设置的模型名、API 分组权限、pricing 页面列出的模型名，必须完全一致。任何一处不一致都会导致启动失败。
- API Key 安全：这是底线。泄露后额度被刷、账号异常、模型不可用都是概率问题。
- Windows 常见问题：如果启动不了，先检查
.codex路径是否正确，再确认 toml 文件后缀名不是 .txt，最后重启终端或系统试试。
常见问题排查（FAQ）
Q1：codex 启动报错 model not found？
大概率是模型名写错，或者 Key 所在分组不支持该模型。
Q2：CCSwitch 不生效？
先检查 base_url 是否填写正确，然后重启 Codex，必要时清理旧 config 重新配置。
Q3：Mac 无法读取配置？
确认路径是 ~/.codex，并且文件后缀必须是 .toml，不能是其他格式。
总结
这套方案的核心价值在于：它打破了官方 API 的封闭生态，让模型选择权回到了用户手中。无论是 Windows 还是 Mac，配置文件高度统一、可以轻松迁移，切换模型也只是一行配置的事。
这么说吧，一旦配置好，后续的灵活性会让你觉得之前的折腾都值了。
