Passer au contenu principal

Présentation

OpenCode Interface OpenCode est un outil de programmation en ligne de commande (CLI) open source basé sur Go qui fournit une assistance IA puissante aux développeurs. Il offre une interface utilisateur en terminal (TUI) intuitive et prend en charge plusieurs fournisseurs de LLM, notamment OpenAI, Anthropic, Gemini, et bien d’autres. En intégrant OpenCode avec EvoLink API, vous pouvez accéder aux modèles Claude d’EvoLink (tels que Claude 4.5 Opus, Claude 4.5 Sonnet, Claude 4.5 Haiku) via une interface unifiée avec une seule clé et une seule URL de base.

Prérequis

Avant de configurer, assurez-vous de disposer de :

1. Émulateur de terminal

OpenCode nécessite un émulateur de terminal moderne. Options recommandées :
  • WezTerm (multiplateforme)
  • Alacritty (multiplateforme)
  • Ghostty (Linux et macOS)
  • Kitty (Linux et macOS)
Les utilisateurs Windows peuvent également utiliser PowerShell ou Windows Terminal. Les utilisateurs macOS peuvent utiliser l’application Terminal intégrée ou iTerm2. Les utilisateurs Linux peuvent utiliser le terminal intégré ou GNOME Terminal, Konsole, etc.
  • Connectez-vous au tableau de bord EvoLink
  • Trouvez les clés API dans le tableau de bord, cliquez sur le bouton « Créer une nouvelle clé », puis copiez la clé générée
  • La clé API commence généralement par sk-

Étape 1 : Installer OpenCode

Astuce : Si vous ne savez pas comment ouvrir un terminal en ligne de commande, consultez FAQ - Comment ouvrir un terminal en ligne de commande
Le moyen le plus simple est d’utiliser le script d’installation :
curl -fsSL https://opencode.ai/install | bash
Ou via Homebrew :
brew install anomalyco/tap/opencode

Vérifier l’installation

opencode --version
Indicateur de réussite : Affiche les informations de version. Si vous préférez une interface graphique, OpenCode propose également une application de bureau disponible sur la page de téléchargement d’OpenCode.

1. Initialiser le fournisseur

Après l’installation, exécutez la commande suivante dans votre terminal avant de lancer OpenCode :
opencode auth login
Sélectionner le fournisseur
  1. Dans la liste des fournisseurs, sélectionnez other (en bas, vous pouvez le rechercher)
  2. Entrez l’Provider ID : tapez evolink
Entrer le Provider ID
  1. Entrez le API Key token : vous pouvez entrer n’importe quelle valeur (par ex., admin), la clé réelle est référencée via le fichier de configuration
Entrer la clé API Cette étape enregistre un fournisseur personnalisé dans le gestionnaire d’identifiants local d’OpenCode.

2. Modifier le fichier de configuration

Ouvrez le répertoire de configuration d’OpenCode :
Appuyez sur Win + R, collez ce qui suit, puis appuyez sur Entrée :
%userprofile%\.config\opencode
Répertoire de configuration Windows
Créez ou modifiez opencode.json dans ce répertoire :
{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "evolink": {
            "npm": "@ai-sdk/anthropic",
            "name": "Evolink",
            "options": {
                "baseURL": "https://code.evolink.ai/v1",
                "apiKey": "your-evolink-api-key"
            },
            "models": {
                "claude-opus-4-5-20251101": {
                    "name": "Claude-4.5-Opus"
                },
                "claude-sonnet-4-5-20250929": {
                    "name": "Claude-4.5-Sonnet"
                },
                "claude-haiku-4-5-20251001": {
                    "name": "Claude-4.5-Haiku"
                }
            }
        }
    }
}
Important :
  • Remplacez "your-evolink-api-key" par votre clé API réelle
  • Le format JSON est sensible aux symboles

Étape 3 : Commencer à utiliser OpenCode

1. Lancer OpenCode

