Codex 1M 上下文配置

通过 models.json 为 GPT-5.6 Sol、Terra 和 Luna 配置 1M 上下文。

本页为 gpt-5.6-sol、gpt-5.6-terra 和 gpt-5.6-luna 配置 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

查看或下载 models.json

Linux / macOS：

1mkdir -p ~/.codex
2curl -fsSL https://docs.4router.net/models.json -o ~/.codex/models.json

Windows PowerShell：

1New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
2Invoke-WebRequest https://docs.4router.net/models.json -OutFile "$HOME\.codex\models.json"

二、配置 config.toml

编辑 ~/.codex/config.toml。下面是使用 4Router 所需的核心配置，其余 approval、features、projects 等个人设置可以继续保留。

 1disable_response_storage = true
 2model = "gpt-5.6-luna"
 3model_catalog_json = "~/.codex/models.json"
 4model_provider = "4router"
 5model_reasoning_effort = "medium"
 6service_tier = "fast"
 7
 8[model_providers.4router]
 9base_url = "https://4router.net/v1"
10name = "OpenAI"
11request_max_retries = 60
12requires_openai_auth = true
13stream_idle_timeout_ms = 220000
14stream_max_retries = 60
15wire_api = "responses"

~/.codex/models.json 会由 Codex 展开到当前用户的主目录。

本方案由 models.json 提供上下文窗口与自动压缩参数，不需要再写顶层的 model_context_window 或 model_auto_compact_token_limit。

三、写入 API Key

如果 ~/.codex/auth.json 已经保存了 4Router Key，可以跳过本节。

Linux / macOS：

1export FOURROUTER_API_KEY="你的 4Router Key"
2printf '%s' "$FOURROUTER_API_KEY" | codex login --with-api-key
3unset FOURROUTER_API_KEY

Windows PowerShell：

1$env:FOURROUTER_API_KEY = "你的 4Router Key"
2$env:FOURROUTER_API_KEY | codex login --with-api-key
3Remove-Item Env:FOURROUTER_API_KEY

令牌需要具备对应 GPT 模型所在分组的使用权限。

四、验证模型目录

1codex --version
2codex debug models
3codex doctor

在 codex debug models 输出中检查 gpt-5.6-sol、gpt-5.6-terra 或 gpt-5.6-luna，应能看到：

1"context_window": 1000000,
2"max_context_window": 1000000,
3"auto_compact_token_limit": 900000,
4"effective_context_window_percent": 95

然后启动 Codex：

1codex

五、切换 5.6 模型

只需修改 config.toml 顶部的 model：

1model = "gpt-5.6-sol"

可选值：

  • gpt-5.6-sol：最高能力
  • gpt-5.6-terra：均衡
  • gpt-5.6-luna：快速、经济

其中 Sol 和 Terra 支持到 ultra 推理等级，Luna 支持到 max。

常见问题

  • codex debug models 中没有 1M：检查 model_catalog_json 指向的文件是否存在，并确认 JSON 内容完整。
  • 启动后仍加载旧目录：完全退出 Codex，再重新启动。
  • 返回 401：重新写入 Key，并确认 auth.json 中使用 OPENAI_API_KEY。
  • 返回 model_not_found：确认令牌分组允许使用所选模型。
  • 需要恢复 Codex 内置目录：从 config.toml 删除 model_catalog_json 后重启 Codex。