はじめに
Claude Code を 複数同時に 走らせていると、こんなことになりませんか。
- ターミナルのタブが 5 つ。どれが作業中で、どれが終わってるのか分からない
- 「承認しますか？」で止まっていたのに、20 分後に気づく
- バックグラウンドセッションの存在をそのまま忘れる
そのたびにタブを 1 つずつ見に行くのが地味に面倒です。
cc-park は、マシン上で動いている Claude Code のセッションを キャラクターの一覧 で見せてくれるツールです。
インストールしたら、あとはこれだけ。
cc-park
デスクトップに小さなウィンドウが開いて、セッションが並びます。
ターミナル派の人は --cli を付けると、そのまま端末の中で動きます。
cc-park --cli
CC Park 3 sessions notify:ON 0:51:04
~
▗▐▛███▛█
> ▝▜██████▀ claude agents setup [bg]
▝▝ ▝▝ BLOCKED needs your approval 10h39m
~/GitHub/cc-park
▐▛███▛█
▝▜██████▀ cc-park-bd [self]
▝ ▘▝▝ BUSY working... 21m
~/GitHub/vscode-ai-coding-sidebar
▐▛███▛█
▝▜██████▀ vscode-ai-coding-sidebar-3e
▝▝ ▝▝ IDLE waiting for input 37m
このキャラクター、Claude Code の起動バナーでおなじみのあのマークです。
手を振っていたら「あなたの番」、足が動いていたら「作業中」。これだけ覚えれば使えます。
この記事では、開発の裏側ではなく 「どう便利で、どう使うか」 に絞って紹介します。
📌 3 行まとめ
- 🖥️
cc-parkだけで起動。動いている Claude Code セッションが、作業ディレクトリごとにまとまって一覧表示される - 👋 手を振っていたら操作待ち、足が動いていたら作業中。画面をチラ見するだけで状況が分かり、完了・承認待ちは OS 通知でも飛んでくる
- ⌨️ 一覧から resume コマンドのコピー・stop・kill までできるので、タブを探し回らなくていい
🤔 何が嬉しいのか
1. 「今どうなってる？」に一瞬で答えが出る
セッションの状態は、キャラクターの 動く部位 で表現されています。
| 動いている部位 | 意味 |
|---|---|
| 👋 手 | こちらの操作を待っている（承認待ち・作業完了直後） |
| 🦶 足 | 作業中 |
| （静止） | 入力待ち・完了済み・停止済み |
大事なのは 動いていない行は見なくていい こと。
一覧をパッと見て、動いている行だけ確認すれば済みます。
2. 承認待ちを見逃さない
「承認しますか？」で止まっているセッション（BLOCKED）は、
一覧の一番上に来て、黄色で、右手を上げ下げして呼んできます。
さらに、以下のタイミングで OS 通知も飛びます。
| こうなったら | 通知される内容 |
|---|---|
| 作業中 → 入力待ち | 作業が終わって、入力待ちになった |
| → 承認待ち | 承認を待っている |
| → バックグラウンド完了 | バックグラウンドの作業が完了した |
「終わったら教えて」がそのまま実現します。
3. 「このセッション、何を頼んだんだっけ？」が分かる
セッション名だけだと、どれが何の作業か分からなくなります。
cc-park は そのセッションに最後に与えたプロンプト と コンテキストの利用率 も表示します。
CC Park 3 sessions notify:ON 0:51:04
~
> ▗▐▛███▛█ claude agents setup [bg] ███████░ ctx 92%
▝▜██████▀ BLOCKED needs your approval 10h39m
▝▝ ▝▝ > MCP サーバの設定を見直して
~/GitHub/cc-park
▐▛███▛█ cc-park-bd [self] ██░░░░░░ ctx 27%
▝▜██████▀ BUSY working... 21m
▝ ▘▝▝ > キャラクターの足のアニメーションを左右に分けて
~/GitHub/vscode-ai-coding-sidebar
▐▛███▛█ vscode-ai-coding-sidebar-3e ████░░░░ ctx 45%
▝▜██████▀ IDLE waiting for input 37m
▝▝ ▝▝ > サイドバーの折りたたみ状態を保存して
| 表示 | 意味 |
|---|---|
> ... |
そのセッションに最後に与えたプロンプト |
███░░░░░ ctx 36% |
コンテキストの利用率。〜69% は控えめ、70〜89% は黄、90%〜 は赤 |
利用率が赤くなっていたら、そろそろ会話を切り上げるタイミング、という目安になります。
4. 一覧からそのまま操作できる
見るだけではありません。カーソルを合わせてキーを押すだけで操作できます。
| キー | できること |
|---|---|
c |
claude --resume <sessionId> を クリップボードにコピー。貼り付けて Enter で復帰 |
s |
バックグラウンドセッションを停止（会話は残るので後から再開できる） |
x |
ターミナルで動いているセッションのプロセスを終了 |
r |
今すぐ最新の状態に更新 |
n |
OS 通知の ON / OFF |
q |
終了 |
s と x は誤操作すると痛いので、2 段階確認（キーを押す → y で確定）になっています。
y 以外を押せば取り消しです。
🚀 使ってみる
必要なもの
- Node.js 20 以上
-
claudeコマンド（Claude Code CLI）が使える状態であること
インストール
git clone git@github.com:NaokiIshimura/cc-park.git
cd cc-park
npm install
npm run build
npm link
GUI モードは Electron を使うため、npm install で 100〜200MB ほどの追加ダウンロードが発生します。
起動する
cc-park # デスクトップウィンドウ（既定）
cc-park --cli # ターミナルの中で起動
GUI とターミナル、どちらを選べばいい？
| GUI（既定） | CLI（--cli） |
|
|---|---|---|
| 向いている使い方 | 作業しながら 端の方に置いて見張る | ターミナルから離れずに サッと確認する |
| 画面の占有 | 独立したウィンドウ | 端末を 1 つ使う |
| 最前面に固定 | ✅ できる（既定 ON） | なし |
| 操作 | キー ＋ クリック / ダブルクリック | キーのみ |
GUI は 起動時から最前面に固定 されて開きます。
エディタやターミナルで作業しながら、視界の端でセッションを見張る使い方を想定しているためです。
固定が邪魔なときは t キー、またはヘッダの top トグルで外せます。
ウィンドウは 480x640 で開き、自由にリサイズできます。OS のライト / ダーク設定にも追従します。
🎛️ よく使うオプション
cc-park --all --cwd ~/GitHub # ~/GitHub 配下だけを、完了済みも含めて表示
cc-park --cli --interval 1000 # 1 秒ごとに更新
cc-park --cli --prompt --tokens # CLI でもプロンプトと利用率を表示
cc-park --no-prompt --no-tokens # GUI の表示を減らしてシンプルに
| オプション | 既定値 | 何ができるか |
|---|---|---|
--all |
CLI: OFF / GUI: ON | 完了済みのバックグラウンドセッションも表示する |
--cwd <path> |
なし | 指定したパス配下のセッションだけに絞る |
--interval <ms> |
2000 |
更新間隔を変える（最短 500ms） |
--prompt |
CLI: OFF / GUI: ON | 最後に与えたプロンプトを表示する |
--tokens |
CLI: OFF / GUI: ON | コンテキスト利用率を表示する |
--no-notify |
通知 ON | OS 通知を切る |
--finished-highlight <sec> |
10 |
完了ハイライトを出す秒数 |
--all / --prompt / --tokens は GUI では最初から ON です。
ウィンドウを開いたまま眺める使い方が主なので、cc-park だけで全部入りになります。
端末を占有する CLI は逆に OFF から始まるので、必要なときに付けてください。
どちらのモードでも --no-prompt のように否定形で個別に切れます。
👀 画面の見方
ステータスの一覧
一覧は 要対応のものが上 に来るように並びます。
| 表示 | 色 | 動き | 意味 |
|---|---|---|---|
BLOCKED |
黄 | 👋 右手だけが上下する | 承認・入力を待っている（要対応） |
DONE! |
明るい緑 | 👋 両手が同時に上下する | 作業が終わった直後（既定 10 秒間） |
BUSY |
シアン | 🦶 足が交互に踏み出す | 作業中 |
IDLE |
灰 | 静止 | 入力待ち |
DONE |
緑 | 静止 | バックグラウンドが完了 |
STOPPED |
灰 | 静止 | 停止済み |
UNKNOWN |
赤 | 静止（足が不揃い） | 未知の状態 |
動く 3 つの見分け方はこれだけです。
▗▐▛███▛█ ▐▛███▛█ BLOCKED … 右手だけが上下する
▝▜██████▀ ▝▜██████▀
▝▝ ▝▝ ▝▝ ▝▝
▐▛███▛█ ▗▐▛███▛█▗ DONE! … 両手が同時に上下する
▝▜██████▀ ▝▜██████▀
▝▝ ▝▝ ▝▝ ▝▝
▐▛███▛█ ▐▛███▛█ BUSY … 手は動かず、足が踏み出す
▝▜██████▀ ▝▜██████▀
▀ ▝▝ ▝ ▘▝▝
作業ディレクトリごとにまとまる
セッションは 作業ディレクトリ（cwd）ごと にグループ化され、見出しが 1 回だけ出ます。
~/GitHub/cc-park
▐▛███▛█
▝▜██████▀ cc-park-bd [self]
▝ ▘▝▝ BUSY working... 21m
複数のリポジトリを並行で触っていても、「どのプロジェクトのセッションか」が迷子になりません。
カーソルはグループをまたいで上下に動きます。
名前の横に付く印
| 印 | 意味 |
|---|---|
[bg] |
バックグラウンドセッション（s で停止できる） |
[self] |
cc-park 自身を起動した セッション。x で終了すると自分を巻き込むので注意 |
💡 こんな使い方
作業しながら見張る
GUI を最前面に固定したまま、画面の端に置いておきます。
視線を送るだけで「まだ足が動いてる（作業中）」「手を振ってる（自分の番）」が分かります。
プロジェクトを絞って見る
cc-park --cwd ~/GitHub
仕事のリポジトリだけ、特定プロジェクトだけ、と絞れます。
止まっているセッションに戻る
カーソルを合わせて c を押す（GUI なら行をダブルクリック）だけで、
claude --resume <sessionId> がクリップボードに入ります。あとは貼り付けて Enter。
セッション ID を探す手間がなくなります。
放置していたバックグラウンドを片付ける
cc-park --all
完了済み・停止済みも含めて表示されるので、残っているものをまとめて確認できます。
⚠️ 知っておきたいこと
- 動作確認は macOS のみ です（実装上の OS 依存はないので、他 OS でも動く想定です）
- CLI モードの OS 通知とクリップボードは macOS のみ対応です（GUI モードは OS を問いません）
-
.app/.dmgとしての配布パッケージはまだありません - 最後のプロンプトとコンテキスト利用率は、Claude Code の内部ファイルから読み取っています。
Claude Code 側の変更で取得できなくなる可能性がありますが、その場合も一覧表示そのものは止まりません（該当の行だけ表示が減ります） - コンテキストの上限はログに記録されていないため、使用量が収まる最小の段（200k → 1M） を上限とみなしています。
実際と食い違うときは--context-limitで指定できます
cc-park --cli --tokens --context-limit 200000
まとめ
cc-park は、「複数の Claude Code を並行で走らせていると、状況が分からなくなる」 という
一点を解決するための小さなツールです。
- 🖥️
cc-parkで起動。セッションが作業ディレクトリごとに並ぶ - 👋 手が動いていたら 自分の番、🦶 足が動いていたら 作業中
- 🔔 完了・承認待ちは OS 通知でも届く
- ⌨️
cで resume コマンドをコピー、s/xで停止・終了
複数セッションを日常的に走らせている人ほど効いてくるはずです。
まずは npm link まで済ませて、cc-park --cli で 1 回眺めてみてください。
動いている行だけを見ればいい、という感覚が伝われば嬉しいです。
MIT ライセンスで公開しています。