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

codex-1m-context-window-setup

github.com/daymadeエージェントワークフロー1.5k150 回インストール今日更新
リポジトリ

codex-1m-context-window-setup について

選択モデルのライブカタログ上限と既存の60％自動圧縮方針に基づき、今後のCodexセッションのコンテキストウィンドウを調整するSkillです。全モデルが100万トークンに対応するとは仮定せず、設定を確認・適用・検証したい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 コンテキストウィンドウの設定

すべてのモデルが 100 万トークンに対応しているかのように装うことなく、今後の Codex セッションのコンテキストウィンドウを拡張します。付属のスクリプトは Codex の現在のモデルカタログを読み取り、選択したモデルに宣言されている最大値を上限として、ユーザーが設定済みの 60% 自動圧縮ポリシーを適用します。

リクエストの振り分け

ユーザーの意図操作
現在の上限を確認する、258K について説明する、または推奨値をプレビューするdoctor を実行
コンテキストウィンドウを設定／修正／拡張するapply を実行
更新後またはモデル切り替え後に、以前の設定が引き続き正しいことを確認するverify を実行

ユーザーに生のトークン数を尋ねないでください。モデルカタログを正とし、スクリプトが実現可能な値を算出します。

ワークフローを実行する

この 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 サーバー、ブラウザー／コンピューター使用設定、またはシェルエイリアスを変更する。
  • プロファイル固有の設定ファイルを編集したり、コマンドごとの -c フラグを上書きしたりする。
  • 現在実行中のスレッドが拡張されたと主張する。
  • 選択したモデルがより小さな最大値を宣言している場合に、1M を強制する。
  • 古くなった、または推測したモデルメタデータにフォールバックする。

モデルの上限、95% の利用可能ウィンドウ表示、または圧縮の意味を調べる場合は、references/context_window_contract.md を読んでください。

コメント

Markdown 対応