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下载(夸克)

工具 下载地址
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.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 一键部署版本
Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