Windows：Codex 桌面版安装与配置

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

一、安装或更新 Codex 桌面版

1. 打开 Microsoft Store。
2. 搜索 Codex，确认发布者为 OpenAI。
3. 下载或更新应用。
4. 安装完成后打开 Codex。

二、找到桌面版配置目录

Codex 桌面版与 CLI 共用当前 Windows 用户目录中的配置：

C:\Users\你的用户名\.codex

看不到 .codex 时，在文件资源管理器中开启“隐藏的项目”。如果目录不存在，可以先启动一次 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

文件路径：C:\Users\你的用户名.codex\auth.json

{
  "OPENAI_API_KEY": "你的SeqeuenceQ用户Key"
}

Windows 的免登录模式只需要 OPENAI_API_KEY，不需要添加 auth_mode。

2. 配置 config.toml

文件路径：C:\Users\你的用户名.codex\config.toml

model = "gpt-6-astra"
model_provider = "sequenceq"
model_context_window = 272000
model_auto_compact_token_limit = 180000
model_reasoning_effort = "high"
service_tier = "default"

[model_providers.sequenceq]
name = "SeqeuenceQ API"
base_url = "https://api.sequenceq.com/v1"
wire_api = "responses"
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. 其余登录字段全部保留。
3. 如果文件原本只有 OPENAI_API_KEY，删除后内容为空，可以删除这个空文件。

2. 配置 config.toml

将你的 SeqeuenceQ API Key 填入 experimental_bearer_token：

model = "gpt-6-astra"
model_provider = "sequenceq"
model_context_window = 272000
model_auto_compact_token_limit = 180000
model_reasoning_effort = "high"
service_tier = "default"

[model_providers.sequenceq]
name = "SeqeuenceQ API"
base_url = "https://api.sequenceq.com/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "你的SeqeuenceQ用户Key"

Windows 中，experimental_bearer_token 必须写在 [model_providers.sequenceq] 分组内，不能放在该分组前面。

六、两种方式的区别

配置方式	Codex 登录状态	SeqeuenceQ API Key 放置位置
免登录配置	不依赖 Codex/ChatGPT 登录	auth.json 的 OPENAI_API_KEY
保留 Codex 登录配置	保留已有登录信息	config.toml 中 [model_providers.sequenceq] 下的 experimental_bearer_token

七、配置项说明

• model：Codex 默认使用的模型名称。这里使用 gpt-6-astra；如果平台支持的模型发生变化，请填写 SeqeuenceQ 当前支持的准确模型名称。
• model_provider：指定当前使用的 provider。这里的 sequenceq 必须与下面的 [model_providers.sequenceq] 名称一致。
• model_context_window：模型上下文窗口大小。272000 表示约 27.2 万 token。
• model_auto_compact_token_limit：自动压缩上下文的触发阈值。接近 180000 token 时提前压缩较早内容，减少长上下文反复传输带来的等待和费用增加。
• model_reasoning_effort：模型的推理强度。high 表示优先使用较高推理强度；任务响应时间和 token 消耗可能相应增加。
• service_tier：请求使用的服务等级。default 表示使用当前账户和接口的默认服务等级。
• [model_providers.sequenceq]：SeqeuenceQ provider 的配置区，名称必须与 model_provider 对应。
• name：provider 的显示名称，仅用于识别配置。
• base_url：API 请求基础地址，末尾需要保留 /v1。
• wire_api：Codex 与接口通信使用的协议。responses 表示使用 Responses API。
• requires_openai_auth：告诉新版 Codex 当前 provider 需要按 OpenAI 兼容方式读取并发送认证信息。Windows 中必须写在 [model_providers.sequenceq] 分组内；缺少时可能出现 401 Unauthorized: Invalid token。
• experimental_bearer_token：仅用于“保留 Codex 登录配置”，值为 SeqeuenceQ API Key。它让当前 provider 使用该 Key，同时保留已有的 Codex/ChatGPT 登录信息。

IMPORTANT

model、model_provider、上下文、推理强度和 service_tier 都是顶层配置，应放在任何 [分组] 之前。provider 相关字段则放在 [model_providers.sequenceq] 下面。

八、重启并测试

保存配置后，完全退出 Codex 桌面版；如果 Codex CLI 也在运行，请一并退出。重新打开桌面版并新建会话，发送：

请先查看当前目录结构，不要修改任何文件。

能够正常返回内容即表示连接成功。连接失败时，依次检查 API Key、账户余额、密钥分组、模型名称、base_url、requires_openai_auth 的位置，以及是否同时配置了两种 API Key 来源。