cco-config について
cco-config は Claude Context Optimizer の設定を JSON ファイルにまとめ、値の範囲を検証します。オプティマイザーの動作を調整したいユーザー向けに、しきい値の確認、変更、リセットを行えます。
主な機能
- 01現在のしきい値を表示
- 02個別設定の取得と変更
- 03許容範囲に基づく値の検証
- 04設定の一部または全件のリセット
- 05ファイル読み込みとプロンプトのしきい値設定
活用シーン
- 01再読み込み警告が出る回数の調整
- 02Read Cache の古さ判定の調整
- 03プロンプト長のガイダンス基準の変更
- 04選択した設定または初期値への復元
MCP 対応
設定スキルであり、入力には MCP 機能の記載がありません。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ egorfedorov/ claude-context-optimizer --skill cco-configインストール後、Claude Code で/cco-configを入力して読み込まれたか確認します。
詳細
CCO Config — オプティマイザーの積極性を調整する
CCO の動作設定値は、以前は 4 つのモジュールにマジックナンバーとして分散していました。
これらの設定値を、範囲検証付きで ~/.claude-context-optimizer/config.json
の thresholds にまとめて公開します。
プラグインのルートは、src/config.js を含むディレクトリです。すべての操作は
このディレクトリから実行してください。
$ARGUMENTS を解析します。
show(または引数なし)
node ${CLAUDE_PLUGIN_ROOT}/src/config.js
表をそのまま表示してください。* はユーザーが設定した値、! は検証に失敗して無視され、デフォルト値が適用されている保存済みの値を示します。! の行がある場合は、その点をユーザーに伝えてください。値の入力ミスにより、設定が意図どおりに機能していない可能性があります。
get <key>
node ${CLAUDE_PLUGIN_ROOT}/src/config.js get <key>
set <key> <value>
node ${CLAUDE_PLUGIN_ROOT}/src/config.js set <key> <value>
無効な値や不明なキーの場合は、有効な範囲を示してゼロ以外の終了コードで終了します。修正方法を推測せず、そのメッセージをそのまま伝えてください。設定に成功したら、変更される動作を伝えてください(下の表を参照)。キー名だけでは、その効果が分かりにくいためです。
reset [key]
node ${CLAUDE_PLUGIN_ROOT}/src/config.js reset <key> # one key
node ${CLAUDE_PLUGIN_ROOT}/src/config.js reset # everything back to defaults
すべてをリセットすると、ユーザーが調整した設定がすべて破棄されます。ユーザーが明示的に「すべてリセット」または「デフォルトに戻す」と指定していない限り、先に確認してください。
キー
| キー | デフォルト | 変更される内容 |
|---|---|---|
rereadWarnAt | 3 | 未編集のファイルを読み込んだ回数のうち、最初の再読み込み警告が表示されるまでの回数 |
rereadEscalateAt | 5 | 「CLAUDE.md に記載してください」というエスカレーションまでの読み込み回数 |
bigFileLines | 500 | オフセット/上限に関する警告を表示する基準となる、全行読み込みの行数 |
mediumFileLines | 200 | ソフトヒントを表示する基準となる、全行読み込みの行数 |
staleTokenRatio | 0.10 | Read Cache がファイルの再読み込みを再び許可するまでに、そのファイルの後に読み込む予算の割合 |
staleFiles | 8 | ファイルが追い出されたとみなされるまでに、そのファイルの後に読み込む別のファイル数(200K の場合) |
staleTimeMs | 600000 | キャッシュされたファイルが古いとみなされるまでの、前回読み込みからの経過時間(ミリ秒) |
promptMinWords | 8 | これを下回ると、コーチがプロンプトを曖昧すぎると判断する単語数 |
promptIdealMaxWords | 200 | コーチが「理想的な長さ」とする範囲の上限 |
promptTooLongWords | 500 | これを超えると、依頼の要点が埋もれていると判断する単語数 |
packBudgetPercent | 25 | /cco-pack が使用できる予算の最大割合 |
調整の目安
- 再読み込みの警告が多すぎますか?
rereadWarnAtを 4~5 に引き上げてください。 - Read Cache が必要なファイルをブロックしていますか?
staleTimeMs(例:300000= 5 分)またはstaleTokenRatioを下げて、キャッシュエントリがより早く古くなるようにしてください。 - Read Cache の節約効果があまりありませんか? これらの値を引き上げてください。エントリが新鮮な状態をより長く保ち、繰り返しの読み込みがより多くブロックされます。
- 長いプロンプトを使って 1M コンテキストモデルに取り組んでいますか? デフォルトの範囲は短めの依頼向けに調整されているため、
promptTooLongWordsを引き上げてください。 - 環境変数の
CCO_STALE_TIME_MSは引き続きstaleTimeMsを上書きするため、設定を変更せずに一度だけ試すことができます。