【ClaudeCode】承認待ちをデスクトップペットが教えてくれる|クリックで元のタブへ飛べる(無料配布)

スポンサーリンク
ClaudeCode
スポンサーリンク

Claude Codeを何個も並べて動かしていると、どれかが「このファイルを書いていい?」と承認待ちで止まっているのに気づかず、しばらく放置してしまうことがある。別のタブやウィンドウの裏に隠れていると、止まっていること自体が見えない。

そこで、デスクトップの隅にいるペットが「承認待ち」を吹き出しで教えてくれて、吹き出しをクリックすると、承認を待っている会話のタブへ飛べるWindowsアプリを、Codex(OpenAIのコーディングAI)に作ってもらった。Windows Terminalのタブにも、VS Codeの内蔵ターミナルのタブにも飛べる。

結論から書くと、ZIPを落としてオレンジちゃん.exeをダブルクリックするだけで使える。Claude Code側の設定(フックなど)はいらない。VS Codeの内蔵ターミナルのタブまで飛びたい人だけ、同梱の小さな拡張機能(VSIX)を1回入れる。

Windows TerminalのClaude Codeが承認待ちになり、右下のデスクトップペットに承認待ちの吹き出しが出ている画面
Claude Codeが承認待ちになると、右下のペットの上に「承認待ち」と会話名が出る

以前、ChatGPTデスクトップアプリのペットをCodexに作ってもらった記事を書いたが、今回はそれとは別物だ。ChatGPTもインターネット接続もいらない、単体で動くWindowsアプリになっている。この記事では、配布ZIPと使い方を先に載せ、後半で「どうやって承認待ちを見つけて、元のタブへ飛んでいるのか」の仕組みと、自分好みに書き換える場所を書く。

先に結果:ペットと、できること

キャラクターは2人いる。ネットワークエンジニアの「オレンジちゃん」と、4本アームのネットワーク作業ロボ「ACK」だ。絵はどちらもCodexが画像生成で描いたもので、元ネタのないオリジナルだ。下のボタンでいつでも切り替えられる。

オレンジちゃんの待機、ネットワーク談義の吹き出し、ACKに切り替えた状態、隠した状態の4つの画面
左から、待機、クリックしたとき(ネットワーク談義)、ACKに切り替えたとき、「隠す」を押したとき
操作・状況 オレンジちゃん ACK
クリック ネットワークの豆知識を話す(12話、ときどき障害調査の独り言) 「了解」の合図
ダブルクリック・長押し デスクでタイピング サーバーラックで作業
左右にドラッグ 向きに合わせて走る(ケーブルを運ぶ)。ドラッグ中にEscで元の位置に戻る
60秒さわらない スマホとアイスコーヒーで休憩 省電力モードで休憩
Claude Codeが承認待ち 上に「承認待ち」と会話名が出て、指さしで知らせる。クリックすると元のタブへ
下のボタン 「−」「+」で50〜100%のサイズ変更、「ACK」「戻す」で切替、「隠す」「表示」で非表示
右クリック 好きな動きを選ぶ、サイズ指定、終了
オレンジちゃんの動き7種類
オレンジちゃんの動き(各3コマ)。右端が承認待ちを知らせるポーズ
ACKの動き10種類
ACKの動き(各2コマ)。顔の代わりに液晶の記号で状態を表す。右下の「!」が承認待ち

ACKの液晶は、待機「…」、運搬「→」、了解「✓」、作業中は進み具合のバー、高所作業「↑」、休憩は電源マーク、ケーブルが絡まると「?」、承認待ちは「!」になる。右クリックからは高所作業、液晶の砂嵐、ケーブルが絡まる、ケーブルテストも見られる。どれも演出で、実際の機器を操作するわけではない。

承認待ちの通知から、元のタブへ飛ぶところ

Windows Terminalの場合

Claude Codeを動かしているタブの裏で、別のタブ(PowerShell)を開いて作業している状態だ。承認待ちのタブは見えていないが、ペットの吹き出しには「承認待ち メモファイル作成テスト」と出ている。

Windows Terminalで別のタブを開いている状態。右下のペットには承認待ちの吹き出し

吹き出しをクリックする。このときはWindows Terminalのウィンドウを2つ開いていたので、どちらのウィンドウかを選ぶメニューが出た(ウィンドウが1つならメニューは出ずにそのまま飛ぶ)。

