Aller au contenu principal

Installer et utiliser OpenCode

OpenCode est un outil de codage agentic. L'outil est disponible comme application terminal, application desktop et extension IDE.

AI-School recommande surtout OpenCode aux enseignants, administrateurs et élèves ayant beaucoup d'expérience en programmation. OpenCode peut travailler de manière plus autonome qu'Aider et peut donc effectuer rapidement beaucoup de modifications.

Tu trouveras plus d'informations sur le site d'OpenCode et dans la documentation officielle d'OpenCode.

Quand choisir OpenCode ?​

Choisis OpenCode si l'utilisateur :

  • a de l'expérience avec le terminal, les éditeurs de code et Git
  • comprend comment les fichiers locaux sont modifiés
  • peut contrôler les modifications avant de les utiliser
  • veut travailler sur des tâches de programmation plus complexes

Pour l'apprentissage de la programmation en classe avec des débutants, Aider est généralement plus adapté.

Installation​

L'installation la plus simple selon la documentation d'OpenCode est :

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

Tu peux aussi installer OpenCode avec Node.js :

npm install -g opencode-ai

Ou avec Homebrew sur macOS et Linux :

brew install anomalyco/tap/opencode

Se connecter à Codage​

OpenCode prend en charge les fournisseurs personnalisés compatibles OpenAI. Crée dans le dossier du projet un fichier opencode.json.

Utilise-y l'endpoint Codage et les modèles autorisés :

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-school-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-School Codage",
      "options": {
        "baseURL": "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_SCHOOL_CODEREN_API_KEY}"
      },
      "models": {
        "gpt-5.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.4-mini",
  "small_model": "ai-school-coderen/gpt-5.4-mini"
}

Définis ensuite l'API key comme variable d'environnement.

macOS et Linux​

export AI_SCHOOL_CODEREN_API_KEY="ais.votre-api-key"

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.votre-api-key"

Ouvre ensuite un nouveau terminal.

Démarrer OpenCode​

Va dans le dossier du projet :

cd chemin/vers/ton/projet

Démarre OpenCode :

opencode

Utilise dans OpenCode le choix du modèle pour sélectionner le modèle AI-School Codage si cela ne se fait pas automatiquement.

Travailler en sécurité avec OpenCode​

Comme OpenCode fonctionne de manière agentic, il est important de contrôler les modifications.

Méthode recommandée :

  1. Travaille dans un dépôt Git.
  2. Commence par de petites consignes.
  3. Vérifie les diffs avant d'utiliser le code.
  4. Teste l'application après les modifications.
  5. Commit uniquement les modifications que tu comprends.

Pour les élèves ayant peu d'expérience, il est conseillé d'utiliser OpenCode d'abord en démonstration, avec l'accompagnement d'un enseignant.

Variables d'environnement et OpenCode​

Pour OpenCode, vous pouvez enregistrer la cl? API de codage dans un fichier .env local dans le dossier du projet :

AI_SCHOOL_CODEREN_API_KEY=ais.votre-cle-api

Assurez-vous qu'OpenCode charge r?ellement cette variable d'environnement. Dans PowerShell, vous pouvez aussi la d?finir temporairement pour le terminal actuel :

$env:AI_SCHOOL_CODEREN_API_KEY="ais.votre-cle-api"

Si vous voyez Authorization header met Bearer token is verplicht, l'outil n'a pas envoy? la cl? sous la forme Authorization: Bearer .... Si vous voyez Unknown parameter, supprimez les param?tres sp?cifiques au fournisseur que l'endpoint de codage de AI-School ne prend pas en charge.