macOS：Codex 桌面版安装与配置
Codex 桌面版不要求先安装 Node.js。本页介绍 macOS 桌面应用的安装，以及两种 SeqeuenceQ 配置方式。
一、安装或更新 Codex 桌面版
- 打开 OpenAI 官方 Codex 页面，下载最新版 macOS 安装包。
- 打开下载完成的 Codex.dmg。
- 将 Codex 拖入“应用程序”目录。
- 首次启动时，按照 macOS 提示确认打开 OpenAI 官方应用。
- 打开 Codex。
二、找到桌面版配置目录
Codex 桌面版与 CLI 共用当前 macOS 用户目录中的配置：
~/.codex在 Finder 的用户目录中按 Shift + Command + .，可以显示或隐藏以点号开头的目录。如果目录不存在，可以先启动一次 Codex，或手动创建 .codex 目录。
WARNING
修改前请备份已有的 auth.json 和 config.toml。API Key 属于敏感信息，不要截图或公开真实值。
三、选择配置方式
根据是否需要保留 Codex 原有登录状态，选择一种方式即可：
- 免登录配置：不使用 Codex/ChatGPT 账号登录，Codex 从 auth.json 读取 SeqeuenceQ API Key。适合只使用 SeqeuenceQ 的用户。
- 保留 Codex 登录配置：继续保留 Codex/ChatGPT 的登录信息，在 config.toml 中单独填写 SeqeuenceQ API Key。适合需要保留原有登录状态的用户。
IMPORTANT
两种方式不要混用。使用“保留 Codex 登录配置”时，不要再在 auth.json 中保留 OPENAI_API_KEY，否则可能出现认证来源冲突。
四、方式一：免登录配置
1. 配置 auth.json
文件路径：~/.codex/auth.json
{
"auth_mode": "apikey",
"OPENAI_API_KEY": "你的SeqeuenceQ用户Key"
}macOS 的免登录模式需要同时保留 auth_mode = apikey 和 OPENAI_API_KEY。
2. 配置 config.toml
文件路径：~/.codex/config.toml
model_provider = "openai"
openai_base_url = "https://api.sequenceq.com/v1"
model = "gpt-6-astra"
model_context_window = 272000
model_auto_compact_token_limit = 180000
model_reasoning_effort = "high"
service_tier = "default"
generate_memories = false
background_agents = false
requires_openai_auth = true免登录模式不要添加 experimental_bearer_token，API Key 由 auth.json 提供。
五、方式二：保留 Codex 登录配置
这种方式会保留已有的 Codex/ChatGPT 登录状态，同时让当前 provider 使用 SeqeuenceQ API Key。
1. 检查 auth.json
不要删除或覆盖整个 auth.json，也不要修改其中已有的 Codex/ChatGPT 登录字段。只按下面规则处理：
- 如果 auth.json 中存在 OPENAI_API_KEY，删除这一项。
- 如果 auth_mode 的值是 apikey，同时删除 auth_mode；其他 auth_mode 值不要修改。
- 其余登录字段全部保留。
- 如果删除上述字段后文件内容为空，可以删除这个空文件。
2. 配置 config.toml
将你的 SeqeuenceQ API Key 填入 experimental_bearer_token：
model_provider = "openai"
openai_base_url = "https://api.sequenceq.com/v1"
model = "gpt-6-astra"
model_context_window = 272000
model_auto_compact_token_limit = 180000
model_reasoning_effort = "high"
service_tier = "default"
generate_memories = false
background_agents = false
requires_openai_auth = true
experimental_bearer_token = "你的SeqeuenceQ用户Key"macOS 中，experimental_bearer_token 必须放在 config.toml 顶层。如果文件中还有 [projects...]、[profiles...] 等方括号分组，请把它放在第一个方括号分组之前。
六、两种方式的区别
| 配置方式 | Codex 登录状态 | SeqeuenceQ API Key 放置位置 |
|---|---|---|
| 免登录配置 | 不依赖 Codex/ChatGPT 登录 | auth.json 的 OPENAI_API_KEY |
| 保留 Codex 登录配置 | 保留已有登录信息 | config.toml 顶层的 experimental_bearer_token |
七、配置项说明
- model_provider：macOS 新版 Codex 使用内置 openai provider。
- openai_base_url：覆盖内置 provider 的请求基础地址，使请求发送到 SeqeuenceQ，末尾需要保留 /v1。
- model：Codex 默认使用的模型名称。这里使用 gpt-6-astra；如果平台支持的模型发生变化，请填写 SeqeuenceQ 当前支持的准确模型名称。
- model_context_window：模型上下文窗口大小。272000 表示约 27.2 万 token。
- model_auto_compact_token_limit：自动压缩上下文的触发阈值。接近 180000 token 时提前压缩较早内容，减少长上下文反复传输带来的等待和费用增加。
- model_reasoning_effort：模型的推理强度。high 表示优先使用较高推理强度；任务响应时间和 token 消耗可能相应增加。
- service_tier：请求使用的服务等级。default 表示使用当前账户和接口的默认服务等级。
- generate_memories：设置为 false，关闭会话记忆生成，避免该功能与当前自定义接口配置产生兼容性问题。
- background_agents：设置为 false，关闭后台代理任务，让任务在当前会话中执行。
- requires_openai_auth：告诉新版 Codex 当前内置 provider 需要按 OpenAI 兼容方式读取并发送认证信息。macOS 必须把它写在 config.toml 顶层；缺少时可能出现 401 Unauthorized: Invalid token。
- experimental_bearer_token：仅用于“保留 Codex 登录配置”，值为 SeqeuenceQ API Key。它让当前 provider 使用该 Key，同时保留已有的 Codex/ChatGPT 登录信息。
IMPORTANT
macOS 使用 Codex 内置 openai provider，不要照抄 Windows 的 [model_providers.sequenceq] 分组。上面所有字段都是顶层配置；如果文件中还有 [projects...]、[profiles...] 等分组，应把这些字段放在第一个方括号分组之前。
八、重启并测试
保存配置后，完全退出 Codex 桌面版；如果 Codex CLI 也在运行，请一并退出。重新打开桌面版并新建会话，发送：
请先查看当前目录结构，不要修改任何文件。能够正常返回内容即表示连接成功。连接失败时，依次检查 API Key、账户余额、密钥分组、模型名称、openai_base_url、requires_openai_auth 的位置，以及是否同时配置了两种 API Key 来源。