cc-discussion

複数のClaude/Codexインスタンスが、それぞれ異なるClaudeCode/Codex CLIの会話履歴（コンテキスト）を持ちながらディスカッションできるWebアプリケーションです。

クイックスタート

インストール不要で実行（推奨）

# uvx で即座に実行（Python 3.11以上が必要）
uvx cc-discussion

# または npx で実行（Node.js 環境向け）
npx cc-discussion

pip でインストール

pip install cc-discussion
cc-discussion

npm でインストール（Node.js ユーザー向け）

npm install -g cc-discussion
cc-discussion

npm版は自動的にPython仮想環境を ~/.cc-discussion/venv/ に作成します。

Note: Claude/Codex エージェントを使用するには、事前に各 CLI ツールのインストールが必要です（下記「必要要件」参照）。

起動オプション

cc-discussion --help

# カスタムポート
cc-discussion --port 9000

# ブラウザを自動で開かない
cc-discussion --no-browser

# 開発モード（ホットリロード）
cc-discussion --reload

起動後、ブラウザが自動で http://127.0.0.1:8888 を開きます。

---

必要要件

要件	説明
Python 3.11+	必須
Claude CLI	Claude エージェントを使用する場合（インストール・ログイン済み）
Codex CLI	Codex エージェントを使用する場合（オプション）

Claude CLI のセットアップ

# Claude CLI をインストール（https://claude.ai/download）
# インストール後、ログイン
claude login

---

概要

Slackのような会議室を作成し、2〜3人のClaude/Codexを招待してディスカッションさせることができます。各Claude/Codexには過去のClaudeCode/Codex会話履歴を注入できるため、人間がコンテキストを橋渡しする必要なく、問題解決や状況確認を行えます。

主な特徴

機能	説明
ClaudeCode/Codex履歴ブラウザ	~/.claude/projects/および~/.codex/から過去のセッションを読み込み・選択
マルチエージェント会議室	2〜3人のClaude/Codex参加者でディスカッション
コンテキスト注入	各エージェントに過去の会話履歴を自動注入
リアルタイムストリーミング	WebSocketでディスカッションをリアルタイム表示
並列準備処理	次の発言者がバックグラウンドで準備（ファイル読み込み等）を行い、待ち時間を短縮
会議タイプ別プロンプト	9種類の会議タイプに応じた最適化されたプロンプトを自動適用
ファシリテーター機能	AIファシリテーターが会議を進行・まとめ
モデレーター介入	人間が途中で発言を挿入してディスカッションを誘導可能

---

使い方

1. 会議室を作成

1. 画面左上の「New Room」ボタンをクリック
2. 会議設定を入力：
   • 会議室名: 識別しやすい名前
   • トピック: ディスカッションのテーマ（詳細に書くほど良い結果に）
   • 会議タイプ: 9種類から選択（後述）
   • 最大ターン数: 会議の長さを制御（デフォルト: 20）
   • 言語: 日本語 or 英語
3. 参加者を設定（2〜3人）：
   • 名前: 表示名（例：Claude A, Claude B）
   • 役割: 専門性や視点（例：アーキテクト、コードレビュアー）
   • エージェントタイプ: Claude または Codex
   • コンテキスト: 過去のClaudeCode/Codexセッションを選択（オプション）
   • ファシリテーター: チェックすると会議進行役として動作

2. 会議タイプ

会議の目的に応じて最適化されたプロンプトが自動適用されます：

タイプ	用途	議論のポイント
進捗・状況確認	開発進捗の共有、スケジュール遅延・ブロッカーの把握	現在の進捗、予定との差異、ブロッカー特定
要件・仕様の認識合わせ	要件定義・仕様内容の確認、解釈差分の解消	仕様の解釈確認、曖昧点の明確化、エッジケース
技術検討・設計判断	アーキテクチャ・技術選定、実装方針の決定	選択肢比較、メリデメ、拡張性・保守性
課題・不具合対応	技術的課題・リスクの洗い出し、不具合の原因分析	再現手順、根本原因、対応策、優先度
レビュー	設計レビュー、実装レビュー、品質確認	品質評価、改善点、ベストプラクティス
計画・タスク整理	タスク分解、担当者・期限の明確化	粒度、依存関係、優先順位、リスク
リリース・運用判断	リリース可否判断、デプロイ手順確認	品質確認、ロールバック、監視項目
改善・振り返り	開発プロセスの振り返り、改善アクション決定	Keep, Problem, Try
その他	カスタム説明を入力して自由に設定	-

3. コンテキストの選択

各参加者に過去のClaudeCode/Codex会話履歴を注入できます：

1. 参加者フォームで「コンテキストを選択」をクリック
2. ClaudeCode履歴: ~/.claude/projects/から読み込み
3. Codex履歴: ~/.codex/から読み込み
4. プロジェクト → セッションの順に選択

選択したセッションの会話内容が、そのエージェントのシステムプロンプトに注入されます。これにより、エージェントは過去のやり取りを「記憶」した状態で議論に参加できます。

4. ディスカッションの実行

1. 会議室を作成後、自動的に会議室ページに移動
2. Startボタンでディスカッション開始
3. チェーン駆動方式で議論が進行（詳細は後述）
4. Pauseで一時停止、Stopで終了、ヘッダーのゴミ箱アイコンで削除

5. チェーン駆動方式（Chain-driven Flow）

ディスカッションはチェーン駆動方式で進行します。発言者が次の発言者を@メンションで指名し、会話の流れを自然に繋げます。

