Codex App 桌面客户端配置¶

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

注意事项

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

第一步：创建配置文件¶

配置文件位置：

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

创建目录

如果文件夹已存在，建议先删掉里面的 auth.json 和 config.toml 再重新创建，避免旧配置干扰。

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

在 .codex 文件夹里创建两个文件：

auth.json¶

{
  "OPENAI_API_KEY": "这里填入你自己生成的 sk- 开头的密钥"
}

config.toml¶

model = "gpt-5.3-codex"
model_reasoning_effort = "xhigh"
disable_response_storage = true
sandbox_mode = "danger-full-access"
windows_wsl_setup_acknowledged = true
approval_policy = "never"
profile = "auto-max"
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://api.yunxicodes.com"
wire_api = "responses"
requires_openai_auth = true

找不到 .codex 文件夹？

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

配置完成后重新打开 Codex App 即可自动登录使用。

第二步：常见报错¶

401 密钥不正确

配置后发现 401 提示密钥不正确，这一定是没有替换或创建 config.toml 和 auth.json 这两个文件，导致请求的还是 OpenAI 官方而非中转站，或者没有重启工具重新加载配置文件。

解决方案：请再次按照教程创建或替换 config.toml 和 auth.json，然后重启工具即可。

遇到报错怎么办？

如果遇到报错，请一定要截图进行翻译，这样自己也知道是什么原因报错了！