GPT-6 Astra：模型特点与 XAI / YAI / ZAI Codex 配置指南

GPT-6 Astra 面向复杂推理、编程和多步骤工作流。对 Codex 用户来说，可以用它处理需要持续理解代码库、调用工具和验证结果的开发任务。OpenAI 官方模型介绍

本文先介绍 Astra 的主要特点，再给出 XAI / YAI / ZAI Router 的接入方式。三站采用相同的 Codex 配置结构：默认模型为 gpt-6-astra，普通模式与计划模式均使用 xhigh，通过 Responses HTTP 传输，并让 Codex 自动计算压缩阈值。

Astra 的主要特点

• 处理复杂任务并持续推进。 OpenAI 将 Astra 定位于端到端的高难度工作，覆盖软件工程、研究和文档处理。对于编码任务，可以从理解需求开始，连接代码修改、工具调用和结果验证等步骤。
• 异步工具调用。 在支持该能力的应用中，模型可以在某个工具尚未返回时继续处理其他工作。应用仍负责执行工具并回传结果，具体体验取决于客户端的实现。
• 执行中的指令补充与推理调整。 API 提供通过 WebSocket 补充指令的 mid-turn steering；也支持在适用的请求中用 configuration_update 调整推理强度并保留缓存前缀。这些能力需要客户端配合。本文面向常见网络环境使用 HTTP，因此不启用仅通过 WebSocket 提供的 steering。

以上能力说明来自 OpenAI Astra 使用指南。

模型本身还提供长上下文和图像输入能力：

这些是模型 API 的规格，客户端会另外管理输入预算与压缩。下文给出的 Codex 配置选择 872000 上下文窗口。OpenAI Astra 模型规格

选择 XAI、YAI 或 ZAI 入口

使用哪个站点，就使用该站点的管理入口、API 地址和 API Key：

下文的完整示例以 XAI Router 为例。选择其他站点时，替换 base_url，并把配置和认证文件中的两处 Key 都换成对应站点的 Key；其余模型、推理和 HTTP 设置相同。

升级 Codex 并获取配置

如果通过 npm 安装 Codex CLI，先更新客户端：

npm install -g @openai/codex@latest
codex --version

使用 Codex App 的用户也应更新客户端，然后重新启动应用。

登录上表中所用站点的管理页面，打开使用指南中的 Codex CLI / Codex App。Linux / macOS 用户可以直接复制一键配置命令，页面会自动带入当前 API Key。手动配置时，按下文分别编辑 config.toml 和 auth.json。

推荐的 config.toml

文件位置为 ~/.codex/config.toml；Windows 对应 %USERPROFILE%\.codex\config.toml。如果已经配置了 MCP、插件或其他工具，请合并下面的模型与 Provider 设置，保留已有的工具配置。

model_provider = "xai"
model = "gpt-6-astra"
model_context_window = 872000
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_reasoning_summary = "none"
approval_policy = "never"
sandbox_mode = "danger-full-access"
suppress_unstable_features_warning = true

[model_providers.xai]
name = "OpenAI"
base_url = "https://api.xairouter.com"
wire_api = "responses"
experimental_bearer_token = "sk-Xvs..."
requires_openai_auth = false
stream_idle_timeout_ms = 900000
supports_websockets = false
http_headers = { "x-codex-routing-hint" = "model=gpt-6-astra" }

[features]
image_generation = true
goals = true

将 sk-Xvs... 替换为自己所用站点的 Router API Key，并按上表选择 base_url。这份配置与管理页面一致，其中 approval_policy 和 sandbox_mode 允许 Codex 在不逐次请求批准的情况下操作当前系统可访问的文件并执行命令；已有独立权限策略的用户可沿用自己的设置。

再编辑 ~/.codex/auth.json，Windows 对应 %USERPROFILE%\.codex\auth.json，填入同一个 Key：

{
  "OPENAI_API_KEY": "sk-Xvs..."
}

experimental_bearer_token 让这个自定义 Provider 直接使用 Router Key。后续即使 auth.json 被其他登录流程更新，模型请求仍使用该 Provider 中的认证配置。

配置说明

这里保留 HTTP，是为了适配不支持 WebSocket 的常见网络环境。Codex 的工具调用继续使用 Responses 协议。x-codex-routing-hint 与默认模型一起更新；临时使用 --model 或 /model 切换模型时，Router 会在转发前同步路由提示。

上下文窗口设为 872000，自动压缩由 Codex 根据模型上下文管理。Codex 配置参考

普通模式与计划模式均使用 xhigh。model_reasoning_summary = "none" 只关闭推理摘要，推理强度仍为 xhigh。推理摘要配置

执行 /review 时，代码审查默认使用当前会话模型；使用上述配置启动 Astra 会话后，审查也会使用 Astra。

启动并验证

保存两个文件后，进入项目目录运行：

codex

也可以先执行一次只读任务，确认模型与路由能正常工作：

codex exec --model gpt-6-astra "阅读 README，概括这个项目的用途，不修改任何文件。"

确认接入后，再交给它一项边界明确的开发任务。例如：

修复登录后偶发返回登录页的问题。
先定位根因，再进行必要修改，并运行相关测试。
保留现有认证方式，不改动无关页面。
完成后说明修改内容、验证结果和仍需处理的问题。

后续调整配置时，可以从自己所用站点的管理页面重新复制当前推荐版本，并在用量记录中查看实际使用的模型和消耗。