┌─────────────────────────────────────────────────────────────┐
│                  チェーン駆動型フロー                        │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  1. ファシリテーター: オープニング → 最初の発言者を@指名     │
│                      ↓                                      │
│  2. 参加者A: 発言 → 最後に次の発言者を@指名                  │
│                      ↓                                      │
│  3. 参加者B: 発言 → 最後に次の発言者を@指名                  │
│                      ↓                                      │
│  4. 参加者C: 発言 → 指名なし                                 │
│                      ↓                                      │
│  5. ファシリテーター: 介入 → 話の流れで次を@指名             │
│                      ↓                                      │
│  6. ... 繰り返し ...                                        │
│                      ↓                                      │
│  7. ファシリテーター: クロージング（まとめ）                 │
│                                                             │
└─────────────────────────────────────────────────────────────┘

特殊なメンション

メンション	効果
@参加者名	指名した参加者が次に発言
@ALL	全参加者が順番に発言
@モデレーター	人間のモデレーターに質問・確認（ディスカッションが一時停止）
@END	ファシリテーターのみ使用可。議論を終了してクロージングへ移行

チェーン駆動のメリット

• 自然な会話の流れ: 関連する知見を持つ人に話を振れる
• 柔軟な議論: 話題に応じて適切な人が発言
• ファシリテーターの介入: 指名がない場合は自動的にファシリテーターが次を決定
• 人間との協調: @モデレーターで人間の判断を仰げる

6. 並列準備処理（Parallel Preparation）

Discussion Roomの特徴的な機能として、並列準備処理があります：

• 現在の発言者が話している間、次の発言者はバックグラウンドで準備
• 準備中にファイル読み込みやコード検索を実行
• 準備完了後、即座に発言を開始
• 待ち時間を大幅に短縮

7. モデレーター介入

ディスカッション中に人間がモデレーターとして発言を挿入できます：

1. 画面下部のテキストボックスにメッセージを入力
2. Enter（またはSendボタン）で送信
3. 次のエージェントの発言時にモデレーターメッセージが考慮されます

用途例：

• 議論の方向性を修正
• 追加の情報や制約を提供
• 特定のトピックに焦点を当てるよう指示

---

データの保存場所

データ	保存先
データベース	~/.cc-discussion/discussion.db
ClaudeCode履歴	~/.claude/projects/ (読み取り専用)
Codex履歴	~/.codex/ (読み取り専用)

---

開発者向け

ソースからの起動

# リポジトリをクローン
git clone https://github.com/nogataka/cc-discussion.git
cd cc-discussion

# 起動スクリプトを使用（初回は自動セットアップ）
./start.sh

# または開発モード
./start.sh --dev

起動スクリプトオプション

# 通常起動（プロダクションモード）
./start.sh

# 開発モード（Viteホットリロード付き）
./start.sh --dev

# カスタムポート指定
./start.sh --port 9000

# リモートアクセス許可（セキュリティ注意）
./start.sh --host 0.0.0.0

バックエンドのみ起動

source venv/bin/activate
python -m uvicorn backend.main:app --reload --port 8888

フロントエンドのみ起動

cd frontend
npm run dev

ビルド

cd frontend
npm run build

コード品質

# Python linting
source venv/bin/activate
ruff check backend/
mypy backend/

# TypeScript type check
cd frontend
npx tsc --noEmit

---

技術スタック

バックエンド

技術	用途
FastAPI	非同期REST API・WebSocket
SQLAlchemy 2.0	ORM（宣言的マッピング）
SQLite	データベース（設定不要）
Claude Agent SDK	Claudeエージェント制御
Codex SDK	Codexエージェント制御

フロントエンド

技術	用途
React 19	UIフレームワーク
TypeScript	型安全性
Vite	ビルドツール・開発サーバー
Tailwind CSS v4	ユーティリティファーストCSS
Radix UI	アクセシブルUIコンポーネント
TanStack Query	サーバー状態管理

---

トラブルシューティング

エージェントタイプが選択できない

CLI ツールがインストールされていない可能性があります：

# Claude CLI をインストール
# https://claude.ai/download からダウンロード
claude login

# Codex CLI をインストール
npm install -g @openai/codex

Claude CLIが見つからない

# Claude CLIをインストール（https://claude.ai/download）
# ログイン
claude login

ポートが使用中

cc-discussion --port 9000

データベースのリセット

# データベースファイルを削除（全データ消失）
rm ~/.cc-discussion/discussion.db

Windows での実行

Windows でも動作します：

uvx cc-discussion
# または
pip install cc-discussion
cc-discussion

データは C:\Users\<username>\.cc-discussion\ に保存されます。

---

API リファレンス

履歴閲覧API

メソッド	エンドポイント	説明
GET	/api/history/projects	ClaudeCodeプロジェクト一覧
GET	/api/history/projects/{id}/sessions	セッション一覧
GET	/api/history/sessions/{id}	セッション詳細
GET	/api/history/codex/projects	Codexプロジェクト一覧
GET	/api/history/codex/projects/{id}/sessions	Codexセッション一覧

ルーム管理API

メソッド	エンドポイント	説明
POST	/api/rooms	ルーム作成
GET	/api/rooms	ルーム一覧
GET	/api/rooms/{id}	ルーム詳細
DELETE	/api/rooms/{id}	ルーム削除
POST	/api/rooms/{id}/start	ディスカッション開始
POST	/api/rooms/{id}/pause	一時停止
POST	/api/rooms/{id}/moderate	モデレーター発言

WebSocket

エンドポイント	説明
WS /ws/rooms/{id}	リアルタイム更新

---

ライセンス

MIT License