Menu
Linux→Windows AndroidエミュレータへのADB接続トラブルシューティング。Connection refused/offline/unauthorized等のエラーを診断・解決する。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | adb-connection-troubleshoot |
| description | Linux→Windows AndroidエミュレータへのADB接続トラブルシューティング。Connection refused/offline/unauthorized等のエラーを診断・解決する。 |
| allowed-tools | Bash, Read, AskUserQuestion |
Linux→Windows エミュレータ接続で問題が起きた時のトラブルシューティング専用スキル。
.\scripts\win_initial_setup.bat
ポートプロキシ（5559→5555）とファイアウォール設定を行う。 再起動後も設定は保持されるため、1回実行すれば良い。
.\scripts\win_start_emulator.bat
./.claude/skills/adb-connection-troubleshoot/scripts/linux_connection_test.sh
接続確認のみ行う（ビルドなし）。デバッグ時は android-adb-debug スキルを使用。
┌─────────────────────────────────────────────────────────────┐
│ Linux │
│ adb connect <Windows_IP>:5559 │
│ │ │
└────────────────────┼────────────────────────────────────────┘
│ (Tailscale経由)
┌────────────────────▼────────────────────────────────────────┐
│ Windows │
│ │
│ netsh portproxy (初回設定後は常駐) │
│ └─ 0.0.0.0:5559 → 127.0.0.1:5555 │
│ │ │
│ ▼ │
│ Emulator (起動時 -port 5554) │
│ ├─ 127.0.0.1:5554 (console) │
│ └─ 127.0.0.1:5555 (adbd) ← 接続先 │
│ │
└─────────────────────────────────────────────────────────────┘
問題: netsh portproxy が 0.0.0.0:5555 をリッスンすると、エミュレータが 127.0.0.1:5555 を使えなくなる（ポート競合）。
解決: 外部公開ポート（5559）と内部ポート（5555）を分離することで競合を回避。
| 設定 | 競合 |
|---|---|
0.0.0.0:5555 → 127.0.0.1:5555 | ❌ 競合する |
0.0.0.0:5559 → 127.0.0.1:5555 | ✅ 競合しない |
| ファイル | 実行タイミング | 管理者権限 | 役割 |
|---|---|---|---|
win_initial_setup.bat | 初回のみ | 必要 | portproxy + FW設定 |
win_start_emulator.bat | 毎回 | 不要 | エミュレータ起動 |
linux_connection_test.sh | 毎回 | 不要 | 接続テスト（ビルドなし） |
※ ビルド・インストールは android-adb-debug スキルを使用
| エラー | 原因 | 解決 |
|---|---|---|
Connection refused | ポートブリッジ未設定 or エミュ未起動 | フェーズ1-2 |
device offline | エミュ内 adbd 起動失敗 / 鍵不整合 | フェーズ3-4 |
unauthorized | ADB認証未完了 | エミュ画面で「許可」 |
Unable to connect to adb daemon on port: 5037 | adb サーバ競合 / 未起動 | フェーズ4 |
emulator-5554 not found | エミュがポート5554で起動していない | フェーズ2 |
| エミュが5556ポートで起動する | ポートプロキシとの競合 | 外部ポートを5559に変更 |
Linux側:
nc -zv <Windows_IP> 5559
| 結果 | 次 |
|---|---|
succeeded | フェーズ2へ |
Connection refused | フェーズ2（ポートブリッジ確認） |
Timed out | ネットワーク/FW確認 |
Windows（管理者）:
C:\Windows\System32\netsh.exe interface portproxy show v4tov4
| 結果 | 次 |
|---|---|
0.0.0.0:5559 → 127.0.0.1:5555 | フェーズ3へ |
| 空 or 異なる | win_initial_setup.bat実行 |
Windows:
C:\Windows\System32\netstat.exe -an | C:\Windows\System32\findstr.exe 5554
| 結果 | 次 |
|---|---|
127.0.0.1:5554 LISTENING | フェーズ4へ |
| 何も表示されない | win_start_emulator.bat実行 |
5556 等 別ポート | 初回セットアップを確認 |
Windows:
"C:\Users\ryuto\AppData\Local\Android\Sdk\platform-tools\adb.exe" devices
| 結果 | 次 |
|---|---|
emulator-5554 device | フェーズ5へ |
emulator-5554 offline | 鍵リセット（下記） |
| 空 | フェーズ3に戻る |
鍵リセット（offline 対策）:
C:\Windows\System32\taskkill.exe /F /IM adb.exe
C:\Windows\System32\taskkill.exe /F /IM emulator.exe
C:\Windows\System32\taskkill.exe /F /IM qemu-system-x86_64.exe
C:\Windows\System32\cmd.exe /c del "C:\Users\ryuto\.android\adbkey"
C:\Windows\System32\cmd.exe /c del "C:\Users\ryuto\.android\adbkey.pub"
# その後 win_start_emulator.bat を再実行
Linux側:
adb kill-server
adb start-server
adb connect <Windows_IP>:5559
adb devices
| 結果 | 次 |
|---|---|
<IP>:5559 device | 成功 |
offline | フェーズ4に戻る |
Connection refused | フェーズ1から再確認 |
上記で解決しない場合:
C:\Windows\System32\taskkill.exe /F /IM adb.exe
C:\Windows\System32\taskkill.exe /F /IM emulator.exe
C:\Windows\System32\taskkill.exe /F /IM qemu-system-x86_64.exe
C:\Windows\System32\cmd.exe /c del "C:\Users\ryuto\.android\adbkey"
C:\Windows\System32\cmd.exe /c del "C:\Users\ryuto\.android\adbkey.pub"
"C:\Users\ryuto\AppData\Local\Android\Sdk\emulator\emulator.exe" -avd Pixel_7 -port 5554 -wipe-data
File > SettingsAppearance & Behavior > System Settings > Android SDKAndroid Emulator と Android SDK Platform-Tools のチェックを外して Apply（削除）エミュレータが不安定な場合は実機デバッグを推奨。
→ .claude/skills/physical-device-debug/SKILL.md を参照
| コマンド | 用途 |
|---|---|
C:\Windows\System32\taskkill.exe /F /IM adb.exe | adb 強制終了 |
C:\Windows\System32\taskkill.exe /F /IM emulator.exe | エミュ強制終了 |
C:\Windows\System32\taskkill.exe /F /IM qemu-system-x86_64.exe | QEMU 強制終了 |
C:\Windows\System32\taskkill.exe /F /PID <PID> | 特定PID強制終了 |
| コマンド | 用途 |
|---|---|
C:\Windows\System32\netstat.exe -ano | C:\Windows\System32\findstr.exe 5037 | 5037占有プロセス確認 |
C:\Windows\System32\netstat.exe -ano | C:\Windows\System32\findstr.exe 5554 | 5554占有プロセス確認 |
C:\Windows\System32\netstat.exe -ano | C:\Windows\System32\findstr.exe 5555 | 5555占有プロセス確認 |
C:\Windows\System32\netstat.exe -ano | C:\Windows\System32\findstr.exe 5559 | 5559占有プロセス確認 |
| コマンド | 用途 |
|---|---|
C:\Windows\System32\netsh.exe interface portproxy show v4tov4 | 設定確認 |
C:\Windows\System32\netsh.exe interface portproxy add v4tov4 listenport=5559 listenaddress=0.0.0.0 connectport=5555 connectaddress=127.0.0.1 | 追加 |
C:\Windows\System32\netsh.exe interface portproxy delete v4tov4 listenport=5559 listenaddress=0.0.0.0 | 削除 |
| コマンド | 用途 |
|---|---|
Get-NetFirewallRule -DisplayName "ADB Bridge 5559" | Get-NetFirewallAddressFilter | ルール確認 |
Set-NetFirewallRule -DisplayName "ADB Bridge 5559" -RemoteAddress 100.0.0.0/8,192.168.0.0/16,LocalSubnet | Tailscale/Local限定 |
Remove-NetFirewallRule -DisplayName "ADB Bridge 5559" | ルール削除 |
| コマンド | 用途 |
|---|---|
"C:\Users\ryuto\AppData\Local\Android\Sdk\platform-tools\adb.exe" start-server | サーバ起動 |
"C:\Users\ryuto\AppData\Local\Android\Sdk\platform-tools\adb.exe" kill-server | サーバ停止 |
"C:\Users\ryuto\AppData\Local\Android\Sdk\platform-tools\adb.exe" devices | デバイス一覧 |
"C:\Users\ryuto\AppData\Local\Android\Sdk\platform-tools\adb.exe" connect 127.0.0.1:5555 | ローカル接続 |
| コマンド | 用途 |
|---|---|
"C:\Users\ryuto\AppData\Local\Android\Sdk\emulator\emulator.exe" -list-avds | AVD一覧 |
"C:\Users\ryuto\AppData\Local\Android\Sdk\emulator\emulator.exe" -avd Pixel_6 -port 5554 | 通常起動 |
"C:\Users\ryuto\AppData\Local\Android\Sdk\emulator\emulator.exe" -avd Pixel_6 -port 5554 -no-snapshot | Cold Boot |
"C:\Users\ryuto\AppData\Local\Android\Sdk\emulator\emulator.exe" -avd Pixel_6 -port 5554 -wipe-data | データ初期化 |
"C:\Users\ryuto\AppData\Local\Android\Sdk\emulator\emulator.exe" -avd Pixel_6 -port 5554 -no-snapshot -no-boot-anim -gpu swiftshader_indirect | 安定化オプション |
| コマンド | 用途 |
|---|---|
C:\Windows\System32\cmd.exe /c del "C:\Users\ryuto\.android\adbkey" | 秘密鍵削除 |
C:\Windows\System32\cmd.exe /c del "C:\Users\ryuto\.android\adbkey.pub" | 公開鍵削除 |
| コマンド | 用途 |
|---|---|
adb devices | デバイス一覧 |
adb kill-server | サーバ停止 |
adb start-server | サーバ起動 |
adb connect <IP>:5559 | リモート接続 |
adb disconnect <IP>:5559 | 切断 |
adb -s <IP>:5559 get-state | 接続状態確認 |
adb -s <IP>:5559 shell | シェル起動 |
adb logcat | ログ表示 |
| コマンド | 用途 |
|---|---|
nc -zv <IP> 5559 | ポート到達性確認 |
FW設定確認:
Get-NetFirewallRule -DisplayName "ADB Bridge 5559" | Get-NetFirewallAddressFilter
Any → 危険（全開放）100.0.0.0/8, 192.168.0.0/16, LocalSubnet → 安全開発終了時に削除:
Remove-NetFirewallRule -DisplayName "ADB Bridge 5559"
C:\Windows\System32\netsh.exe interface portproxy delete v4tov4 listenport=5559 listenaddress=0.0.0.0
Pipelines Service のAPI仕様書。ヘルスチェック、データ鮮度、成功率、キュー状況など、エージェントがAPI経由でパイプラインの監視・運用を行う。
実装計画（Plan）ファイルを作成する。TDD・コミット分割・テストケース一覧・工数見積もりを含む再現性の高い Plan を生成する。機能追加・バグ修正・リファクタリング等の実装計画策定時に使用。トリガー: 「Planを作って」「計画を立てて」「実装計画を」
Pipelines Service のデバッグワークフロー。API経由でワークフロー状態確認、失敗原因の特定、stepログの取得、手動リトライを行う。
ToolCall テスト実行スキル。AIが自律的にTmuxでBEを起動し、ログを収集しながら全モデル×全ツールのテストを実行し、テスト結果とログから不具合原因を特定する。
A skill to break down ambiguous requests into small, immediately implementable requirement definitions through strategic questioning. Focus on WHY and WHAT, excluding HOW. This is used when ambiguous requests such as 'I want to add a feature like XX,' 'I want to fix XX,' or 'I did XX' are made outside of Plan Mode.
Linux→Windows AndroidエミュレータへのADBデバッグ。スクリーンショット、ログ取得、UI操作、アプリインストールなど。