Paneflow を動かす OS と CPU に合うインストーラーを選び、その後、プロジェクトを扱うシェルにエージェントを導入します。ターミナルアプリが対応していても、すべてのエージェント、ランタイム、シェルの組み合わせが動くとは限りません。

## Paneflow 0.17.4 のインストール対応表

以下の配布物は 2026 年 10 月 1 日に [0.17.4 リリース](https://github.com/arthjean/paneflow/releases/tag/v0.17.4)と照合しました。配布物の存在は、すべてのマシンでのインストール検証ではありません。Paneflow は GPL-3.0-or-later の無料の自由ソフトウェアです。

| OS | CPU | インストール手順 | 実行時の条件 |
| --- | --- | --- | --- |
| Linux | x86_64 または ARM64（`aarch64`） | [Linux](/ja/docs/installation/linux)：AppImage、`.deb`、`.rpm`、`.tar.gz` | 動作する Vulkan ドライバーとローダー。パッケージ版・単体版の依存関係も必要です。 |
| macOS 13+ | Apple Silicon（`aarch64`） | [macOS](/ja/docs/installation/macos)：`.dmg` または Homebrew | Apple Silicon ビルドであり、Intel バイナリではありません。 |
| Windows 10 1809+ または Windows 11 | x64（`x86_64`） | [Windows](/ja/docs/installation/windows)：`.msi` | 動作する GPU ドライバー、DirectX 11 の機能レベル 10+、ConPTY ターミナルランタイム。 |
| macOS Intel | x86_64 | このリリースにネイティブ配布物なし | Apple Silicon DMG を対応インストーラーとして選ばないでください。 |
| Windows ARM | ARM64 | このリリースにネイティブ配布物なし | x64 MSI を検証済み ARM インストールとして扱わないでください。 |

根拠はリリースの[ビルド対象](https://github.com/arthjean/paneflow/blob/v0.17.4/.github/workflows/release.yml)、[Linux 依存関係](https://github.com/arthjean/paneflow/blob/v0.17.4/src-app/Cargo.toml)、[Windows ランタイム文書](https://github.com/arthjean/paneflow/blob/v0.17.4/docs/user/installation/windows.md)です。Windows のミラー文書には古いインストーラー例が残るため、ファイル名は現在のインストールページを参照してください。AppImage はアプリをまとめたもので、欠けた GPU ドライバーを補うものではありません。

## 使用するシェルでエージェントを確認する

| エージェント | このガイドで実際に確認した内容 | 公式の対応情報 |
| --- | --- | --- |
| Claude Code | Windows x64：`claude --version` は 2.1.286、`claude --help` で対話起動を確認 | [セットアップ](https://code.claude.com/docs/en/setup)は macOS、Linux、Windows ネイティブ、WSL を説明しています。Windows ネイティブでは Git for Windows により Bash が使え、未導入時は現在の文書では PowerShell ツールを使います。同文書では Windows ネイティブのサンドボックスは非対応です。 |
| Codex CLI | Windows x64：`codex --version` は 0.159.2、`codex --help` で対話起動を確認 | [CLI](https://github.com/openai/codex) と [Windows サンドボックス](https://developers.openai.com/codex/windows/windows-sandbox)は Windows ネイティブと macOS/Linux を説明しています。Windows 11 を推奨し、更新済み Windows 10 はベストエフォートです。ネイティブサンドボックスの設定には管理者の承認や端末ポリシーへの適合が必要になる場合があります。 |

エージェントの資料は 2026 年 10 月 1 日に参照しました。バージョンとヘルプの確認は、認証、モデル実行、サンドボックス、すべてのシェル、Linux、macOS の動作保証ではありません。他のエージェントは本ガイドでは検証していません。エージェントの権限と要件は Paneflow の対応表とは別に確認してください。

## Windows ネイティブか WSL か

Windows のリポジトリとツールを使うなら、MSI で導入したアプリをスタートメニューまたは Windows ネイティブのシェルから起動します。Settings でシェルを選び、エージェントの PATH を確認します。WSL に導入したエージェントが PowerShell にも導入されるわけではなく、逆も同様です。

Linux のツールチェーンがすでに WSL2 にあるなら、リポジトリ、依存関係、エージェントをその環境にまとめます。[Windows インストール手順](/ja/docs/installation/windows)では WSL2 と WSLg で Linux ビルドを動かす方法を説明しています。グラフィックス要件は引き続き必要です。ネイティブ Paneflow のペイン内で WSL シェルを使うことと、Linux アプリを動かすことは別です。Windows ネイティブアプリを WSL ホストシェルから起動しないでください。このガイドではどちらの WSL 構成も実行検証していません。

Codex の現在の [WSL ガイド](https://developers.openai.com/codex/windows/wsl)は、Linux ツールやネイティブサンドボックスで満たせない要件にこの方法を案内しています。すべてのエージェントに WSL が必須という意味ではありません。Claude Code のサンドボックス機能も両環境で異なります。ターミナルがサンドボックスを提供すると考えず、公式セットアップを確認してください。

## 失敗した層を切り分ける

1. システム情報で OS と CPU を確認します。Intel macOS や Windows ARM ではネイティブ配布物がないことが境界です。インストーラーを推測せず、[インストールのリファレンス](/ja/docs/installation)を確認します。
2. Paneflow がウィンドウを開けない場合は、プラットフォームの GPU・ランタイム要件と[トラブルシューティング](/ja/docs/troubleshooting)を確認します。エージェントを変えても不足するドライバーは直りません。
3. アプリは開くのに `claude` や `codex` がない場合は、そのペインでバージョンコマンドを実行します。PATH と Windows ネイティブ／WSL のどちらに導入したかを確認し、エージェントの手順に従います。
4. CLI が起動しても認証やモデルタスクで失敗する場合は、認証情報、権限、ネットワーク、プロバイダーへのアクセスを調べます。Paneflow の再インストールではこれらの前提は満たされません。

アプリとエージェントが目的の環境で動いたら、[worktree リファレンス](/ja/docs/worktrees)を使って並行する変更を分離できます。ディストリビューションやエージェントごとの似た手順を増やさず、インストールの詳細は各プラットフォームのリファレンスを参照してください。