一、背景：AI開発ツールのネットワーク課題
AIコーディングアシスタント（Claude Code、GitHub Copilot、Cursorなど）、AI対話ツール（ChatGPT、Claude）、そしてパッケージマネージャー（npm、pip、cargo）が開発者のコアワークフローに不可欠となる中、長年見過ごされてきた問題が顕在化しています：システムプロキシモードではすべてのアプリケーションのネットワークトラフィックをカバーできないという課題です。
従来のシステムプロキシ（System Proxy）モードでは：
| シナリオ | 自動的にプロキシ経由？ |
|---|---|
| ブラウザでChatGPTにアクセス | はい |
| VS Code内蔵ブラウザ | はい |
ターミナルで npm install を実行 | いいえ、手動で HTTP_PROXY の設定が必要 |
| Claude Code CLI | いいえ、手動で環境変数の設定が必要 |
| IDE内蔵AI補完 | 不明、アプリの実装に依存 |
pip install / cargo build | いいえ |
開発者は HTTP_PROXY、HTTPS_PROXY、ALL_PROXY などの環境変数を繰り返し設定し、ツールごとに個別のプロキシパラメータを設定しなければなりません。これは煩雑なだけでなく、ミスも起きやすく——ある1つのターミナルウィンドウで設定を忘れるだけで、接続タイムアウトや依存パッケージのインストール失敗につながります。
二、TUNモードのコアメリット
TUN（Tunnel）モードはシステム層に仮想ネットワークアダプタを作成し、ネットワークスタックの最下層ですべてのトラフィックを傍受することで、上記の問題を根本的に解決します。
┌─────────────────────────────────────────────┐
│ アプリケーション層（ブラウザ/ターミナル/IDE/AIツール） │
│ ChatGPT Claude Code npm pip Cursor │
└──────────────────┬──────────────────────────┘
│ 全トラフィック
▼
┌──────────────────────────────────────────────┐
│ TUN仮想NIC (198.18.0.1) │
│ tun2socks → SOCKS5プロキシ │
└──────────────────┬───────────────────────────┘
│
▼
┌──────────────────────────────────────────────┐
│ Xrayプロキシコア（スマート/グローバルルーティング） │
└──────────────────────────────────────────────┘
TUNモードを有効にすると、ターミナル、IDE、AIツールは追加設定なしで自動的にプロキシ経由でネットワークにアクセスできます。
「全ネットワークトラフィックを傍受 — ターミナル/IDE/AIツールの追加設定は不要」
三、AI開発ワークフローへの具体的な利便性向上
1. Claude Code / Cursorなど AI CLIツール：ゼロ設定で即利用
以前Claude Codeを使用する際、ユーザーは以下の操作が必要でした：
# 以前：ターミナルを開くたびに設定が必要
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
claude # これでようやく接続可能
TUNモードでは：
# 現在：そのまま使用、追加操作は不要
claude # 自動的にプロキシ経由、即座に接続
2. AIモデルAPI呼び出し：開発テストのシームレスな連携
OpenAI、AnthropicなどのAPIを使用してアプリケーションを開発する際、コード内にプロキシ設定をハードコードしたり、実行環境にプロキシ変数を注入したりする必要がなくなります。TUNモードにより、 fetch、axios、httpx などのHTTPクライアントのリクエストはOS層で自動的にルーティングされます。
3. パッケージマネージャーと依存パッケージのダウンロード：タイムアウトとの決別
npm install、pip install、cargo build、go get などのコマンドはTUNモードですべて自動的にプロキシ経由となり、ネットワーク接続不良による依存パッケージのインストール失敗や長時間の待機が解消されます。
4. Git操作：プッシュ＆プルも自在に
git clone、git push、git pull などSSH/HTTPSプロトコルのGit操作もTUNで完全にカバーされ、Git用に個別のプロキシ設定を行う必要はありません。
四、安定性保証メカニズム
TUNモードはシステムネットワークスタックに深く介入するため、適切に処理しないと「ネットワーク切断」を引き起こす可能性があります。以下のメカニズムにより安定性を確保しています：
1. ルーティングループ防止（Anti-Routing Loop）
プロキシサーバーIP → 元のゲートウェイ経由（TUNをバイパス）
直接接続IPリスト → 元のゲートウェイ経由（TUNをバイパス）
0.0.0.0/1 → TUN経由（その他の全トラフィックをプロキシ）
128.0.0.0/1 → TUN経由
プロキシサーバー自体のトラフィックはTUNから除外され、「プロキシが自分自身をプロキシする」無限ループを防止します。
2. Watchdogプロセスガーディアン
特権ヘルパープロセスにはWatchdogメカニズムが内蔵されており、5秒ごとにElectronメインプロセスの生存を確認します。メインプロセスがクラッシュまたは予期せず終了した場合、Watchdogが自動的にクリーンアップを実行します：
- TUNルーティングルールの削除
- 元のDNS設定の復元
- tun2socksプロセスの終了
- システムネットワークの正常状態への復元
アプリケーションがクラッシュしても、ユーザーのインターネット接続が中断されることはありません。
3. DNS漏洩防止
TUNモードはDNSクエリを強制的に 8.8.8.8 と 1.1.1.1 にルーティングし、ローカルISP経由によるDNS解決の汚染や漏洩を防止します。これにより、AIツールが api.openai.com、api.anthropic.com などのドメインを正しく解決できることを保証します。
4. クロスプラットフォーム特権ヘルパーサービス
| プラットフォーム | 実装方式 | IPCチャネル |
|---|---|---|
| macOS | 特権ヘルパープロセス（launchd） | Unix Socket (/var/run/sulian-helper.sock) |
| Windows | Windowsサービス（SulianHelper） | Named Pipe (\\.\pipe\sulian-helper) |
| Linux | pkexec権限昇格 | 直接プロセス管理 |
各プラットフォームは独立した特権サービスによりネットワーク操作を実行し、メインプロセス自体は権限昇格を必要としません。最小権限の原則に準拠しています。
5. 優雅なエラーリカバリー
TUNの起動に失敗した場合（Helperが未インストールなど）、システムは以下の処理を行います：
- エラータイプの自動検出（
"helper service"、"Access is denied"など） - Helperインストールガイダンスダイアログの表示
- ワンクリックでの特権サービスインストールへの誘導
- インストール完了後の自動接続リトライ
五、スマートルーティングとグローバルルーティング
TUNモードは2つのルーティング戦略をサポートしています：
- グローバルプロキシ：すべてのトラフィックをプロキシ経由で送信。AIサービスの安定性が最も重要なシナリオに最適
- スマート分流：国内ドメイン/IPは直接接続、海外トラフィックのみプロキシ経由——AIツールのアクセシビリティを確保しつつ、国内サービスの速度に影響を与えません
六、技術実装の詳細
起動フロー
1. Xray設定からプロキシサーバーIPを取得
↓
2. ドメインをIPに解決（ルーティングループ防止）
↓
3. システムデフォルトゲートウェイとローカルNICを検出
↓
4. プラットフォーム特権サービスの初期化
- macOS: 特権ヘルパープロセス / osascriptフォールバック
- Windows: Windowsサービス
- Linux: tun2socks直接プロセス管理
↓
5. TUN仮想NICの作成（198.18.0.1）
↓
6. 分流ルーティングルールの設定
- プロキシサーバーIP → 元のゲートウェイ
- 直接接続IP → 元のゲートウェイ
- 0.0.0.0/1 + 128.0.0.0/1 → TUN
↓
7. DNS設定（8.8.8.8, 1.1.1.1）
↓
8. Watchdogプロセスガーディアンの起動
主要コンポーネント
| コンポーネント | 役割 |
|---|---|
| tun2socks | TUN NICのトラフィックをSOCKS5プロキシに転送 |
| wintun.dll | WindowsプラットフォームTUNドライバ（WireGuard由来） |
| sulian-helper | クロスプラットフォーム特権ヘルパーサービス（Go言語で開発） |
| Xray | マルチプロトコルおよびスマートルーティング対応のプロキシコア |
七、まとめ
| 比較項目 | システムプロキシモード | TUNモード |
|---|---|---|
| ブラウザ | 自動 | 自動 |
| ターミナル / CLI | 手動設定が必要 | 自動 |
| AIツール（Claude Codeなど） | 手動設定が必要 | 自動 |
| IDE AI補完 | 不明 | 自動 |
| パッケージマネージャー | 手動設定が必要 | 自動 |
| Git SSH/HTTPS | 手動設定が必要 | 自動 |
| クラッシュ後のネットワーク復旧 | 該当なし | Watchdog自動復旧 |
| DNS漏洩防止 | なし | あり |
TUNモードの導入は、本質的に「プロキシ設定」という開発者を長年悩ませてきた負担を、アプリケーション層からOS層へと引き下げるものです。AIツールへの依存度が高まる現代の開発ワークフローにおいて、TUNモードは付加価値ではなく、真のインフラストラクチャレベルの改善——開発者がコーディングと創造に集中し、「なぜ接続できないのか」の問題調査に時間を費やさずに済むようにするものです。