Choisir ton environnement d'agents sur Linux, macOS ou Windows
- Publié le
Choisis l'installateur Paneflow pour le système et le processeur qui exécuteront l'application, puis installe tes agents dans le shell où vit ton projet. La compatibilité du terminal ne rend pas automatiquement compatible chaque combinaison d'agent, de runtime et de shell.
Matrice d'installation de Paneflow 0.17.4
Les fichiers ci-dessous ont été vérifiés dans la release 0.17.4 le 1er octobre 2026. Leur disponibilité ne constitue pas un test d'installation sur chaque machine. Paneflow est un logiciel libre et gratuit sous GPL-3.0-or-later.
| OS | Processeur | Référence d'installation | Contraintes d'exécution |
|---|---|---|---|
| Linux | x86_64 ou ARM64 (aarch64) | Linux : AppImage, .deb, .rpm, .tar.gz | Pilote et chargeur Vulkan fonctionnels ; dépendances du paquet ou de l'installation autonome à prévoir. |
| macOS 13+ | Apple Silicon (aarch64) | macOS : .dmg ou Homebrew | Build Apple Silicon, pas un binaire Intel. |
| Windows 10 1809+ ou Windows 11 | x64 (x86_64) | Windows : .msi | Pilote GPU fonctionnel, DirectX 11 niveau de fonctionnalités 10+, runtime terminal ConPTY. |
| macOS Intel | x86_64 | Aucun fichier natif dans cette release | Le DMG Apple Silicon n'est pas un installateur compatible. |
| Windows ARM | ARM64 | Aucun fichier natif dans cette release | Le MSI x64 ne constitue pas une installation ARM vérifiée. |
Les cibles de build, dépendances Linux et la référence Windows de la release étayent cette matrice. Le miroir Windows conserve un ancien exemple d'installateur ; prends les noms de fichiers dans la page d'installation actuelle. Une AppImage embarque l'application, pas un pilote GPU manquant.
Vérifier l'agent dans le bon shell
| Agent | Vérification effectuée pour ce guide | Documentation officielle |
|---|---|---|
| Claude Code | Windows x64 : claude --version indique 2.1.286 ; claude --help confirme le lancement interactif | Le guide d'installation couvre macOS, Linux, Windows natif et WSL. Sous Windows natif, Git for Windows fournit Bash ; sans lui, la documentation actuelle décrit l'outil PowerShell. Elle n'annonce pas de sandbox sous Windows natif. |
| Codex CLI | Windows x64 : codex --version indique 0.159.2 ; codex --help confirme le lancement interactif | Les références CLI et sandbox Windows couvrent Windows natif ainsi que macOS/Linux. Windows 11 est recommandé ; Windows 10 à jour est pris en charge au mieux. La sandbox native peut nécessiter des changements approuvés par un administrateur et dépendre des règles du poste. |
Sources consultées le 1er octobre 2026. Les contrôles de version et d'aide ne certifient ni authentification, ni exécution de modèle, ni sandbox, ni tous les shells, Linux ou macOS. Aucun autre agent n'a été testé pour ce guide. Distingue les permissions et prérequis de chaque agent de la matrice Paneflow.
Windows natif ou WSL ?
Pour tes dépôts et outils Windows, lance l'application installée par MSI depuis le menu Démarrer ou un shell Windows natif. Choisis ton shell dans Settings et vérifie le PATH de l'agent. Installer un agent dans WSL ne l'installe pas dans PowerShell, et inversement.
Si ta chaîne d'outils Linux vit déjà dans WSL2, garde dépôt, dépendances et agents dans cet environnement. La référence d'installation Windows décrit le build Linux dans WSL2 avec WSLg ; ses exigences graphiques restent applicables. Un shell WSL dans un panneau Paneflow natif est un autre choix que l'exécution de l'application Linux. Ne lance pas l'application Windows native depuis un shell hôte WSL. Aucune de ces deux configurations WSL n'a été exécutée pour ce guide.
La documentation WSL de Codex propose cette voie pour les outils Linux ou les besoins que la sandbox native ne couvre pas. Cela ne signifie pas que tous les agents exigent WSL sous Windows. Les capacités de sandbox de Claude Code diffèrent aussi entre Windows natif et WSL : suis sa référence sans supposer que le terminal fournit cette isolation.
Diagnostiquer la couche en échec
- Vérifie OS et processeur dans les informations système. Sur macOS Intel ou Windows ARM, l'absence de fichier natif est la limite : consulte la référence d'installation plutôt que de deviner un installateur.
- Si Paneflow n'ouvre pas de fenêtre, vérifie les prérequis GPU/runtime de la plateforme, puis le dépannage. Changer d'agent ne répare pas un pilote graphique manquant.
- Si l'application s'ouvre mais que
claudeoucodexest introuvable, lance sa commande de version dans ce panneau précis. Vérifie le PATH et le lieu d'installation, Windows natif ou WSL, puis suis la documentation de l'agent. - Si la CLI démarre mais ne s'authentifie pas ou ne lance pas de tâche de modèle, vérifie ses identifiants, permissions, réseau et accès fournisseur. Réinstaller Paneflow ne crée pas ces prérequis.
Une fois application et agent fonctionnels dans l'environnement choisi, utilise la référence des worktrees pour séparer les changements parallèles. Les détails d'installation restent dans la référence de plateforme, sans variante de procédure pour chaque distribution ou agent.