OpenCode

Vue d’ensemble

Type: Outil de codeChemin principal: compatible OpenAINiveau de support: Chemin pris en charge

OpenCode est un assistant de codage IA open-source qui s’exécute dans votre terminal. Il prend en charge plusieurs fournisseurs de LLM et peut être configuré pour utiliser l’API de TokenLab afin d’accéder à plus de 300 modèles.

Installation

Script d’installation
Homebrew
Go

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

brew install opencode-ai/tap/opencode

Ou utilisez le tap communautaire (mises à jour plus fréquentes) :

brew install anomalyco/tap/opencode

go install github.com/opencode-ai/opencode@latest

Vérifiez l’installation :

opencode --version

Configuration

Étape 1 : Définir les variables d’environnement

export OPENAI_API_KEY="sk-your-tokenlab-key"

Pour une configuration permanente, ajoutez ceci à ~/.bashrc ou ~/.zshrc :

echo 'export OPENAI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
source ~/.zshrc

Étape 2 : Configurer OpenCode

La documentation actuelle d’OpenCode recommande de configurer les fournisseurs via opencode.json ou opencode.jsonc. Pour TokenLab, utilisez un fournisseur personnalisé au lieu de surcharger le fournisseur openai intégré :

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenlab": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenLab",
      "options": {
        "baseURL": "https://api.tokenlab.sh/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5-mini": {
          "name": "GPT-5 Mini"
        }
      }
    }
  },
  "model": "tokenlab/gpt-5.4"
}

Utilisez @ai-sdk/openai-compatible pour une compatibilité de type chat-completions. Si vous avez spécifiquement besoin d’un chemin de fournisseur construit sur /v1/responses, la documentation des fournisseurs d’OpenCode recommande de remplacer le package par @ai-sdk/openai.

Utilisation de base

Démarrer le mode interactif :

opencode

Exécuter avec un prompt :

opencode "Explain this codebase"

Spécifier un modèle :

opencode --model tokenlab/gpt-5.4 "Fix the bugs in main.py"

Modèles disponibles

Modèle	Idéal pour
`gpt-5.4`	Tâches complexes, architecture du code
`gpt-5-mini`	Corrections rapides, requêtes simples
`claude-sonnet-4-6`	Revue de code, documentation
`claude-opus-4-6`	Raisonnement complexe
`gemini-3.5-flash`	Réponses rapides
`deepseek-r1`	Conception d’algorithmes

Commandes courantes

Analyser du code :

opencode "What does this function do?" < src/utils.ts

Générer du code :

opencode "Create a REST API with Express"

Examiner les modifications :

git diff | opencode "Review these changes"

Corriger les erreurs :

opencode "Fix the TypeScript errors in this project"

Commandes interactives

Commande	Description
`/help`	Afficher les commandes disponibles
`/model <name>`	Basculer vers un autre modèle
`/clear`	Effacer l’historique de la conversation
`/exit`	Quitter OpenCode

Dépannage

Erreur de connexion

Vérifiez que options.baseURL est défini sur https://api.tokenlab.sh/v1
Vérifiez la connectivité réseau
Essayez curl https://api.tokenlab.sh/v1/models pour tester

Échec de l’authentification

Vérifiez que la variable d’environnement OPENAI_API_KEY est définie
Vérifiez que options.apiKey référence {env:OPENAI_API_KEY} ou une autre source secrète valide
Vérifiez que la clé commence par sk-
Assurez-vous que la clé est active dans le tableau de bord TokenLab

Modèle introuvable

Vérifiez que le nom du modèle dans la configuration correspond exactement
Vérifiez la disponibilité du modèle sur tokenlab.sh/en/models

Bonnes pratiques

Utiliser le contexte du projet

Exécutez OpenCode depuis la racine de votre projet pour une meilleure compréhension de votre base de code.

Choisir des modèles appropriés

Utilisez des modèles plus rapides (gpt-5-mini) pour les tâches simples et des modèles plus puissants (gpt-5.4, claude-sonnet-4-6) pour les tâches complexes.

Relire le code généré

Relisez toujours le code généré par l’IA avant d’appliquer des modifications à votre projet.

Matrice de compatibilité

Outils de code

SDK natifs

Frameworks et plateformes

Apps de chat

Vue d’ensemble

Installation

Configuration

Étape 1 : Définir les variables d’environnement

Étape 2 : Configurer OpenCode

Utilisation de base

Modèles disponibles

Commandes courantes

Commandes interactives

Dépannage

Bonnes pratiques

​Vue d’ensemble

​Installation

​Configuration

​Étape 1 : Définir les variables d’environnement

​Étape 2 : Configurer OpenCode

​Utilisation de base

​Modèles disponibles

​Commandes courantes

​Commandes interactives

​Dépannage

​Bonnes pratiques

Vue d’ensemble

Installation

Configuration

Étape 1 : Définir les variables d’environnement

Étape 2 : Configurer OpenCode

Utilisation de base

Modèles disponibles

Commandes courantes

Commandes interactives

Dépannage

Bonnes pratiques