Codex App 桌面版

配置 Codex App 桌面版使用模融。

Codex App 桌面版

URL: https://mrxapi.com/docs/docs/tools/codex-app

如果你不想安装 Codex CLI，只需使用 CODEX APP 桌面客户端，可参考此方法。

如果之前登录过自己的账号，请先在 CODEX APP 里面退出当前账号，然后再进行重新配置
更换 API 之后，历史对话记录会不存在（因为账号类型的历史对话都是保存在 GPT 账号的空间里，本地是没有的）
更换 API 登录之后以后所有的历史对话记录都会保存在本地，不会丢失！

第一步：创建配置文件

配置文件位置：

Mac/Linux：~ 用户目录下的 .codex 文件夹
Windows：C:\users\你的用户名\.codex\

如果文件夹已经存在，建议先删掉里面的 config.toml（以及旧教程留下的 auth.json），再重新创建，避免旧配置干扰。

使用终端命令创建文件夹：

# Mac/Linux
rm -rf ~/.codex && mkdir ~/.codex

在 .codex 文件夹里创建 config.toml。

config.toml

配置服务提供商，API 密钥写在文件最末尾的请求头里：

model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
sandbox_mode = "danger-full-access"
windows_wsl_setup_acknowledged = true
approval_policy = "never"
file_opener = "vscode"
model_provider = "codex"
web_search = "cached"
suppress_unstable_features_warning = true

[history]
persistence = "save-all"

[tui]
notifications = true

[shell_environment_policy]
inherit = "all"
ignore_default_excludes = false

[sandbox_workspace_write]
network_access = true

[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
unified_exec = false
streamable_shell = false
rmcp_client = true
elevated_windows_sandbox = true

[profiles.auto-max]
approval_policy = "never"
sandbox_mode = "workspace-write"

[profiles.review]
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[notice]
hide_gpt5_1_migration_prompt = true

[model_providers.codex]
name = "codex"
base_url = "https://mrxapi.com"
wire_api = "responses"

[model_providers.codex.http_headers]
Authorization = "Bearer 这里填入后台生成的sk-开头的密钥"

把最后一行换成你的 sk- 密钥，Bearer 和密钥之间保留一个空格；[model_providers.codex.http_headers] 这一段放在文件最末尾，后面不要再接其它配置项。

一般都在用户目录下的 .codex 文件夹内。如果在用户目录下找不到 .codex 文件夹，可以手动创建该文件夹，再手动创建 config.toml 即可。

配置文件内容与 Codex CLI Mac/Linux 配置教程完全一致，可参考该教程在终端中创建，重启 CODEX APP 后同样生效。

第二步：重新打开 CODEX APP

保存配置文件后，重新打开 CODEX APP 就能够自动登录使用了。

启用 1M 上下文（可选）

gpt-5.4 支持 1M token 长上下文，但默认不开启。在上面 config.toml 的顶层（任意 [section] 之前）追加两行，重启 CODEX APP 即可：

model_context_window = 1000000
model_auto_compact_token_limit = 900000

字段含义、验证方法与注意事项详见 Codex 启用 1M 上下文。

常见报错

报错 401 密钥不正确：

原因：请求还是走的 OpenAI 官方，没有请求我们中转站，或者没有重启工具重新加载配置文件。

解决：请再次按教程创建或替换 config.toml，重新打开 APP 即可。

报错 401 API\_KEY\_REQUIRED：

原因：新版 Codex 可能不再读取 auth.json 里的密钥，请求没带上密钥。

解决：按上面的 config.toml 在文件末尾加上 [model_providers.codex.http_headers] 段，详见常见问题 · 问题 10。