Invitez des amis et gagnez des tokens gratuits !En savoir plus

Connecter les modèles personnalisés CodingPlanX à OpenCode

> Utilisez l'assistant de programmation IA en terminal open source OpenCode avec l'API CodingPlanX pour créer l'expérience de développement en ligne de commande ultime.

🌟 Présentation du projet

OpenCode est un assistant de programmation IA en terminal 100 % open source. Son concept est similaire à celui de Claude Code, mais il offre une flexibilité et des capacités de personnalisation extrêmement élevées. Il n'est lié à aucun fournisseur de services d'IA spécifique, prend en charge le basculement libre entre plusieurs modèles, l'intégration native du LSP (Language Server Protocol) et dispose d'une interface utilisateur en terminal (TUI) au style très « geek ».

Capture d'écran de l'interface OpenCode

1. Fonctionnalités de base d'OpenCode

OpenCode est un agent de programmation IA open source développé par l'équipe SST, spécialement conçu pour les geeks et les utilisateurs intensifs du terminal :

  • 🔓 100 % Open Source : Basé sur la licence MIT, le code est totalement transparent.
  • 🧠 Prise en charge multi-modèles : Vous pouvez configurer et basculer de manière transparente entre plusieurs modèles tels que Claude, OpenAI, Google Gemini, etc.
  • ⚡ Prise en charge native du LSP : Protocole de serveur de langage intégré, offrant une analyse de code et une navigation intelligentes, rapides et précises.
  • 🖥️ Priorité à la TUI : Conçu spécifiquement pour les utilisateurs de terminal, créé par des utilisateurs expérimentés de Neovim, opérable entièrement au clavier.
  • 🌐 Architecture Client/Serveur : Prend en charge le contrôle à distance, vous pouvez exécuter le serveur sur votre machine locale et le contrôler à distance depuis un appareil mobile ou un autre ordinateur.
  • 🔄 Double agent intégré : Comprend par défaut build (autorisations complètes de lecture/écriture, pour le développement principal) et plan (autorisation de lecture seule, utilisé pour l'analyse et la planification).

2. oh-my-opencode (Pack d'amélioration recommandé)

oh-my-opencode est le plugin d'amélioration le plus puissant pour OpenCode, qualifié par la communauté de "OpenCode sous stéroïdes". Il vous offre une expérience de programmation IA de niveau professionnel prête à l'emploi.

Interface oh-my-opencode

Fonctionnalités d'amélioration clés :

  • Sous-agents asynchrones : Capacité de traitement de tâches en parallèle similaire à Claude Code, augmentant considérablement l'efficacité pour les tâches complexes.
  • Configurations d'Agent sélectionnées : Préconfiguré avec plusieurs rôles d'agents professionnels (comme Architecte, Bibliothécaire, Explorateur, etc.).
  • Outils AST avancés : Prend en charge le refactoring intelligent, l'analyse approfondie du code, la recherche de symboles et d'autres fonctionnalités avancées.
  • Mode parallèle ultra-puissant : Il suffit d'ajouter ultrawork dans le prompt pour activer automatiquement le mode parallèle le plus puissant.

Aperçu des rôles d'agents intégrés :

Nom de l'agentModèle recommandéUtilisation principale
👑 SisyphusClaude Opus 4.6Agent d'orchestration principal, responsable de la planification globale et de la délégation des tâches en arrière-plan
🔮 OracleGPT 5.2Conception de l'architecture, revue de code approfondie, analyse de stratégie technique
📚 LibrarianClaude Sonnet 4.6Analyse multi-dépôts, consultation de la documentation officielle, recherche d'exemples d'implémentation open source
🗺️ ExploreGrok Code / HaikuBalayage rapide du code, exploration de la base de code et correspondance de modèles
🎨 FrontendGemini 3 ProSpécialisé dans le développement front-end, excelle dans la création d'UI/UX magnifiques et intuitives

🚀 Installation et Configuration

Étape 1 : Installer le programme principal OpenCode

OpenCode évolue très rapidement, il est recommandé d'utiliser le script d'installation officiel pour obtenir la dernière version (Documentation officielle) :

# Installation rapide avec curl (Recommandée)
curl -fsSL https://opencode.ai/install | bash

# Ou utiliser un gestionnaire de paquets Node.js
npm install -g opencode  # bun / pnpm / yarn fonctionnent également

# Les utilisateurs de macOS peuvent aussi utiliser Homebrew
brew install opencode

Étape 2 : Installer oh-my-opencode (Fortement recommandé)

oh-my-opencode fournit des modèles de configuration professionnels prêts à l'emploi, vous évitant les ajustements manuels fastidieux :

bunx oh-my-opencode install

> 💡 Astuce : Pendant l'installation, un assistant interactif vous demandera quels abonnements IA vous possédez (comme Claude, ChatGPT, etc.), veuillez cocher les cases en fonction de votre situation réelle.

Étape 3 : Configurer le nœud API et les modèles CodingPlanX

C'est l'étape la plus cruciale ! Veuillez utiliser un éditeur de texte pour créer ou modifier le fichier de configuration : ~/.config/opencode/opencode.json.

> 🎯 À propos du choix des modèles : > Le modèle de configuration ci-dessous utilise la combinaison des modèles de la Série Claude et de la Série GPT Codex fournis par CodingPlanX. Ils obtiennent les meilleurs résultats dans diverses évaluations de programmation faisant autorité et constituent le partenaire idéal des développeurs.

Copiez et remplacez intégralement le contenu JSON suivant dans votre fichier opencode.json :

<details open=""> <summary><b>Cliquez pour développer et voir le code de configuration opencode.json complet</b></summary> 
{
  "$schema": "https://opencode.ai/config.json",

  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.codingplanx.ai/v1"
      }
    },
    "openai": {
      "options": {
        "baseURL": "https://api.codingplanx.ai"
      }
    }
  },

  "model": "anthropic/claude-opus-4-5-20251101",
  "small_model": "anthropic/claude-haiku-4-5-20251001",
  "default_agent": "build",

  "permission": {
    "read": "allow", "list": "allow", "glob": "allow", "grep": "allow",
    "codesearch": "allow", "lsp": "allow",
    "edit": "ask", "bash": "ask", "webfetch": "ask", "websearch": "ask",
    "external_directory": "deny", "doom_loop": "ask"
  },

  "agent": {
    "plan": {
      "mode": "primary",
      "description": "Planification/Décomposition/Solution technique (Lecture seule, évite les modifications accidentelles du code)",
      "model": "anthropic/claude-opus-4-5-20251101",
      "temperature": 0.1,
      "prompt": "Tu es un responsable technique principal. Objectif : décomposer les exigences en étapes exécutables (y compris les critères d'acceptation/risques/rollback). Par défaut en lecture seule, ne modifie pas les fichiers et n'exécute pas de commandes ; si l'exécution est vraiment nécessaire, explique d'abord pourquoi et suggère de passer à build/codex.",
      "permission": { "edit": "deny", "bash": "deny", "webfetch": "deny", "websearch": "deny", "doom_loop": "deny" }
    },

    "build": {
      "mode": "primary",
      "description": "Développement principal (Implémentation de bout en bout/Débogage/Correction de tests) - Claude Opus 4.6",
      "model": "anthropic/claude-opus-4-5-20251101",
      "temperature": 0.2,
      "prompt": "Tu es l'agent d'ingénierie logicielle principal. Priorité : changements minimum viables, lisibilité, testabilité. Avant d'apporter des modifications, explique rapidement ton plan ; après modification, tu dois fournir : les points clés du diff, comment vérifier localement (commandes), et les conditions limites potentielles.",
      "permission": { "edit": "allow", "bash": "allow", "webfetch": "ask", "websearch": "ask", "doom_loop": "ask" }
    },

    "codex": {
      "mode": "primary",
      "description": "Refactoring/Migration/Changements majeurs (Codex) - GPT-5.2",
      "model": "openai/gpt-5.2-2025-12-11",
      "temperature": 0.2,
      "prompt": "Tu es un agent d'ingénierie de style Codex, expert en refactoring à grande échelle, migration, revue de code et collaboration avec des chaînes d'outils complexes. Priorité : maintenir le projet exécutable : commits par étapes, chaque étape vérifiable ; en cas d'incertitude, ajoute d'abord des protections et des tests.",
      "permission": { "edit": "allow", "bash": "allow", "webfetch": "ask", "websearch": "ask", "doom_loop": "ask" }
    },

    "review": {
      "mode": "subagent",
      "description": "Revue de code/Deuxième cerveau (Lecture seule) - GPT-5.1-Codex-Max",
      "model": "openai/gpt-5.1-codex-max",
      "temperature": 0.1,
      "prompt": "Tu es un code reviewer strict. Sortie : 1) Risques clés (bug/sécurité/concurrence/limites) 2) Suggestions de maintenabilité 3) Suggestions de modification minimales (tu peux utiliser un pseudo-diff) 4) Points de test nécessaires. Par défaut en lecture seule, ne modifie pas les fichiers et n'exécute pas de commandes.",
      "permission": { "edit": "deny", "bash": "deny", "webfetch": "deny", "websearch": "deny", "doom_loop": "deny" }
    },

    "explore": {
      "mode": "subagent",
      "description": "Balayage rapide du code/Localisation de fichiers/Résumé du contexte (Lecture seule) - Claude Haiku 4.5",
      "model": "anthropic/claude-haiku-4-5-20251001",
      "temperature": 0.1,
      "prompt": "Tu es un sous-agent d'exploration rapide : utilise le moins d'étapes possible pour localiser les fichiers/fonctions/chaînes d'appel pertinents, et fournis un chemin clair ainsi qu'un résumé. Par défaut en lecture seule, ne modifie pas les fichiers et n'exécute pas de commandes.",
      "permission": { "edit": "deny", "bash": "deny" }
    },

    "general": {
      "mode": "subagent",
      "description": "Recherche générale/Rédaction d'explications/Comparaison de solutions (Coût moyen) - Claude Sonnet 4.6",
      "model": "anthropic/claude-sonnet-4-5-20250929",
      "temperature": 0.2,
      "prompt": "Tu es un sous-agent d'analyse générale : axé sur l'explication, les compromis, la rédaction de documentation et la comparaison de solutions ; par défaut en lecture seule, essaie de ne pas modifier le code.",
      "permission": { "edit": "deny", "bash": "deny" }
    },

    "think": {
      "mode": "subagent",
      "description": "Assistance à la réflexion/Déduction des conditions limites (Lecture seule) - GPT-5.2",
      "model": "openai/gpt-5.2-2025-12-11",
      "temperature": 0.2,
      "prompt": "Tu es un sous-agent de raisonnement et de déduction des conditions limites : tu fournis des analyses structurées et des suggestions concernant la conception, les chemins d'exception, la concurrence/cohérence, et les goulots d'étranglement des performances. Par défaut en lecture seule.",
      "permission": { "edit": "deny", "bash": "deny" }
    }
  }
}
</details>

