用途：配置、修复或审计 Codex 的百万 token 上下文方案。目标拓扑是推理走直连 API，而 Gmail、Calendar 等连接器仍使用普通 ChatGPT 登录：Codex 推理 -> Keychain 认证助手 -> https://api.openai.com/v1/responses；连接器 -> auth.json 中的 ChatGPT 登录。它不是 HTTP 代理，访问权限、真实模型上限与计费仍以 API 为准。
主要能力：把 provider 选择、上下文窗口、压缩阈值与自定义模型目录视为一个原子配置；提供安全输入窗口计算（1,050,000 总窗口 - 128,000 最大输出 = 922,000 安全输入），Codex 再按 95% 有效窗口保留，报告约 875,900 可用 token，自动压缩设为 700,000。要求 ~/.codex/models-api-1m.json 中五个模型 slug 均含 context_window 与 max_context_window 为 922000、auto_compact_token_limit 为 700000。config.toml 需定义 openai_api_direct provider（base_url 为 https://api.openai.com/v1，wire_api 为 responses，requires_openai_auth 为 false，supports_websockets 为 true），auth 命令从 Keychain 读取专用凭据。提供 astra、sol61、astra-1m、sol61-1m 四个 profile。
使用方式：修改前备份配置；运行预检 ruby ~/.codex/skills/agent-scripts/codex-huge-context/scripts/preflight.rb，失败时不得启动 Codex。验证包括 codex login status、jq 检查目录、codex exec 探测，以及从 task_started 事件读取 model_context_window（基础为 475000，-1m 为 875900）。集群部署使用 $fleet-maintenance 与 $remote-mac，逐台变更并记录结果。
限制：超过 272,000 输入 token 会触发更高长上下文定价；自定义目录会整体替换内置目录，须保留真实元数据与安全字段；凭据不得写入 TOML、环境变量或临时文件；共享 app server 需重启后新开会话才生效；预检不验证目录其余元数据来源，也不证明连接器 OAuth。