Après avoir enregistré le fichier de configuration, redémarrez votre terminal, puis accédez à votre répertoire de travail :
cd your-working-directory
Lancez OpenCode :
opencode

2. Vérifier la configuration

Dans l’interface de chat, entrez la commande :
/models
Interface OpenCode et sélection de modèle Vous devriez voir Evolink et ses modèles dans la liste des modèles. Sélectionnez-en un et vous êtes prêt !

FAQ

1. Qu’est-ce qu’OpenCode et à quoi sert-il ?

OpenCode est un assistant de codage IA en terminal open source avec une interface TUI moderne. Il prend en charge l’édition de code, les opérations sur les fichiers et l’exécution de commandes, idéal pour la programmation assistée par IA dans les environnements de terminal.

2. Comment vérifier l’installation et la configuration lors de la première utilisation ?

Suivez ces étapes dans l’ordre :
  • opencode --version : Confirmer qu’OpenCode est installé
  • Lancez OpenCode et entrez /models : Confirmer que vous pouvez voir les modèles configurés

3. Où placer le fichier de configuration ?

Le fichier de configuration opencode.json doit être placé à :
  • Windows : C:\Users\{username}\.config\opencode\opencode.json
  • macOS / Linux : ~/.config/opencode/opencode.json

4. Quels modèles OpenCode prend-il en charge ?

Via l’API EvoLink, OpenCode prend en charge les modèles Claude suivants :
  • Claude 4.5 Opus : Le modèle le plus puissant pour les tâches complexes
  • Claude 4.5 Sonnet : Équilibre entre performance et rapidité
  • Claude 4.5 Haiku : Le modèle le plus rapide pour les tâches simples

5. Comment changer de modèle ?

Dans l’interface OpenCode, entrez la commande /models, puis sélectionnez le modèle souhaité dans la liste.

6. Pourquoi mes modifications de configuration ne prennent-elles pas effet ?

  • Redémarrez OpenCode
  • Vérifiez la syntaxe de opencode.json (format JSON)
  • Vérifiez que le chemin du fichier de configuration est correct

7. Quelles sont les causes des erreurs 401/403 ?

  • Erreur 401 : Clé API non définie ou invalide
  • Erreur 403 : Permissions insuffisantes ou clé expirée
  • Vérifiez le champ apiKey dans votre fichier de configuration

8. OpenCode lira-t-il ou téléchargera-t-il automatiquement mes fichiers et mon code local ?

OpenCode ne lit le contenu des fichiers que lorsque vous l’autorisez explicitement. Il est recommandé de l’utiliser dans un dossier de projet dédié.

9. OpenCode prend-il en charge la saisie et la sortie en chinois ?

Oui, entièrement pris en charge.

10. Pour quels scénarios OpenCode est-il adapté ?

Adapté pour :
  • Écriture, débogage et refactorisation de code
  • Programmation assistée par IA dans les environnements de terminal
  • Analyse et traitement du contenu de fichiers
  • Utilisateurs qui préfèrent les interfaces TUI modernes
Non adapté pour :
  • Interactions GUI complexes
  • Utilisateurs non familiers avec les opérations en terminal

11. Comment ouvrir un terminal en ligne de commande ?

  • Méthode 1 : Appuyez sur Win + R, tapez cmd ou powershell, puis appuyez sur Entrée
  • Méthode 2 : Recherchez « Invite de commandes » ou « PowerShell » dans le menu Démarrer
  • Méthode 3 : Maintenez Maj et faites un clic droit dans un dossier, sélectionnez « Ouvrir une fenêtre PowerShell ici »

Remarques

Exécutez OpenCode dans un dossier de projet dédié. Évitez de l’exécuter dans des répertoires sensibles (tels que les dossiers système ou les répertoires contenant des identifiants). OpenCode opère à partir du répertoire de travail actuel.
OpenCode utilise des fichiers de configuration au format JSON. Assurez-vous que la syntaxe de votre fichier de configuration est correcte. Vous pouvez utiliser des validateurs JSON en ligne pour vérifier le format.