ペットの吹き出しをクリックすると、Windows Terminalのウィンドウを選ぶメニューが出た

選ぶと、承認を待っている「メモファイル作成テスト」のタブに切り替わった。あとはここでYes/Noを答えればいい。

承認待ちのClaude Codeのタブに切り替わった

VS Codeの内蔵ターミナルの場合

VS Codeの内蔵ターミナルでClaude Codeを動かし、そのあと別のターミナル(pwsh)を開いて前に出した状態だ。右の一覧の上にある「メモファイ…」が承認待ちのタブだが、画面には出ていない。

VS Codeで別のターミナルが前に出ていて、承認待ちのターミナルは見えていない。ペットには承認待ちの吹き出し

吹き出しをクリックすると、VS Codeが「'デスクトップペット 端末タブ切替' 拡張機能がこの URI を開くことを許可しますか?」と聞いてくる。これは後で説明する補助拡張(VSIX)を呼び出すときの、VS Code標準の確認だ。「開く」を押す。毎回出てほしくなければ「今後、この拡張機能についてメッセージを表示しない」にチェックを入れればいい。

VS CodeがURIを開くか確認するダイアログ

承認待ちのターミナルタブに切り替わり、「Do you want to create note.txt?」の画面が出た。

VS Codeで承認待ちのClaude Codeのターミナルタブに切り替わった

VS CodeのClaude Code拡張(サイドバーやエディターのタブで使う方)で承認待ちになった場合は、VSIXなしでその会話のタブを開ける。Claude Code拡張が公式に用意している「会話を開くURI」を使っているからだ(仕組みで後述)。

ダウンロードと使い方

ここからダウンロードできる。exe 2つ、VS Code用の補助拡張、説明書、ソース一式が入っている。

desktop-pet-orange-ack.zip(約6.7MB)

ファイル 中身
オレンジちゃん.exe オレンジちゃんで起動する。画像はexeの中に入っている
ACK.exe ACKで起動する(中身は同じで、最初の姿だけ違う)
DesktopPetTerminalFocus.vsix VS Codeの内蔵ターミナルのタブへ飛ぶための補助拡張。必要な人だけ
はじめに.txt 使い方の説明
source\ ソース、画像、自分でビルドするためのスクリプト

動く環境はWindows 10/11と.NET Framework 4.8以降(Windowsに最初から入っている)。ペットを動かすだけなら、Claude Codeもインターネット接続もいらない。

1. ZIPのブロックを解除して展開する

ダウンロードしたZIPを右クリック→「プロパティ」→下の「セキュリティ」にある「許可する」にチェックを入れてOK。そのあと右クリック→「すべて展開」でフォルダごと展開する。ZIPの中から直接exeを起動しないこと(設定が保存できない)。

ZIPが壊れていないか確かめたい人は、PowerShellでハッシュを出して、下の値と同じか見比べる。

Get-FileHash .\desktop-pet-orange-ack.zip -Algorithm SHA256
91CD2A08F3F33A8D7BB78E16AEABC132E70892DFCF050D27BF2427047621FEA7

2. exeをダブルクリックする

オレンジちゃん.exeをダブルクリックすると、画面の右下にペットが出る。「WindowsによってPCが保護されました」(SmartScreen)と出たら、「詳細情報」→「実行」で起動できる。これは個人が作った署名なしのexeだから出る表示だ。気になる人は、後で書く方法でソースから自分でビルドしたexeを使ってほしい。

終了は、ペットを右クリック→「終了」。サイズとキャラクターの選択は、exeの横にできる.settingsファイルに保存され、次に起動したときも同じになる。Windowsの起動時に自動で立ち上げる設定はしていないので、使いたい時に起動する。

3. (必要な人だけ)VS Codeに補助拡張を入れる

VS Codeの内蔵ターミナルでClaude Codeを使っていて、そのタブまで飛びたい人だけ入れる。Windows TerminalやClaude Code拡張だけなら不要だ。

VS Codeの左の「拡張機能」→上の「…」→「VSIXからのインストール...」→DesktopPetTerminalFocus.vsixを選ぶ。PowerShellで入れるなら、展開したフォルダで次を実行する。

code --install-extension .\DesktopPetTerminalFocus.vsix

会社のPCでは、拡張機能の導入ルールに従うこと。

