Aller au contenu
Configuration

Windows (WSL)

Même si OpenCode peut fonctionner directement sur Windows, nous recommandons d’utiliser Windows Subsystem for Linux (WSL) pour la meilleure expérience. WSL fournit un environnement Linux qui s’intègre parfaitement aux fonctionnalités d’OpenCode.

  1. Installez WSL

    Si ce n’est pas encore fait, installez WSL à l’aide du guide officiel Microsoft.

  2. Installez OpenCode dans WSL

    Une fois WSL configuré, ouvrez votre terminal WSL et installez OpenCode avec l’une des méthodes d’installation.

    Terminal
    curl -fsSL https://opencode.ai/install | bash

  3. Utilisez OpenCode depuis WSL

    Allez dans votre dossier de projet (accédez aux fichiers Windows via /mnt/c/, /mnt/d/, etc.) et lancez OpenCode.

    Terminal
    cd /mnt/c/Users/YourName/project
opencode

Si vous préférez utiliser l’application Desktop OpenCode tout en exécutant le serveur dans WSL:

  1. Démarrez le serveur dans WSL avec --hostname 0.0.0.0 pour autoriser les connexions externes:

    Terminal
    opencode serve --hostname 0.0.0.0 --port 4096

  2. Connectez l’application Desktop à http://localhost:4096

Pour la meilleure expérience web sous Windows:

  1. Exécutez opencode web dans le terminal WSL plutôt que dans PowerShell:

    Terminal
    opencode web --hostname 0.0.0.0

  2. Accédez-y depuis votre navigateur Windows à http://localhost:<port> (OpenCode affiche l’URL)

Lancer opencode web depuis WSL garantit un accès correct au système de fichiers et une bonne intégration terminal, tout en restant accessible depuis votre navigateur Windows.

WSL peut accéder à tous vos fichiers Windows via le répertoire /mnt/:

  • Lecteur C: → /mnt/c/
  • Lecteur D: → /mnt/d/
  • Et ainsi de suite…

Exemple:

Terminal
cd /mnt/c/Users/YourName/Documents/project
opencode

  • Gardez OpenCode dans WSL pour les projets stockés sur des lecteurs Windows: l’accès aux fichiers est fluide
  • Utilisez l’extension WSL de VS Code avec OpenCode pour un flux de travail intégré
  • Votre configuration OpenCode et vos sessions sont stockées dans l’environnement WSL à ~/.local/share/opencode/