Codex 桌面端配置

本页适用于有聊天窗口和设置界面的 Codex 应用。首次使用可以切换到简易模式，选择 Windows 或 macOS，按步骤完成配置。

安装与准备

使用前看一眼：先查模型，再配置

第一步：打开 米醋模型广场，先查看你准备使用的分组支持哪些模型。 设置 model 时请复制该分组显示的完整模型名称，避免模型名称写错或分组不支持导致调用失败。

看不到国外模型时，先开代理（魔法），并启用 TUN（网卡模式），再刷新模型广场和 API Key 创建页面。 仅开启浏览器代理可能无法加载完整分组或模型列表。

CC Switch 使用前，先确认这三项

优选域名无需开启代理（魔法）。如果主站域名无法访问，请开启代理并启用 TUN（网卡模式）；部分地区还需要开启全局模式。

1. 关闭路由模式。CC Switch 的路由模式有时会掩盖真实错误，配置和排障时请先关闭。
2. 不要点击 CCS 的「检测」。米醋不接受 Claude Code / Codex 的 CCS 检测请求。保存并启用配置后，直接打开 Claude Code 或 Codex，发送一条消息验证。
3. 更新 CCS，使用 Micu 预设。将 CC Switch 更新到最新版本，在 CCS 中选择对应框架和 Micu 预设，再填写 API Key。不要依赖米醋站点的「直接导入 CC Switch」功能。

如果出现 401 Unauthorized，且报错地址是 api.openai.com/v1/responses，也可能是旧会话的问题。先新开会话测试。新会话正常时，右键原会话 → 分叉 → 创建聊天分支。如果新会话也报错，再完全退出 ChatGPT / Codex，用最新版 CCS 的 Micu 预设重新配置模型和供应商。详见 配置或旧会话导致 401 的排查步骤。

从 Codex 官方应用入口 获取适合系统的安装说明。安装后打开应用，确认能进入设置。

米醋配置由 CC Switch 写入本机的 Codex 配置文件。CC Switch 中框架选择 Codex，供应商选择 Micu，填写米醋 API Key 并启用配置，然后完全退出并重新打开 Codex 应用。

创建或编辑 API 令牌时，请关闭「模型限制」。Key 只填写在自己的软件中，文档和发给 AI 的配置示例使用 sk-xxx。

支持的模型

列表核对于 2026-09-13。后续以 模型广场 为准。

模型	可用分组	用途
gpt-5.6-sol	vip_2 / vip_2_cc	主会话模型
gpt-6-astra	vip_2 / vip_2_cc	主会话模型
codex-auto-review	vip_2	后台审查模型

配置文件

系统	配置文件	认证文件
Windows	C:\Users\<USERNAME>\.codex\config.toml	C:\Users\<USERNAME>\.codex\auth.json
macOS	~/.codex/config.toml	~/.codex/auth.json

优先使用 CC Switch。手动排障时先备份文件，合并以下字段，保留自己的其他配置。供应商节之前的参数应位于 TOML 顶层。

model_provider = "micu"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.micu]
name = "micu"
base_url = "https://www.micuapi.ai/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json：

{
  "OPENAI_API_KEY": "sk-xxx"
}

审批与会话问题

• 后台审批使用 LUNA 时可能受限，按 审批设置与模型映射 处理。
• 会话异常时，先新开一个会话测试。新会话正常时，在左侧列表中右键原会话 →「分叉」→「创建聊天分支」，进入分支重试。查看图示。

验证配置

重新打开应用，新建会话，发送「请只回复：配置成功」。收到正常回复且没有认证、模型或连接错误后，即可继续使用。

如果仍出现问题，检查 CC Switch 中是否启用了正确配置、令牌分组是否匹配、是否存在覆盖配置的环境变量。完整说明见 Codex 配置参考。