仕組み①:承認待ちをどうやって見つけているか

Claude Codeには、承認待ちなどのタイミングで好きなコマンドを動かせる「フック」という公式の仕組みがある(Notificationフックのpermission_prompt)。普通はこれを使うのが正攻法だ。

ただ、このペットは最初、職場のPCで使うつもりで作った。職場のPCは管理者の設定でフックが使えなかったので、フックを使わずに、Claude Codeが自分で書き出している状態ファイルを外から読む方式にした。そのおかげで、Claude Code側の設定は何もいらない。

Claude Codeは、動いている会話ごとに、ユーザーフォルダの.claude\sessions\に「プロセス番号(PID).json」という小さなファイルを置いている。公式ドキュメント(Explore the .claude directory)にも、動いている会話ごとに1つ置かれ、会話が終わると消えるファイルとして載っている。

ペットは約2秒ごとにこのフォルダのファイルを全部読み、中身が次の条件にそろったものだけを「承認待ち」として吹き出しに出す。

読む項目 見ていること
status waiting(待っている)か
waitingFor permission prompt(承認の確認)か。普通の入力待ちでは出さない
pidと起動時刻 そのPIDのプロセスが今も動いていて、起動時刻も一致するか。古いファイルや、番号だけ使い回された別のプロセスを除くため
sessionId 会話のID。会話名を調べるのと、VS Codeで会話を開くのに使う
cwd 作業フォルダ。VS Codeのウィンドウを選ぶのに使う
entrypoint CLIか、VS CodeのClaude Code拡張か

吹き出しの会話名は、会話の記録(.claude\projects\の下の会話ID.jsonl)から、/renameで付けた名前か、Claude Codeが自動で付けた題名を読んで出している。CLAUDE_CONFIG_DIRで保存先を変えている人は、その下を読む。

注意点として、このファイルの中身(statusやwaitingForなど)は公式ドキュメントに載っている仕様ではない。フォルダがあることは公式に書かれているが、中身の書き方はClaude Codeの内部の事情で、アップデートで変わる可能性がある。変わると通知が出なくなる。2026年11月22日時点のClaude Code 2.1.330で動くことを確かめている。

仕組み②:承認待ちの会話がある窓とタブを探す

吹き出しをクリックすると、まず状態ファイルをもう一度読み直して、まだ承認待ちかを確かめる(もう答えてあれば「この承認待ちは解消しました」と出して終わる)。

次に、承認待ちのClaude Codeのプロセスから親のプロセスを順にたどる。Claude Code→その親のシェル(PowerShellなど)→…と最大32段たどり、途中でWindowsTerminalかCode(VS Code)が出てきたら、それが元の画面だ。たどる途中で通ったPIDは一覧にして覚えておく(後でVS Codeのタブ探しに使う)。

VS Codeはウィンドウを何枚開いても、裏では1つのプロセスがまとめて持っている。そのため親をたどるだけではどのウィンドウかわからない。そこで、状態ファイルの作業フォルダ(cwd)のフォルダ名と、ウィンドウのタイトル(「ファイル名 - フォルダ名 - Visual Studio Code」)を照らし合わせて絞り込んでいる。1つに決まればメニューなしでそのウィンドウへ、決まらなければ選ぶメニューを出す。Windows Terminalも全ウィンドウが1つのプロセスなので、ウィンドウが2つ以上あると上の写真のように選ぶメニューが出る。

ウィンドウを前に出したら、行き先ごとに次のやり方でタブを選ぶ。

