mcpField
C
codex-1m-context-window-setup

codex-1m-context-window-setup

github.com/daymadeAgent 工作流1.5k150 次安装今天更新
代码仓库

关于 codex-1m-context-window-setup

这是一个为 Codex 调整后续会话上下文窗口的 Skill，会依据所选模型的实时目录上限，并沿用现有的 60% 自动压缩策略。适合需要检查、应用或验证模型适配配置、又不假设所有模型都支持 100 万 token 的 Codex 用户。

主要功能

  1. 01检查模型上限与当前设置
  2. 02应用模型适配的上下文配置
  3. 03在模型或 Codex 变更后验证设置
  4. 04备份并原子更新配置
  5. 05严格诊断失败时恢复原文件

适用场景

  1. 01更改设置前预览可用上下文窗口
  2. 02为后续 Codex 会话提高上下文窗口
  3. 03切换模型后检查配置
  4. 04诊断配置与模型建议不一致

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/daymade/claude-code-skills --skill codex-1m-context-window-setup

安装后在 Claude Code 中输入/codex-1m-context-window-setup确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
context_window_contract.md
scripts/
codex_context_window.py
tests/
test_codex_context_window.py

详细介绍

Codex 1M 上下文窗口设置

扩展未来的 Codex 会话，但不要假设每个模型都支持 100 万个 token。随附脚本会读取 Codex 当前的模型目录，将请求上限设为所选模型声明的最大值，并应用用户既定的 60% 自动压缩策略。

路由请求

用户意图操作
查看当前限制、解释 258K，或预览建议值运行 doctor
配置／修复／提高上下文窗口运行 apply
在更新或切换模型后确认先前的设置仍然正确运行 verify

不要询问用户原始 token 数量。模型目录是权威依据，脚本会计算可达到的值。

运行工作流

加载此 Skill 时，宿主会提供其安装路径。请明确解析该路径：

  • 在 Codex 中，从当前 Available skills 目录中此 Skill 的 file: 条目获取包含 SKILL.md 的目录。
  • 在 Claude Code 中，使用 Skill 加载结果中显示的 Base directory for this skill。

不要在主目录中搜索其他副本。如果宿主没有提供安装路径，请停止并提示 installed Skill path not exposed，不要猜测。

在 macOS/Linux 上，设置该确切目录并运行：

SKILL_DIR="/absolute/path/from-the-loaded-skill-metadata"
uv run --no-project python "$SKILL_DIR/scripts/codex_context_window.py" doctor
uv run --no-project python "$SKILL_DIR/scripts/codex_context_window.py" apply
uv run --no-project python "$SKILL_DIR/scripts/codex_context_window.py" verify

在 Windows PowerShell 上，使用同一个已提供的目录，并将路径分隔符改为正斜杠：

$SkillDir = "C:/absolute/path/from-the-loaded-skill-metadata"
uv run --no-project python "$SkillDir/scripts/codex_context_window.py" doctor
uv run --no-project python "$SkillDir/scripts/codex_context_window.py" apply
uv run --no-project python "$SkillDir/scripts/codex_context_window.py" verify
doctor

首先运行。此命令只读，并会报告：

  • Codex 解析出的所选模型；
  • 目录默认值、模型最大值和可用百分比；
  • 请求的原始窗口（最多 1,000,000）、可用窗口和 60% 压缩点；
  • 当前基础配置值，以及是否需要运行 apply；
  • 确切的 $CODEX_HOME/config.toml 目标路径。

如果 Codex 无法返回实时模型目录，请停止。不要用记忆中的模型限制、API 宣传数据或随附的默认值代替。

apply

仅在 doctor 成功后运行。脚本会：

  1. 重新读取实时模型契约。
  2. 只修改顶层的 model_context_window 和 model_auto_compact_token_limit 键。
  3. 仅在字节内容即将发生变化时创建基于内容寻址的备份。
  4. 使用同目录下的原子替换，并拒绝覆盖已被并发修改的配置。
  5. 运行 Codex 严格配置诊断；如果失败，则恢复完全相同的先前字节内容。
  6. 读回已写入的文件，并报告未来会话将使用的值。

现有会话不会原地扩展。成功后，请告知用户启动新的 CLI 对话线程，或重启／打开新的 Codex Desktop 对话线程。

verify

在 Codex 升级、默认模型变更后，或在新配置的机器上运行。如果当前基础配置与模型适配后的建议值不再一致，此命令会以非零状态码退出。报告不一致之处；不要声称配置已完成。

报告结果

从脚本输出中准确复制数值。请包含：

  • 模型标识；
  • 配置的原始窗口；
  • 会话显示的可用窗口；
  • 自动压缩阈值；
  • 模型是否限制了 1M 请求；
  • 配置和备份路径；
  • 修改后运行 apply 时的 restart_required: true。

拒绝扩大范围

此 Skill 不会：

  • 更改所选模型、推理强度、服务层级、沙盒、审批、插件、MCP 服务、浏览器／计算机使用设置或 shell 别名；
  • 编辑特定于用户配置文件的配置文件，或覆盖每条命令的 -c 标志；
  • 声称已扩展当前运行中的对话线程；
  • 在所选模型声明的最大值较小时强制设为 1M；
  • 回退到过时或猜测的模型元数据。

诊断模型限制、95% 可用窗口显示或压缩语义时，请阅读 references/context_window_contract.md。

评论

支持 Markdown