コンパクトモード設計：競合分析と最適化

Ctrl+O によるコンパクト/詳細モードの切り替え — Claude Code との競合分析、現在の実装レビュー、および最適化の提案。

ユーザー向けドキュメント: Settings — ui.compactMode。

1. エグゼクティブサマリー

Qwen Code と Claude Code はどちらも、ツール出力のコンパクト表示と詳細表示を切り替える Ctrl+O ショートカットを提供していますが、設計思想、デフォルト状態、インタラクションモデルは根本的に異なります。本ドキュメントではソースレベルでの詳細な比較を行い、UX のギャップを特定した上で、Qwen Code 向けの最適化案を提案します。

2. Claude Code の実装分析

2.1 アーキテクチャ

Claude Code はコンポーネント単位のレンダリング切り替えではなく、画面ベースのアプローチを採用しています：

┌──────────────────────────────────┐
│         AppState (Zustand)       │
│  verbose: boolean (default: false)│
│  screen: 'prompt' | 'transcript' │
└──────────┬───────────────────────┘
           │
     ┌─────┴──────┐
     │  Ctrl+O    │  画面モードを切り替え
     │  Handler    │  レンダリングフラグではない
     └─────┬──────┘
           │
     ┌─────▼──────────────┐
     │    REPL.tsx         │
     │  screen='prompt'  → コンパクト表示（デフォルト）
     │  screen='transcript'→ 詳細表示
     └────────────────────────┘

2.2 主要ソースファイル

2.3 設計上の判断

1. コンパクトがデフォルト。 ユーザーは最初からクリーンなインターフェースを利用でき、詳細表示はオプトイン形式です。
2. セッションスコープ。 verbose は新しいセッションごとに false にリセットされます。Claude Code は、ユーザーは通常コンパクト表示を好み、詳細は一時的にだけ必要になると想定しています。
3. 画面レベルの切り替え。 Ctrl+O はコンポーネントのレンダリング方法を変更するのではなく、画面全体を「プロンプト」画面（コンパクト）と「トランスクリプト」画面（詳細）に切り替えます。
4. フローズンスナップショットなし。 スナップショットを固定する概念はありません。切り替えると、表示は現在の状態で即座に更新されます。
5. 権限ダイアログは分離されています。 ツールの承認は専用のオーバーレイレイヤーでレンダリングされ、詳細/コンパクトの切り替えの影響を一切受けません。
6. ツール単位のヒント。 CtrlOToExpand コンポーネントは、個々のツールが大量の出力を生成した際に文脈に応じたヒントを表示し、サブエージェントでは抑制されます。

2.4 ユーザーフロー

セッション開始 → コンパクトモード（デフォルト）
     │
     ├─ ツール出力は1行に要約される
     ├─ 大量のツール出力には "(ctrl+o to expand)" ヒントが表示される
     │
     ├─ ユーザーが Ctrl+O を押す
     │     └─→ 画面がトランスクリプト（詳細表示）に切り替わる
     │         └─ すべてのツール出力、思考プロセスなどが表示される
     │
     ├─ ユーザーが再度 Ctrl+O を押す
     │     └─→ 画面がプロンプト（コンパクト）に戻る
     │
     └─ セッション終了 → verbose が false にリセットされる

3. Qwen Code の実装分析

3.1 アーキテクチャ

Qwen Code は、各 UI コンポーネントがコンテキストから読み取るコンポーネント単位のレンダリングフラグを使用しています：

┌─────────────────────────────────────┐
│      CompactModeContext             │
│  compactMode: boolean (default: false)│
│  setCompactMode: (v) => void        │
└──────────┬──────────────────────────┘
           │
     ┌─────┴──────┐
     │  Ctrl+O    │  compactMode を切り替え
     │  Handler    │  設定に永続化
     └─────┬──────┘
           │
     ┌─────▼──────────────────┐
     │  各コンポーネントが      │
     │  compactMode を読み取り  │
     │  レンダリング方法を決定   │
     └────────────────────────┘
           │
     ┌─────▼──────────────────────────────┐
     │  ToolGroupMessage                   │
     │    showCompact = compactMode        │
     │      && !hasConfirmingTool          │
     │      && !hasErrorTool               │
     │      && !isEmbeddedShellFocused     │
     │      && !isUserInitiated            │
     └────────────────────────────────────┘

3.2 主要ソースファイル

3.3 設計上の判断

