使用文档 / Codex 1M 上下文配置

Codex 1M 上下文配置

通过 models.json 为 gpt-5.6-sol 和 gpt-5.6-terra 配置 1M 上下文。

本页为这两个模型配置 1,000,000 token 上下文。关键参数：

context_window = 1000000
max_context_window = 1000000
effective_context_window_percent = 95
auto_compact_token_limit = 900000

即 Codex 按 95% 有效窗口管理上下文，并在 900,000 tokens 附近自动压缩。

一、下载 models.json

Linux / macOS：

mkdir -p ~/.codex
curl -fsSL https://api.ai-trailblazer.com/docs/models.json -o ~/.codex/models.json

Windows PowerShell：

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Invoke-WebRequest https://api.ai-trailblazer.com/docs/models.json -OutFile "$HOME\.codex\models.json"

二、配置 config.toml

编辑 ~/.codex/config.toml，下面是接入玄枢的核心配置，其余个人设置可保留：

disable_response_storage = true
model = "gpt-5.6-sol"
model_catalog_json = "~/.codex/models.json"
model_provider = "trailblazer"
model_reasoning_effort = "medium"

[model_providers.trailblazer]
name = "OpenAI"
base_url = "https://api.ai-trailblazer.com/v1"
requires_openai_auth = true
wire_api = "responses"

Key 写在 ~/.codex/auth.json：

{
  "OPENAI_API_KEY": "sk-xxxxx"
}

三、验证

运行 codex，发一段长对话，确认不会因上下文超限中断即可。

1M 上下文能力取决于所选模型的支持情况。若当前模型不支持该窗口，Codex 会按模型实际上限工作。