Claude Codeを何個も並べて動かしていると、どれかが「このファイルを書いていい?」と承認待ちで止まっているのに気づかず、しばらく放置してしまうことがある。別のタブやウィンドウの裏に隠れていると、止まっていること自体が見えない。
そこで、デスクトップの隅にいるペットが「承認待ち」を吹き出しで教えてくれて、吹き出しをクリックすると、承認を待っている会話のタブへ飛べるWindowsアプリを、Codex(OpenAIのコーディングAI)に作ってもらった。Windows Terminalのタブにも、VS Codeの内蔵ターミナルのタブにも飛べる。
結論から書くと、ZIPを落としてオレンジちゃん.exeをダブルクリックするだけで使える。Claude Code側の設定(フックなど)はいらない。VS Codeの内蔵ターミナルのタブまで飛びたい人だけ、同梱の小さな拡張機能(VSIX)を1回入れる。

以前、ChatGPTデスクトップアプリのペットをCodexに作ってもらった記事を書いたが、今回はそれとは別物だ。ChatGPTもインターネット接続もいらない、単体で動くWindowsアプリになっている。この記事では、配布ZIPと使い方を先に載せ、後半で「どうやって承認待ちを見つけて、元のタブへ飛んでいるのか」の仕組みと、自分好みに書き換える場所を書く。
先に結果:ペットと、できること
キャラクターは2人いる。ネットワークエンジニアの「オレンジちゃん」と、4本アームのネットワーク作業ロボ「ACK」だ。絵はどちらもCodexが画像生成で描いたもので、元ネタのないオリジナルだ。下のボタンでいつでも切り替えられる。

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


ACKの液晶は、待機「…」、運搬「→」、了解「✓」、作業中は進み具合のバー、高所作業「↑」、休憩は電源マーク、ケーブルが絡まると「?」、承認待ちは「!」になる。右クリックからは高所作業、液晶の砂嵐、ケーブルが絡まる、ケーブルテストも見られる。どれも演出で、実際の機器を操作するわけではない。
承認待ちの通知から、元のタブへ飛ぶところ
Windows Terminalの場合
Claude Codeを動かしているタブの裏で、別のタブ(PowerShell)を開いて作業している状態だ。承認待ちのタブは見えていないが、ペットの吹き出しには「承認待ち メモファイル作成テスト」と出ている。

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

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

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

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

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

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 };
やっていることを順に書くとこうなる。
- 4行目:
vscode://local-pets.desktop-pet-terminal-focus/…というURIを受け取れるように登録する - 6行目:パスが
/focusでなければ何もしない。SSHやWSLなど、リモートにつないだVS Codeでも何もしない - 7〜8行目:
pids=の値が「数字とカンマだけ、最大32個」でなければ捨てる。変な値を受け取っても何も起きないようにしている - 11〜15行目:開いているターミナルタブを1つずつ見て、そのタブのシェルのPID(
terminal.processId)が、届いたPIDの一覧に入っているか調べる - 16〜18行目:一覧の中でClaude Codeに一番近いもの(親をたどった順番が一番早いもの)を選び、
terminal.show(false)でそのタブを表示する - 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でビルドし直せる
参考
- Hooks reference - Claude Code Docs(Notificationフックと
permission_prompt) - Explore the .claude directory - Claude Code Docs(
sessions/は動いている会話ごとに1つのファイル) - Use Claude Code in VS Code - Claude Code Docs(
vscode://anthropic.claude-code/openのsession) - VS Code API - Visual Studio Code(
window.registerUriHandler、Terminal.processId、Terminal.show) - Activation Events - Visual Studio Code(
onUri) - UI オートメーションの概要 - Microsoft Learn
確認環境:Windows 11、Windows Terminal、VS Code、Claude Code 2.1.330(CLI)、.NET Framework 4.8。2026年11月22日に確認。


コメント