1. 詳細表示がデフォルト。 ユーザーはデフォルトですべてのツール出力と思考プロセスを確認できます。
2. 永続的な設定。 compactMode は settings.json に保存され、セッションを跨いで維持されます。
3. コンポーネント単位のレンダリング。 各コンポーネントはコンテキストから compactMode を読み取り、独自のレンダリングを調整します。
4. 強制展開による保護。 重要なUI要素が常に表示されるよう、コンパクトモードを上書きする4つの条件が設定されています（確認、エラー、シェル、ユーザー操作）。
5. スナップショットの固定なし。 切り替えは常にライブ出力を表示し、固定されたスナップショットは使用しません。
6. 設定ダイアログとの同期。 設定からコンパクトモードを切り替えると、setCompactMode を介して React の状態が即座に更新されます。
7. 邪魔にならない発見性。 コンパクトモードは永続的なフッターインジケーターではなく、起動時の Tips ローテーションで紹介され、UI の混雑を回避しています。

3.4 ユーザーフロー

セッション開始 → 詳細モード（デフォルト）
     │
     ├─ すべてのツール出力、思考、詳細が表示される
     │
     ├─ ユーザーが Ctrl+O を押す（または設定で切り替え）
     │     └─→ compactMode = true、永続化される
     │         ├─ ツールグループが1行要約を表示
     │         ├─ 思考/思考内容が非表示
     │         └─ 確認、エラー、シェルは展開されたまま
     │
     ├─ ユーザーが再度 Ctrl+O を押す
     │     └─→ compactMode = false、永続化される
     │         └─ すべての詳細が再度表示される
     │
     └─ 次回のセッション → 前回のセッションと同じモードで開始

4. 主要な違いの詳細分析

4.1 デフォルトモードの設計思想

分析: Claude Code のコンパクトデフォルトが機能するのは、ユーザーベースが一般的にツールを信頼しており、すべてのツール呼び出しを確認する必要がない経験豊富な開発者であるためです。Qwen Code の詳細デフォルトは、透明性を通じてユーザーの信頼を構築することが重要な初期段階において適切です。

4.2 永続化モデル

分析: Claude Code は詳細表示を一時的なニーズとして扱います（確認したら戻る）。Qwen Code は安定した設定として扱います（常に詳細が欲しいユーザーもいれば、常にコンパクトが欲しいユーザーもいる）。どちらも有効ですが、Qwen Code のアプローチの方が柔軟性があります。

4.3 確認ダイアログの保護

分析: Claude Code のアーキテクチャ分離（オーバーレイレイヤー）の方が堅牢です。Qwen Code の強制展開アプローチは効果的ですが、新しいインタラクティブ状態が追加されるたびに条件リストに明示的に追加する必要があります。

4.4 レンダリングアプローチ

分析: Qwen Code のコンポーネントレベルのアプローチは柔軟性が高い（例：特定の条件での強制展開）ですが、一貫性を維持するためにはより厳格な管理が必要です。Claude Code の画面レベルのアプローチはシンプルで、動作の一貫性が保証されます。

5. 最適化の提案

5.1 [P0] デフォルトを詳細表示のまま維持 — 変更不要

Qwen Code の詳細デフォルトは、現在の段階において適切な選択です。ツールに不慣れなユーザーは、信頼を構築するために透明性を必要とします。製品が成熟するにつれて、（Claude Code のように）コンパクトをデフォルトにすることを検討してください。

5.2 [P1] 大量出力に対するツール単位の展開

Claude Code は大量の出力を生成する個々のツールに “(ctrl+o to expand)” を表示します。Qwen Code には現在グローバルな切り替えのみがあります。以下の対応を検討してください：

• 単一のツールが N 行を超える出力を生成した場合、コンパクトモードでツール単位の「展開」ヒントを表示する。
• スコープ：将来の機能強化であり、現在の優先度は低め。

5.3 [P2] セッションスコープの上書きを検討

一部のユーザーはデフォルトでコンパクトモードを希望しつつ、特定のセッションでのみ詳細表示を必要とする場合があります。両方をサポートすることを検討してください：

• settings.json → 永続的なデフォルト（現在の動作）
• セッション中の Ctrl+O → 現在のセッションのみ一時的に上書き（Claude Code の動作）
• セッション再起動時 → settings.json の値に戻す

これにより、ユーザーは両方の利点を享受できます。実装には、「設定のデフォルト」と「セッションの上書き」の状態を分離する必要があります。

5.4 [P2] 確認ダイアログの構造的な分離

現在、確認ダイアログの保護は ToolGroupMessage 内の showCompact 条件に依存しています。より堅牢なアプローチを検討してください：

• 確認ダイアログを別のレイヤーでレンダリングする（Claude Code のオーバーレイアプローチと同様）。
• これにより、アーキテクチャ的にコンパクトモードが確認ダイアログに影響を与えることを不可能にできる。
• 現在の強制展開アプローチは正しく機能しているため、優先度は低め。

6. 現在の実装状況

feat/compact-mode-optimization ブランチの変更後：

7. ファイルリファレンス

Qwen Code

Claude Code（参考）