Codex + CCSwitch配置教程（Windows/Mac）Codex + CCSwitch配置教程（Windows/Mac）CCSwitch使用方法、Codex API设置、OpenAI兼容接

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下载（夸克）

二、注册并创建 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.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

五、关键注意点

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 一键部署版本