Codex CLI 配置
通过用户级 config.toml 将 Codex 接入 SimiRouter，说明 Linux、macOS、Windows 的配置与密钥保护。
本页示例通过 config.toml 直接提供令牌。相关文件的位置如下；auth.json 仅供其他认证方式使用：
- Linux / macOS：
~/.codex/config.toml与~/.codex/auth.json - Windows：
%USERPROFILE%\.codex\config.toml与%USERPROFILE%\.codex\auth.json
方式一：一键配置脚本（推荐）
此处保留自动配置脚本入口。运行前请确保已安装并启动过 Codex CLI 或 Codex 桌面端；脚本的实际行为以你审阅的版本为准。
macOS / Linux 用户在终端中执行：
下列命令会下载并立即执行远程脚本。本文未审计当前远程脚本的内容；运行前请先下载、审阅并备份现有的 config.toml 与 auth.json。脚本更新后行为可能变化，不应仅凭本文假定它会保留所有设置或保证请求路由。若不愿执行远程脚本，请使用下面的手动配置。
bash <(curl -fsSL https://ossga.simitalk.chat/n/idpdeuxb29fz/b/bucket-im/o/im-system/codex-simirouter-setup.sh)Windows 用户在 PowerShell 中执行：
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $u = 'https://ossga.simitalk.chat/n/idpdeuxb29fz/b/bucket-im/o/im-system/codex-simirouter-setup.ps1'; $b = (New-Object Net.WebClient).DownloadData($u); if ($b.Length -ge 3 -and $b[0] -eq 0xEF -and $b[1] -eq 0xBB -and $b[2] -eq 0xBF) { $b = $b[3..($b.Length-1)] }; iex ([Text.Encoding]::UTF8.GetString($b))这条命令会下载脚本原始字节、按 UTF-8 解码后再执行，避免 Windows PowerShell 5.1 因编码差异导致中文菜单乱码。若你使用 PowerShell 7（pwsh），也可直接用 irm <脚本地址> | iex。
运行后按菜单选择要使用的模型。首次运行会提示输入 API Key（以 sk- 开头，在 SimiRouter 控制台获取）。
脚本会依次完成以下工作：
- 备份现有配置：将
~/.codex/config.toml备份到~/.codex/backup-simirouter/，随时可以还原。 - 修改
~/.codex/config.toml：只改写必要的字段（model_provider、model、推理与上下文相关参数等），并新增[model_providers.SimiRouter]配置段，指向中转base_url；你原有的 MCP 服务器、项目信任级别等配置全部保留。若存在与 SimiRouter 配置冲突的字段，脚本会删除它们，并逐条打印删除原因。 - 写入
~/.codex/auth.json：脚本说明会将 API Key 写入OPENAI_API_KEY并设置600权限。后续登录可能覆盖此文件；修改后请重新核对当前供应商配置与控制台调用记录，不能只根据文件存在判断实际请求路由。 - 校验：写入前校验
config.toml/auth.json语法合法；校验失败则中止，不修改任何文件。
再次运行脚本可切换模型，或选择「恢复默认配置」用备份还原到安装前的状态。
方式二：Linux / macOS 手动配置（备用）
修改前，分别备份现有的 config.toml 与 auth.json，不要移动或重建整个 ~/.codex 目录，以免影响历史记录、会话与其他配置。只合并供应商及模型字段，不要整份覆盖，也不要重复添加同名 TOML 表；保留已有的 MCP、审批、沙箱与项目信任设置。
~/.codex/config.toml
model_provider = "simirouter"
review_model = "gpt-6-astra"
model = "gpt-6-astra"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "high"
model_reasoning_summary = "auto"
model_verbosity = "high"
personality = "pragmatic"
suppress_unstable_features_warning = true
web_search = "live"
[model_providers.simirouter]
name = "simirouter"
base_url = "https://api.dwchainless.com/v1"
wire_api = "responses"
stream_idle_timeout_ms = 900000
supports_websockets = false
http_headers = { "x-openai-actor-authorization" = "api.dwchainless.com" }
requires_openai_auth = false
experimental_bearer_token="替换为 API密钥"该文件包含明文令牌，请勿提交或分享。Linux / macOS 保存后限制访问：
chmod 600 ~/.codex/config.tomlauth.json（仅其他认证方式需要时）
上方示例使用配置内令牌，已足够提供认证，不需要额外创建或覆盖 auth.json。下方 JSON 仅供需要该文件的其他认证方式参考；请按当前 Codex 版本要求选择一种方式，不要混用来掩盖认证错误。
{
"OPENAI_API_KEY": "替换为 API密钥"
}Windows 配置
PowerShell
创建目录并打开配置文件：
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\config.toml"CMD
if not exist "%USERPROFILE%\.codex" mkdir "%USERPROFILE%\.codex"
notepad "%USERPROFILE%\.codex\config.toml"备份已有配置后，将上方 TOML 的供应商与模型字段合并到 config.toml 并保存；不要覆盖无关设置。该示例使用配置内令牌，无需另外创建或覆盖 auth.json。Windows 请将含密钥文件的访问权限限制为当前用户。
启动验证
codexWindows 下 config.toml 与 auth.json 路径为 %USERPROFILE%\.codex\，请确保文件保存在正确位置。
