Codex + CCSwitch配置教程（Windows/Mac）
关键词：Codex配置教程、CCSwitch使用方法、Codex API设置、OpenAI兼容接口配置、aisz API接入、Codex客户端启动
原始方案问题说明
在默认情况下，Codex 客户端通常存在以下几个问题：
- 只能使用官方 API，不支持第三方转发
- 模型配置不灵活
- 无法快速切换不同模型
- Windows / Mac 配置差异较大，手动配置容易出错
因此需要通过 CCSwitch + OpenAI兼容API 的方式进行统一管理。
V2：整体实现方案
核心思路如下：
- 使用第三方平台提供 OpenAI 兼容 API
- 通过 CCSwitch 管理模型与配置
- Codex 读取本地配置文件启动
- Windows / Mac 分开配置适配
一、准备工具
1. Codex客户端下载
2. CCSwitch下载（夸克）
| 工具 | 下载地址 |
|---|---|
| CCSwitch | https://pan.quark.cn/s/1345770b19d5 |
二、注册并创建 API Key
1. 注册账号
访问：
https://api.aisz.mom/sign-up?aff=5kRW
注册并完成登录。
2. 创建 API Key
进入：
https://api.aisz.mom/keys
操作步骤：
- 点击「创建 API 密钥」
- 选择对应分组
- 保存配置
⚠️ 注意：API Key 请勿泄露。
三、CCSwitch 配置 Codex
1. 添加配置
在 CCSwitch 中：
- 添加 OpenAI 兼容接口
- Base URL 设置：
https://api.aisz.mom/v1
- API Key 填入刚刚生成的 key
2. 模型名称配置
将模型名称统一改为：
你在模型广场选择的模型名
模型列表查看：
https://api.aisz.mom/pricing
注意：
- 模型必须在 key 对应分组内可用
- 否则会报 403 或 model not found
3. 启动方式
配置完成后：
- 点击 CCSwitch → 选择模型
- 保存
- 重启 Codex 客户端
- 或终端执行：
codex
四、手动配置 Codex（核心）
如果 CCSwitch 不生效，可以手动配置。
1. 配置目录
Windows
此电脑 > Windows > 用户 > 用户名 > .codex
MacOS
~/.codex
2. 创建文件
在 .codex 目录下创建两个文件：
auth.jsonconfig.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
五、关键注意点
1. 模型必须匹配
- CCSwitch 模型名
- API 分组权限
- pricing 页面模型
三者必须一致。
2. API Key 不可泄露
泄露后可能导致：
- 额度被刷
- 账号异常
- 模型不可用
3. Windows 常见问题
如果无法启动：
- 检查
.codex路径是否正确 - 确认 toml 后缀不是 txt
- 重启终端或系统
六、常见问题排查（FAQ）
Q1：codex 启动报错 model not found？
通常是：
- 模型名写错
- key 分组不支持该模型
Q2：CCSwitch 不生效？
- 检查 base_url 是否正确
- 重启 Codex
- 清理旧 config
Q3：Mac 无法读取配置？
- 确认路径为
~/.codex - 文件必须是
.toml后缀
七、总结
该方案本质是：
用 CCSwitch 做“模型路由层”，Codex 做“执行端”，aisz API 做“兼容中间层”。
优点：
- 可切换模型
- 兼容 OpenAI 接口
- Windows / Mac 通用
- 配置可迁移
如果你需要，我可以再帮你做一版：
- CCSwitch 可视化配置图解版
- Codex + Claude / GPT 双模型切换方案
- 或者 Docker 一键部署版本
