ClauDeck 使い方ガイド

ケイ

各ステップの「できたら」の表示を目印に進めてくださいね。

1. ClauDeck をメニューバーに出す

   「アプリケーション」フォルダーの ClauDeck を開き、画面右上のメニューバーでデッキの形のアイコンを探します。

   できたら：アイコンを押すと、いちばん上に「このアプリについて…」が出て、メニューの中に「ステータス:」で始まる行があります。

   出ないとき：システム設定の「メニューバーに追加することを許可」を確かめます。

2. 使う AI を登録する

   メニューの「エージェント連携」を開き、使う AI（Claude Code・Codex・Antigravity）の行を選びます。Claude Code・Codex は追加内容を確かめて「入れる」、Antigravity は連携内容を選んで「適用」を押します。コードを書く必要はありません。

   できたら：Claude Code・Codex は「登録済み」、Antigravity は選んだ連携内容が行に出ます。

   Antigravity の設定が見つからないとき：一度 Antigravity を起動してから設定し直します。

3. Stream Deck にプラグインを入れる

   メニューから「Stream Deck にプラグインを入れる…」を選び、案内に従って Stream Deck アプリを終了して開き直します。プラグインは、Stream Deck に機能を足す部品です。

   できたら：ClauDeck の「ステータス」に「Stream Deck: 接続済み（席 N）」と出ます。

4. デッキに席を置く

   Stream Deck アプリのアクション一覧から「ClauDeck Slot」を探し、好きなキーへドラッグします。置けたら ClauDeck のメニューの「ボタンのテスト」で確かめます。

   できたら：席の ID（c0r0 など）がアプリ内のガイドに出ます。「AI Slot」は別のプラグインなので、間違えないようにしてください。

5. 承認の受け方を確かめる

   メニューの「ステータス」で「モード」を見ます。own ならデッキで承認を受けます（既定）。defer は状態の表示だけで、承認は AI の画面で行います。「最初の質問をもう一度出す…」から選び直せます。

6. AI に最初の依頼を出す

   対象のプロジェクトで、いつもどおり AI を 1 回動かします。Codex は、対話版の CLI で一度だけ ClauDeck への連絡を信頼する確認に答えます。Antigravity は、設定を適用したあと終了して開き直してから依頼します。

   できたら：セッションが席に着き、キーの上段に依頼文の冒頭が出ます。

7. 承認を 1 回返す

   ファイルの書き換えなど、確認が必要な操作を AI に頼みます。キーが明滅して音が鳴ったら、内容を確かめてからそのキーを押します。

   できたら：AI 側で操作が進みます。

ケイ

押す前に、上段のツール名で何を承認するか見てくださいね。

押した直後に取り消す

「取消できます／送信中」と出ている 1.5 秒の間に同じキーをもう一度押すと、承認の送信を取り消します。これは送信を止める機能で、すでに実行された操作を元に戻すものではありません。

長押しで「常に許可」にする

下段に「長押し=常に許可」と出ている要求を 0.8 秒以上押すと、同じ内容をそのセッションの中で自動で許可します。この記録は ClauDeck のメモリの中だけに置き、24 時間で消えます。設定ファイルには書きません。削除や push など、影響がもっとも大きい操作（区分 Tier 3）は「常に許可」にできません。

反応しないとき

光った直後 0.3 秒以内の押下は、押し間違いを防ぐために無視します。「長押し」は 0.8 秒未満では通りません。「入力待ち」は承認の操作ではありません。ふつうの承認待ちは、既定 15 秒で AI の画面に戻ります。

画面の言語

メニューバーの ClauDeck のメニューにある「言語」から、日本語と英語を切り替えられます。

ログイン時に起動する

ClauDeck のメニューの「ログイン時に起動」で切り替えます。チェックがあれば、次のログインから自動で起動します。ClauDeck が動いていない間は、承認はいつもどおり AI の画面で行います。

音と音量

• 承認待ち：駆け上がって止まる音。いちばん大きく、人を呼ぶ音です。
• 入力待ち：短い問いかけが 2 回。画面で答える合図です。
• タスク終了：駆け上がって最後に下がる音。ターンの終わりを知らせます。
• セッション終了：やわらかく下がる 3 音です。

席ごとに音の高さが違います。メニューの「音」で、状態の節目の音だけ、またはすべての音を止められます。「音」→「音量」で 大・中・小 の 3 段階から選べます（大が既定）。

席を増やす・ページを使う

