CodexApp桌面端设置

使用 SimiRouter API Key 登录 Codex 桌面端，并通过用户级 config.toml 接入 Responses 接口。

Codex 桌面端支持使用 API Key 登录，并允许在应用内打开用户级 config.toml。完成以下配置后，Codex 会通过 SimiRouter 的 Responses 兼容接口发起请求。

登录界面的字段名称仍会显示为 OpenAI API key。请在这里填写你的 SimiRouter API Key，例如 sk-...。

前置条件

开始之前，请确认你已经准备好：

最新版 Codex 桌面端
SimiRouter 账户
在 SimiRouter 控制台创建的 API Key
当前账户可以使用准备配置的模型

配置步骤

1. 使用 API Key 登录

打开 Codex 桌面端。
在登录页面选择 Sign in another way。
在 OpenAI API key 输入框中填写你的 SimiRouter API Key。
选择 Continue 进入应用。

在 Codex 桌面端中填写 API Key

2. 打开用户级配置文件

进入 Codex 设置页面。
在左侧选择 Configuration。
在 Custom config.toml settings 中选择 User config。
选择 Open config.toml，打开用户级配置文件。

在 Codex 桌面端中打开用户级 config.toml

3. 写入 SimiRouter 配置

将以下内容写入 config.toml。如果文件中已有其他配置，请保留仍需使用的 MCP、项目信任和权限设置，只替换模型与供应商相关字段。

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"
context_window = 1000000
max_context_window = 1000000
auto_compact_token_limit = 900000
model_context_window = 1000000
model_auto_compact_token_limit = 900000
approval_policy = "never"
sandbox_mode = "danger-full-access"
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密钥"
[features]
goals = true
remote_connections = true

保存文件后，完全退出并重新打开 Codex 桌面端。

API Key 已通过登录流程保存，不需要再次写入 config.toml。requires_openai_auth = true 会让 SimiRouter 供应商复用该登录认证。

验证配置

重新打开 Codex 后：

打开一个项目或工作区。
让 Codex 执行一次真实的代码任务，例如解释当前文件、修改一小段代码或运行项目测试。
如果任务可以正常执行并返回结果，说明配置已经生效。

常见问题

API Key 无效

从 SimiRouter 控制台重新复制完整的 API Key。
检查 API Key 前后是否有多余空格。
确认 API Key 以 sk- 开头且仍然有效。

配置没有生效

确认修改的是 User config 下打开的 config.toml。
确认 model_provider = "SimiRouter" 与 [model_providers.SimiRouter] 名称完全一致。
保存文件后完全退出应用，而不是只关闭当前窗口。

模型或连接错误

确认 base_url 为 https://api.dwchainless.com/v1。
确认 wire_api 为 responses。
确认当前 API Key 所在分组可以使用 gpt-6-astra；如需使用其他模型，请将 model 替换为对应模型名称。

如需手动配置 auth.json、切换模型或使用命令行版本，请查看 Codex CLI 配置。

官方参考

OpenAI Codex 配置参考

CodexApp桌面端设置

目录