パフォーマンス、コンテキスト、および長時間のセッションに関する問題

本ページでは、Qoder CLI の動作の重さ、リソース使用量の増大、またはコンテキストの負荷に関する問題の解決策を案内します。

​

コンテキスト負荷が高い / 頻繁なコンパクション

会話が長くなり、コンテキストがコンテキストウィンドウの上限に近づくと、自動コンパクションがトリガーされ、応答が遅くなる可能性があります。

• /compact を使用してコンテキストを手動で圧縮し、空き容量を確保します。
• /context を使用して現在のコンテキスト使用量を確認します。
• 複雑なタスクや長時間のタスクは複数の短いセッションに分割し、/new で新しいセッションを開始します。
• model.maxSessionTurns を使用してセッションに保持するターン数を制限します（-1 で無制限に設定できます）。
• 大規模なタスクではサブエージェントを活用して分離し、メインコンテキストの肥大化を防ぎます。

​

メモリ使用量が高い

• advanced.autoConfigureMemory（デフォルトで有効）により、Node.js のメモリ上限が自動的に構成されます。
• ui.showMemoryUsage を使用してインターフェイスにメモリ使用量を表示し、監視しやすくします。
• 超大規模なリポジトリでは、メモリディスカバリは context.discoveryMaxDirs（デフォルト 200）によって制限されます。必要に応じて作業ディレクトリの範囲を絞り込みます。

​

CPU 使用率が高い / レンダリングの遅延

インターフェイスのレンダリングに関するチューニング項目（多くは「再起動が必要」と記載されています）：

• ui.terminalBuffer、ui.renderProcess：ターミナルバッファーとレンダリングプロセスのアーキテクチャ。
• ui.useAlternateBuffer + ui.incrementalRendering：インクリメンタルレンダリングによりちらつきを軽減します（代替バッファーが有効な場合のみサポート）。
• パフォーマンスの低いターミナルでは、ui.showSpinner や ui.loadingPhrases などの動的要素を無効にできます。

​

ツール実行が遅い

• 検索：tools.useRipgrep（デフォルトで有効）が有効になっていることを確認し、コンテンツ検索を高速化します。
• シェルタイムアウト：tools.shell.inactivityTimeout（デフォルト 300 秒）は出力なしのタイムアウトを制御します。長時間実行されるコマンドの場合は適宜値を大きくします。
• MCP 初回オーバーヘッド：複数の MCP サーバーに接続する場合、遅延読み込み（mcp.lazyLoad または QODER_MCP_LAZY=1）を有効にすると、初回のトークン消費と読み込みオーバーヘッドを削減できます。

​

起動が遅い

• 不要な MCP サーバーやプラグインを減らすか、遅延読み込みを使用します。
• メモリディスカバリの範囲を絞り込み、超大規模なディレクトリツリーでの起動を避けます。

​

次のステップ

• コンテキストの仕組み：メモリの仕組み。
• 構成項目の全一覧：構成項目、環境変数、およびファイルパス。
• エラーメッセージと FAQ：エラーメッセージとFAQ。