行き先 タブの選び方 VSIX
Windows Terminal Windowsの「UIオートメーション」(画面の部品を外から操作する仕組み)でタブの一覧を取り、会話名と同じ名前のタブを選ぶ。Claude Codeがタブ名の先頭に付ける「✳」などの記号は無視して比べる 不要
VS CodeのClaude Code拡張 Claude Code拡張が公式に用意している、会話を開くURI(vscode://anthropic.claude-code/open?session=会話ID)をVS Codeに渡す 不要
VS Codeの内蔵ターミナル 補助拡張のURI(vscode://local-pets.desktop-pet-terminal-focus/focus?pids=PIDの一覧)をVS Codeに渡す 必要

仕組み③:VSIXでVS Codeのターミナルタブを切り替える

VS Codeの内蔵ターミナルのタブは、名前が「pwsh」などで、外から見ても、どのタブがどのClaude Codeのものか見分ける手がかりがない。一方、VS Codeの中で動く拡張機能なら、ターミナルタブごとにシェルのPIDがわかる。そこで、小さな拡張機能(VSIX)を作り、PIDを照らし合わせてタブを選んでもらうことにした。

VS Codeには、vscode://拡張機能のID/…という形のURIを開くと、その拡張機能を起こしてURIを渡してくれる公式の仕組みがある(registerUriHandlerと、起動のきっかけのonUri)。ペットは、VS Codeのcodeコマンドに--open-urlでこのURIを渡し、さっき親をたどったときに覚えたPIDの一覧をpids=に入れて届ける。

拡張機能の中身は、これで全部だ(source\TerminalFocus\extension.js)。

const vscode = require('vscode');

function activate(context) {
  context.subscriptions.push(vscode.window.registerUriHandler({
    async handleUri(uri) {
      if (uri.path !== '/focus' || vscode.env.remoteName) return;
      const ids = new URLSearchParams(uri.query).get('pids') || '';
      if (!/^\d+(,\d+){0,31}$/.test(ids)) return;
      const ancestors = ids.split(',').map(Number);
      const matches = [];
      for (const terminal of vscode.window.terminals) {
        const pid = await terminal.processId;
        const rank = ancestors.indexOf(pid);
        if (rank >= 0) matches.push({ terminal, rank });
      }
      matches.sort((a, b) => a.rank - b.rank);
      if (matches.length && (!matches[1] || matches[0].rank !== matches[1].rank)) {
        matches[0].terminal.show(false);
      } else {
        vscode.window.showInformationMessage('承認元の端末をこのウィンドウで特定できませんでした。');
      }
    }
  }));
}
module.exports = { activate };

やっていることを順に書くとこうなる。

  1. 4行目:vscode://local-pets.desktop-pet-terminal-focus/…というURIを受け取れるように登録する
  2. 6行目:パスが/focusでなければ何もしない。SSHやWSLなど、リモートにつないだVS Codeでも何もしない
  3. 7〜8行目:pids=の値が「数字とカンマだけ、最大32個」でなければ捨てる。変な値を受け取っても何も起きないようにしている
  4. 11〜15行目:開いているターミナルタブを1つずつ見て、そのタブのシェルのPID(terminal.processId)が、届いたPIDの一覧に入っているか調べる
  5. 16〜18行目:一覧の中でClaude Codeに一番近いもの(親をたどった順番が一番早いもの)を選び、terminal.show(false)でそのタブを表示する
  6. 19〜21行目:1つに決まらなければ、メッセージを出すだけで何もしない

この拡張がするのは「PIDが一致したターミナルタブを表示する」ことだけだ。承認のボタンを押したり、コマンドを送ったり、通信したりはしない。初回に出る「URIを開くことを許可しますか?」の確認は、このvscode://のURIを外から開いたときにVS Codeが出すものだ。

拡張機能の設定ファイル(package.json)は次のとおり。"activationEvents": ["onUri"]で、URIが届いたときだけ起動する。"extensionKind": ["ui"]は、リモート接続中でも手元のPC側で動かす指定だ。

{
  "name": "desktop-pet-terminal-focus",
  "displayName": "デスクトップペット 端末タブ切替",
  "description": "承認通知から、指定したシェルPIDのローカル端末を表示します。",
  "publisher": "local-pets",
  "version": "1.0.0",
  "engines": { "vscode": "^1.85.0" },
  "extensionKind": ["ui"],
  "activationEvents": ["onUri"],
  "main": "./extension.js"
}

自分好みに書き換えるなら:場所の早見表

ソースはsource\に全部入っている。C#のファイル3つと画像2枚だけの小さなアプリなので、セリフや絵を変えて遊ぶのにちょうどいい。このソースと画像は、自由に改変・利用・再配布してかまわない(連絡不要、無保証)。

変えたいこと ファイル・行 書き換え方
キャラの名前 CharacterPet.cs 13行目 PetNameの文字列
クリックで話すセリフ(12話) CharacterPet.cs 16〜27行目 1話が4行(約2秒ずつ表示)。行を増やせば話も増える
障害調査の独り言(8話) CharacterPet.cs 30〜37行目 同じく1話4行
セリフを出している時間 CharacterPet.cs 384行目 return 8;の8秒
休憩に入るまでの時間 CharacterPet.cs 415行目 >= 60の60秒
動きの速さ CharacterPet.cs 68行目 動きごとの1コマの表示時間(ミリ秒)
最初に出る位置 CharacterPet.cs 123〜124行目 画面の右端から24、下から16の位置
承認待ちの吹き出しの色 CharacterPet.cs 134行目 Brushes.DarkOrangeを別の色に
承認待ちを確かめる間隔 CharacterPet.cs 195行目 FromSeconds(2)の2秒
オレンジちゃんの絵 Orange-atlas.png 1コマ192×208ピクセル、横3コマ×縦8段(挨拶、右へ走る、左へ走る、談義、タイピング、休憩、障害調査、承認待ち)の透過PNG
ACKの絵 ACK-atlas.png 1コマ192×208ピクセル、横4コマ×縦5段に2コマずつ10の動き
サイズの下限・上限 PetDisplay.cs 84行目 .5(50%)と1(100%)

書き換えたら、sourceフォルダでPowerShellを開き、次を実行する。Windowsに最初から入っているC#のコンパイラ(csc.exe)を使うので、Visual Studioなどを入れる必要はない。source\out\にオレンジちゃん.exe、ACK.exe、DesktopPetTerminalFocus.vsixができる。

powershell -ExecutionPolicy Bypass -File .\build-blog.ps1

起動中のペットがあると上書きできないので、先に終了しておく。Windows PowerShell 5.1とPowerShell 7のどちらでもビルドできることを確かめている。

できないこと・注意

  • 承認(Yes/No)そのものはペットからはできない。元のタブへ飛んで、そこで答える
  • 状態ファイルは非公式なので、Claude Codeのアップデートで通知が出なくなることがある
  • Windows Terminalのタブを手で改名している場合や、同じ名前のタブが複数ある場合は、タブを選べない(ウィンドウを前に出すところまで)
  • Windows Terminalの分割ペイン、WSL、SSHなどのリモート先で動かすClaude Codeは対象外
  • VS Codeで同じ名前のフォルダを複数のウィンドウで開いている場合や、ウィンドウのタイトルの設定を変えてフォルダ名が出ない場合は、ウィンドウを選ぶメニューが出る
  • 同じWindowsユーザーで動いているClaude Codeだけが対象。CLAUDE_CONFIG_DIRを設定している人は、ペットを起動するときも同じ値にしておく
  • 私のPC以外での動作は確かめていない

Codexに作ってもらった流れ

最初の依頼は「このPCにあるペットの画像で、ChatGPTも通信も使わないWindows用のデスクトップペットを作って」だった。そこから「クリックするたびに違う話をしてほしい」「ときどき髪ぼさぼさで障害調査をしてほしい」「Claude Codeの承認待ちを知らせて」「元のタブへ飛びたい」「小さくしたい、隠したい」「ロボも欲しい」と、使いながら気になったことを1つずつ頼んでいき、2日ほどで今の形になった。

Codexは、頼むたびに模擬テストと、本物のClaude Codeの承認待ちを起こしての確認までやってくれた。ただ、最初は通知をクリックすると開いているVS Codeのウィンドウが全部候補に出てしまい、ここだけは後からClaude Codeに直してもらった(作業フォルダとウィンドウのタイトルで絞り込む部分)。絵は、Codexが画像生成で描いたものを、動きごとに切り出して使っている。

まとめ

  • ZIPを展開してオレンジちゃん.exeをダブルクリックするだけ。Claude Code側の設定はいらない
  • 承認待ちになると、ペットの上に会話名つきの吹き出しが出る。クリックで元のタブへ飛べる
  • Windows TerminalはUIオートメーション、VS CodeのClaude Code拡張は公式のURI、VS Codeの内蔵ターミナルは同梱のVSIXでタブを選んでいる
  • 承認待ちは、Claude Codeが.claude\sessions\に書き出す状態ファイルを2秒ごとに読んで見つけている。非公式な中身なので、アップデートで動かなくなる可能性はある
  • ソースと画像は自由に改変してOK。セリフや絵を変えたらbuild-blog.ps1でビルドし直せる

参考

確認環境:Windows 11、Windows Terminal、VS Code、Claude Code 2.1.330(CLI)、.NET Framework 4.8。2026年11月22日に確認。

コメント

タイトルとURLをコピーしました