macOS：Codex 桌面版安装与配置

Codex 桌面版不要求先安装 Node.js。本页介绍 macOS 桌面应用的安装，以及两种 SeqeuenceQ 配置方式。

一、安装或更新 Codex 桌面版

1. 打开 OpenAI 官方 Codex 页面，下载最新版 macOS 安装包。
2. 打开下载完成的 Codex.dmg。
3. 将 Codex 拖入“应用程序”目录。
4. 首次启动时，按照 macOS 提示确认打开 OpenAI 官方应用。
5. 打开 Codex。

二、打开后先选择使用入口

新版 Codex 桌面版左上角提供 ChatGPT Work 和 Codex 两个入口。请根据自己的使用方式选择。

推荐：选择 Codex

IMPORTANT

使用 SeqeuenceQ 时，请选择 Codex。 Codex 是本文后续配置和使用 SeqeuenceQ 的入口，不需要为了 ChatGPT Work 额外登录 ChatGPT 账号。如果当前选中的是 ChatGPT Work，请先切换到 Codex，再继续下面的配置。

左上角菜单出现两个选项时，使用 SeqeuenceQ 的用户应确认勾选的是 Codex。

如果确实要使用 ChatGPT Work

ChatGPT Work 需要在 Codex 桌面版中登录 ChatGPT/OpenAI 账号并完成授权：

1. 打开左上角菜单，选择 ChatGPT Work。
2. 按照页面提示选择登录或继续使用 ChatGPT。
3. 在打开的浏览器页面中登录 ChatGPT/OpenAI 账号，并确认授权 Codex 桌面版。
4. 授权完成后返回 Codex 桌面版。账号具备相应权限时，即可进入 ChatGPT Work 使用。

IMPORTANT

如果既要使用 ChatGPT Work，又要让 Codex 使用 SeqeuenceQ，必须采用本页下方的 方式二：保留 Codex 登录配置。 ChatGPT Work 依赖 Codex 桌面版中的 ChatGPT 登录状态，因此不要采用“方式一：免登录配置”。保留登录配置可以保留 ChatGPT 登录信息，同时为 Codex 配置 SeqeuenceQ API Key。

WARNING

ChatGPT Work 本身不使用本文配置的 SeqeuenceQ API Key，SeqeuenceQ Key 也不能代替 ChatGPT 账号登录。ChatGPT Work 是否可用还取决于账号套餐、所在地区、功能开放情况和工作区设置。如果没有可用的 ChatGPT 账号，或登录授权无法完成，请切换回 Codex，并根据自己的需求选择相应的 SeqeuenceQ 配置方式。

三、找到桌面版配置目录

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 登录字段。只按下面规则处理：

1. 如果 auth.json 中存在 OPENAI_API_KEY，删除这一项。
2. 如果 auth_mode 的值是 apikey，同时删除 auth_mode；其他 auth_mode 值不要修改。
3. 其余登录字段全部保留。
4. 如果删除上述字段后文件内容为空，可以删除这个空文件。

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 来源。