• ClauDeck Slot を置くと、その場で席が増えます。外すと空きます。
• 設定ファイルの pins に「席の名前: 席 ID」を書くと、再起動しても同じ席に着きます。AI の種類（claude・codex・antigravity）で書くこともでき、3 つの AI をいつも同じ位置に固定できます。
• 席より多くのセッションを使う場合は、ClauDeck Page を 1 つ置きます。
• 2 台目のデッキでは、席 ID にデバイスの識別子が付きます（例：c0r0#56bc）。どれを主にするかはデバイス ID の順番で決まるので、起動の順番で入れ替わることはありません。

設定ファイル

設定は ~/.config/claudeck/config.json にあります。保存すると自動で読み直され、次の承認から反映されます。ふつうは再起動は要りません（色の帯だけは保存の数秒後に反映されます）。

{
  "policy": "own",
  "hold": 15,
  "sound": true,
  "state_sound": true,
  "pages": 3,
  "notify_ms": 9750,
  "volume": 100,
  "ended_ttl_ms": 900000,
  "auto_page": false,
  "pins": { "claude": "c0r0", "codex": "c1r0" },
  "agent_colors": { "antigravity": "#c026d3" }
}

記録を見る

メニューの「ログを Finder で開く」から、動作の記録を見られます。会話の本文やファイルの内容は含みません。

バージョンの確かめかたと更新

メニューバーの ClauDeck のアイコンを押し、いちばん上の「このアプリについて…」を選ぶと、バージョンとビルド番号、著作権表示、公式サイトへのリンクが出ます（2.0 以前は「ClauDeckについて」という名前でした）。この項目がない場合は、古い版です。最新版に更新してから開き直してください。

ClauDeck は起動したときに新しい版があるか確かめ、あれば「ソフトウェアアップデート」の画面を出します。メニューの「アップデートを確認…」からも確かめられます。

1. リモート側を確かめる

   Linux マシンに Python 3.6 以上と Claude Code があることを確かめます。

2. パスワードなしで SSH 接続できるようにする

   公開鍵をリモートの ~/.ssh/authorized_keys に登録し、Mac のターミナルからパスワードなしで接続できることを確かめます。

3. 接続先を入力する

   ClauDeck のメニューの「SSHリモート連携…」を開き、接続名、表示名、SSH ユーザー、ホスト、ポートを入力します。秘密鍵を指定する場合は「選ぶ…」から選びます。

4. 接続する

   自動接続と、切れたときの再接続をオンにして「設定して接続」を押します。接続の確認、リモートへの部品の転送、リモートの Claude Code への登録、専用の通り道の確立の順に進みます。

5. リモートの Claude Code を開き直す

   できたら、デッキに「[表示名] ディレクトリ名」の席が出ます。

接続の扱いと、切れたときの動き

• 接続するのは、利用者が指定した接続先だけです。運営者のサーバーや第三者のサービスは経由しません。
• Mac の中の連絡口はリモートに公開せず、合言葉で確かめたリモート専用の入口だけを使います。
• パスワード、二段階認証のコード、秘密鍵の中身は保存しません（秘密鍵はファイルの場所だけを覚えます）。
• 切れたときは、間隔を広げながら最大 30 秒おきに再接続します。「SSHリモート連携…」の「今すぐ再接続」でもつなぎ直せます。
• 20 秒ほど切れたままだと席は「終了」になり、つながり直したあとの次の動きで同じ席に戻ります。
• 切れている間の承認はデッキに出せないため、SSH 先の AI の画面で聞かれます。

用語

• 席：1 つのセッションが着く Stream Deck のキー。スロットとも呼びます。
• セッション：Claude Code・Codex・Antigravity との 1 つの会話です。
• 承認待ち：許可か拒否を待っている、明滅している状態です。
• 拒否キー：押している間だけ、席の押下を拒否に変えるキーです。席にはなりません。
• 構え：拒否キーを押し下げている状態です。時間では解けず、離すと必ず戻ります。
• 読み待ち：ターンが終わり、まだ見に行っていない席です。待機と同じ灰色ですが、沈みません。
• 停止：ClauDeck が動いていないことを、プラグインがキーに出した表示です。この間の承認は AI の画面で聞かれます。
• 窓：ダイヤルに映るセッション一覧です。承認や拒否はしません。
• 前面：いま画面のいちばん手前に出ている席です。下端に白い帯が出ます。
• 発信元：その席がどの AI のものかです。上端の色の帯と下段の頭 2 文字（CC・CX・AG）で示します。
• 入力待ち：選択肢を選ぶ質問です。デッキでは答えられません。
• 取消猶予：押したあと、承認の送信を待っている時間です。
• フォーカス：席を押して、対象のアプリを手前に出す操作です。