Linux・macOS・Windows でコーディングエージェントの作業環境を選ぶ

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

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

以下の配布物は 2026 年 10 月 1 日に 0.17.4 リリースと照合しました。配布物の存在は、すべてのマシンでのインストール検証ではありません。Paneflow は GPL-3.0-or-later の無料の自由ソフトウェアです。

根拠はリリースのビルド対象、Linux 依存関係、Windows ランタイム文書です。Windows のミラー文書には古いインストーラー例が残るため、ファイル名は現在のインストールページを参照してください。AppImage はアプリをまとめたもので、欠けた GPU ドライバーを補うものではありません。

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

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

Windows ネイティブか WSL か

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

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

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

失敗した層を切り分ける

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

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