macOS：Codex CLI 安装与配置

一、检查 Node.js

打开 Terminal，执行：

node -v
npm -v

如果能够看到版本号，说明 Node.js 和 npm 已安装。建议使用 Node.js 22 或更高版本，优先选择最新 LTS 版本。如果提示 command not found，请先从 Node.js 官网 安装 LTS 版本，完成后重新打开 Terminal 再检查。

二、安装或更新 Codex CLI

首次安装：

npm i -g @openai/codex

已经安装过时，可执行同一命令更新到最新版。随后检查版本：

codex --version

三、找到配置目录

macOS 配置目录通常是：

~/.codex

在 Finder 的用户目录中按 Shift + Command + .，可以显示或隐藏以点号开头的目录。

WARNING

如果以前配置过其他服务，请先备份 auth.json 和 config.toml。不要公开真实 API Key。

四、配置 auth.json

文件路径：~/.codex/auth.json

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "你的SeqeuenceQ用户Key"
}

macOS 的 API Key 模式需要同时保留 auth_mode = apikey 和 OPENAI_API_KEY。

五、配置 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

配置项说明

• 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。

IMPORTANT

macOS 使用的是 Codex 内置 openai provider，不要照抄 Windows 的 [model_providers.sequenceq] 分组。上面所有字段都是顶层配置；如果文件中还有 [projects...]、[profiles...] 等分组，应把这些字段放在第一个方括号分组之前。

六、重启并测试

保存两个文件，完全退出正在运行的 Codex CLI 和 Codex 桌面版。重新打开 Terminal 后执行：

codex

建议新建会话并发送：

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

如果连接失败，依次检查 API Key、账户余额、密钥分组、模型名称、openai_base_url，以及 config.toml 顶层是否包含 requires_openai_auth = true。