Étape 4 : Configurer la Clé API

Étant donné que nous avons configuré deux fournisseurs (Anthropic et OpenAI), vous devez lier votre clé API obtenue sur CodingPlanX à l'intérieur d'OpenCode.

  1. Dans le terminal, tapez opencode pour démarrer le programme.
  2. Dans la boîte de dialogue, tapez la commande /connect.
  3. Configurer Claude :
    • Sélectionnez Anthropic -> Sélectionnez Manually enter API Key.
    • Collez votre clé API CodingPlanX et appuyez sur Entrée pour enregistrer.
  4. Configurer OpenAI :
    • Tapez à nouveau /connect.
    • Sélectionnez OpenAI -> Sélectionnez Manually enter API Key.
    • Collez votre clé API CodingPlanX et appuyez sur Entrée pour enregistrer.
  5. Tapez /exit pour quitter, puis redémarrez opencode pour que la configuration prenne effet.

> 🔐 Note : Votre clé API sera enregistrée en toute sécurité localement dans le fichier ~/.local/share/opencode/auth.json.

💡 Astuces d'utilisation avancées

Une fois la configuration terminée, tapez opencode dans le terminal pour démarrer la conversation :

&gt; Bonjour, lis le fichier package.json dans le répertoire actuel et présente-moi ce projet.

