OpenCode

OpenCode prend désormais en charge les principales familles de modèles telles que GPT, Claude, DeepSeek, Gemini et Qwen. Pour les scénarios d’usage d’OpenCode, les modèles suivants sont recommandés :

coding-minimax-m2.1-free
coding-glm-4.7-free
claude-sonnet-4-5
gpt-5
gpt-5-codex

Ce document explique comment installer, configurer et lancer OpenCode sur différents systèmes d’exploitation, et comment intégrer l’API AIHubMix.

Avant l’installation, assurez-vous que votre système répond aux exigences suivantes :

Node.js ≥ 18.0.0
Gestionnaires de paquets facultatifs pour votre système d’exploitation :
- macOS / Linux : brew
- Arch Linux : paru
- Windows : choco, winget ou scoop

1. Installation d’OpenCode

Choisissez l’une des méthodes d’installation suivantes en fonction de votre système d’exploitation et de vos préférences d’outillage.

1. Installation via Node.js

# Quick install using a CURL script
curl -fsSL https://opencode.ai/install | bash

# Using NPM
npm install -g opencode-ai

# Using Bun
bun install -g opencode-ai

# Using PNPM
pnpm install -g opencode-ai

# Using Yarn
yarn global add opencode-ai

2. Installation via Homebrew (macOS / Linux)

brew install sst/tap/opencode

3. Installation via Paru (Arch Linux)

paru -S opencode-bin

4. Installation Windows

# Chocolatey
choco install opencode

# WinGet
winget install opencode

# Scoop
scoop bucket add extras
scoop install extras/opencode

# Or install via NPM (Node.js required)
# Note: Administrator privileges are required
npm install -g opencode-ai

2. Lancement et connexion à OpenCode

Après l’installation, suivez les étapes ci-dessous pour terminer l’authentification et la configuration.

1. Se connecter à OpenCode

Exécutez la commande suivante dans votre terminal :

opencode auth login

2. Sélectionner le fournisseur d’IA

Sur l’écran de connexion, sélectionnez AiHubMix comme fournisseur de modèles.

3. Autorisation par clé API

Entrez votre clé API AiHubMix sur la page de connexion d’OpenCode pour finaliser l’autorisation.

3. Utilisation des modèles

1. Vérification de l’installation

Exécutez la commande suivante pour vérifier qu’OpenCode est correctement installé et configuré :

opencode

2. Sélectionner un modèle

Tapez /models, recherchez aihubmix et sélectionnez le modèle souhaité.

4. Utilisation d’AiHubMix dans l’application de bureau OpenCode

Téléchargez l’application de bureau OpenCode : https://opencode.ai/download .
Ouvrez OpenCode et suivez les étapes : /model → Connect provider → recherchez aihubmix → entrez votre clé API → Submit.
Dans le panneau de sélection de modèle, recherchez aihubmix et sélectionnez le modèle que vous souhaitez utiliser.

5. Configurer et mettre à jour les modèles manuellement

Cet exemple ajoute DeepSeek V4 Pro.

Étape 1 : Confirmer l’ID du modèle

Trouvez le modèle cible sur la page des modèles AIHubMix et copiez son ID. Vous pouvez également l’interroger directement via l’API :

curl https://aihubmix.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY" \
  | python3 -m json.tool | grep "id"

Étape 2 : Ouvrir le fichier de configuration

Exécutez dans un terminal la commande correspondant à votre système : Mac

mkdir -p ~/.config/opencode && open -a TextEdit ~/.config/opencode/opencode.json

Linux

mkdir -p ~/.config/opencode && nano ~/.config/opencode/opencode.json

Windows (à exécuter dans PowerShell)

New-Item -ItemType Directory -Force "$env:USERPROFILE\.config\opencode"
notepad "$env:USERPROFILE\.config\opencode\opencode.json"

Une fois le fichier ouvert, vous verrez soit un fichier vide, soit un contenu JSON existant.

Étape 3 : Écrire la configuration

Si le fichier est vide, collez directement le contenu suivant :

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aihubmix": {
      "models": {
        "deepseek-v4-pro": {
          "name": "DeepSeek-V4-Pro",
          "contextLength": 131072,
          "type": "language"
        }
      }
    }
  }
}

Si le fichier contient déjà des données, ajoutez le nouveau modèle dans "models", en séparant chaque modèle par une virgule :

"models": {
  "deepseek-v4-pro": {
    "name": "DeepSeek-V4-Pro",
    "contextLength": 131072,
    "type": "language"
  },
  "deepseek-v4-flash-think": {
    "name": "DeepSeek-V4-Flash-Think",
    "contextLength": 131072,
    "type": "language"
  }
}

Remarque : n’ajoutez pas de virgule après le dernier modèle, sinon le format du fichier sera invalide.

Enregistrez le fichier : Command + S sur Mac, Ctrl + S sur Windows. Description des champs :

Champ	Description
`name`	ID du modèle
`contextLength`	Longueur de contexte (en tokens)
`type`	Type de modèle ; utilisez `"language"` pour la conversation textuelle

Étape 4 : Redémarrer OpenCode

Après avoir enregistré le fichier de configuration, quittez complètement OpenCode puis relancez-le pour que le nouveau modèle soit chargé.

Étape 5 : Vérifier

Ouvrez le sélecteur de modèles (raccourci par défaut ;), recherchez V4 ou DeepSeek et vérifiez que DeepSeek-V4-Pro apparaît dans la liste.

