macOS Codex App（官方）说明

这是 OpenAI 官方提供的 Codex App 路线，适合不想先从终端开始的 macOS 用户。

返回 打开官方 Codex 页面 查看 Codex CLI 方案 登录后创建 Codex Key
先说结论：本站当前主支持方案仍是 Codex CLI。Codex App（官方） 可以作为补充入口使用，但官方 App 的界面、配置入口和版本行为后续可能变化，若与 CLI 文档不完全一致，请以官方最新版本为准。

这条路线适合谁

适合
macOS 用户，想先用官方图形界面体验 Codex，不想一开始就手动敲终端命令。
不适合
希望严格按照本站 CLI 文档一步一步接入、复用终端工作流、排查配置细节的用户。这类场景仍建议优先使用 Codex CLI 方案。

和 CLI 路线的关系

CLI 路线
这是本站当前主支持方案，文档最完整，配置行为更容易核对。
App 路线
这是官方图形界面路线，使用起来更直观，但官方后续可能调整界面、入口或配置行为。
Key 是否能复用
通常可以尝试复用你在本站创建的 Codex Key。如果官方 App 当前版本支持读取同一套 ~/.codex 配置，那么与 CLI 共用同一份 Key 是可行的；若官方 App 版本行为变化，请以官方最新版本为准。

推荐操作顺序

1

先在本站创建 Codex Key

先到 Key 管理 创建一个新的 Codex Key，并复制你自己的 你的Codex_API_KEY。

2

打开官方 Codex 页面，按官方方式安装 App

请直接使用官方页面获取最新 App，不建议由本站二次分发安装包，这样能避免版本过旧、签名变化或下载链接失效。

3

优先尝试复用 CLI 的配置文件

如果你已经按本站 CLI 文档配置过 ~/.codex/auth.json 和 ~/.codex/config.toml，官方 App 往往可以尝试直接复用这套配置。

4

如果 App 没读到配置，再去 App 内补 Key / 配置

若官方 App 当前版本没有直接读取成功，再按官方 App 当前界面提示补充 Key 或配置。

如果你想先准备 CLI 共用配置

你可以先按本站 CLI 方案把配置写好，再去打开官方 App。下面是最关键的两份文件。

auth.json
~/.codex/auth.json
{
  "OPENAI_API_KEY": "你的Codex_API_KEY"
}
config.toml
~/.codex/config.toml
model_provider = "codex"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.codex]
name = "codex"
base_url = "https://code.jimuxyz.com/p/v1"
wire_api = "responses"
requires_openai_auth = true

这套配置与本站 CLI 方案保持一致。若官方 App 当前版本支持读取同一套配置，它就能直接复用本站提供的 Key 与转发地址。

为什么不建议本站自己提供 mac 安装包

  • 官方 App 更新较快，二次分发容易变成旧版
  • 官方可能调整签名、下载地址、安装方式或配置行为
  • 由用户直接从官方获取，更容易避免“安装的是旧包还是改过的包”这类疑问
  • 本站当前更适合维护配置说明与 Key 接入，而不是长期托管 App 安装包
打开官方 Codex 页面 查看 Codex CLI 方案 去创建 Codex Key