1. ⚡ Mode parallèle ultime Ultrawork

Si vous avez installé oh-my-opencode, il vous suffit d'ajouter ultrawork ou l'abréviation ulw dans votre prompt, et OpenCode invoquera l'agent principal pour décomposer la tâche et la distribuer aux sous-agents en arrière-plan pour un traitement en parallèle :

&gt; ultrawork aide-moi à refactoriser le module d'authentification dans le répertoire src/auth, et ajoute des tests unitaires.

2. 🎯 Invocation ciblée d'agents avec la syntaxe @

Vous pouvez utiliser le symbole @ pour attribuer précisément des tâches spécifiques aux agents professionnels que nous avons configurés dans le JSON :

&gt; @review aide-moi à vérifier si la logique de login.ts que je viens de commiter a des failles de sécurité.
&gt; @explore recherche dans le projet tous les points de terminaison API qui appellent getUserInfo.
&gt; @general aide-moi à comparer s'il vaut mieux utiliser React Context ou Redux pour le projet actuel.

3. 🔄 Changement ultra-rapide de mode de travail avec la touche Tab

Appuyez sur la touche Tab dans la zone de saisie pour basculer rapidement entre les agents principaux :

  • build : Mode principal, dispose des autorisations complètes de lecture/écriture de fichiers et d'exécution de terminal.
  • plan : Mode sécurisé, autorisation de lecture seule, utilisé pour la décomposition initiale des besoins, l'analyse de l'architecture et la planification technique, afin d'empêcher l'IA de modifier accidentellement le code.

🛠️ Résolution des problèmes fréquents (FAQ)

Q1 : Indique que la connexion à l'API a échoué ou a expiré ?

  • Vérifiez si la baseURL dans opencode.json est correcte.
  • Vérifiez si le terminal a des conflits de proxy (généralement, l'utilisation d'une IP directe permet de contourner les problèmes de proxy système).

Q2 : Indique "Model not found" ou modèle indisponible ?

  • Confirmez que l'ID du modèle dans le fichier de configuration (par exemple claude-opus-4-5-20251101) correspond exactement à la liste des modèles officiels fournis par CodingPlanX, ne faites pas de faute de frappe.

Q3 : Erreur avec le plugin oh-my-opencode ?

  • Le plugin est en phase de développement rapide. Si vous rencontrez un bug, essayez de le mettre à jour : bunx oh-my-opencode update.
  • Pour plus de problèmes de configuration, veuillez consulter la documentation officielle de oh-my-opencode.

🔗 Lectures complémentaires et étapes suivantes