URL de base personnalisée

Par défaut, OpenCode envoie les requêtes d’AIHubMix vers https://aihubmix.com/v1. Si vous avez besoin de faire transiter les requêtes par une passerelle auto-hébergée, un proxy d’entreprise ou un nœud d’accélération, vous pouvez le surcharger via options.baseURL, sans modifier le code source d’OpenCode ni le réinstaller.

Étape 1 : Ouvrir le fichier de configuration

Ouvrez ~/.config/opencode/opencode.json comme indiqué à la section 5 (sous Windows, %USERPROFILE%\.config\opencode\opencode.json).

Étape 2 : Ajouter `options.baseURL`

Ajoutez options.baseURL sous le provider aihubmix. Il suffit d’écrire ce seul champ : OpenCode le fusionnera automatiquement en profondeur avec la configuration intégrée, vous n’avez pas besoin de réécrire l’intégralité du provider :

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aihubmix": {
      "options": {
        "baseURL": "https://api.inferera.com"
      }
    }
  }
}

Remarque : baseURL ne doit être renseigné qu’au niveau du domaine (par exemple https://api.inferera.com), le chemin étant automatiquement ajouté par le SDK. N’ajoutez pas vous-même /v1 (par exemple https://api.inferera.com/v1), sinon il serait concaténé en /v1/v1/, ce qui provoquerait une erreur 404.

Étape 3 : Redémarrer et vérifier

Quittez complètement OpenCode, puis relancez-le. Exécutez la commande suivante pour confirmer :

opencode debug config

Dans la sortie, vous devriez voir l’adresse que vous avez renseignée dans provider.aihubmix.options.baseURL.

Champ	Description
`options.baseURL`	Adresse de requête personnalisée, prioritaire sur l’adresse par défaut ; il suffit de la renseigner au niveau du domaine.

7. FAQ et conseils

Si la clé API échoue à la validation, reconnectez-vous à la console AiHubMix et vérifiez que la clé est valide : https://console.aihubmix.com/token
Consultez la documentation d’aide intégrée : opencode → /help
Documentation officielle d’OpenCode : https://opencode.ai/docs/

Dernière mise à jour : 2026-07-29

Assistants de codage

Intégrations IDE

Agent / Workflow

SDKs et frameworks

1. Installation d’OpenCode

1. Installation via Node.js

2. Installation via Homebrew (macOS / Linux)

3. Installation via Paru (Arch Linux)

4. Installation Windows

2. Lancement et connexion à OpenCode

1. Se connecter à OpenCode

2. Sélectionner le fournisseur d’IA

3. Autorisation par clé API

3. Utilisation des modèles

1. Vérification de l’installation

2. Sélectionner un modèle

4. Utilisation d’AiHubMix dans l’application de bureau OpenCode

5. Configurer et mettre à jour les modèles manuellement

Étape 1 : Confirmer l’ID du modèle

Étape 2 : Ouvrir le fichier de configuration

Étape 3 : Écrire la configuration

Étape 4 : Redémarrer OpenCode

Étape 5 : Vérifier

URL de base personnalisée

Étape 1 : Ouvrir le fichier de configuration

Étape 2 : Ajouter `options.baseURL`

Étape 3 : Redémarrer et vérifier

7. FAQ et conseils

​1. Installation d’OpenCode

​1. Installation via Node.js

​2. Installation via Homebrew (macOS / Linux)

​3. Installation via Paru (Arch Linux)

​4. Installation Windows

​2. Lancement et connexion à OpenCode

​1. Se connecter à OpenCode

​2. Sélectionner le fournisseur d’IA

​3. Autorisation par clé API

​3. Utilisation des modèles

​1. Vérification de l’installation

​2. Sélectionner un modèle

​4. Utilisation d’AiHubMix dans l’application de bureau OpenCode

​5. Configurer et mettre à jour les modèles manuellement

​Étape 1 : Confirmer l’ID du modèle

​Étape 2 : Ouvrir le fichier de configuration

​Étape 3 : Écrire la configuration

​Étape 4 : Redémarrer OpenCode

​Étape 5 : Vérifier

​ URL de base personnalisée

​Étape 1 : Ouvrir le fichier de configuration

​Étape 2 : Ajouter options.baseURL

​Étape 3 : Redémarrer et vérifier

​7. FAQ et conseils

1. Installation d’OpenCode

1. Installation via Node.js

2. Installation via Homebrew (macOS / Linux)

3. Installation via Paru (Arch Linux)

4. Installation Windows

2. Lancement et connexion à OpenCode

1. Se connecter à OpenCode

2. Sélectionner le fournisseur d’IA

3. Autorisation par clé API

3. Utilisation des modèles

1. Vérification de l’installation

2. Sélectionner un modèle

4. Utilisation d’AiHubMix dans l’application de bureau OpenCode

5. Configurer et mettre à jour les modèles manuellement

Étape 1 : Confirmer l’ID du modèle

Étape 2 : Ouvrir le fichier de configuration

Étape 3 : Écrire la configuration

Étape 4 : Redémarrer OpenCode

Étape 5 : Vérifier

URL de base personnalisée

Étape 1 : Ouvrir le fichier de configuration

Étape 2 : Ajouter `options.baseURL`

Étape 3 : Redémarrer et vérifier

7. FAQ et conseils