Connecter Kimi K2.5 à OpenCode avec Novita AI : un guide de codage agentique

Le codage agentique dépasse désormais l’autocomplétion : les outils modernes peuvent planifier des tâches, modifier plusieurs fichiers, exécuter des commandes et itérer sur les échecs jusqu’à ce que le résultat fonctionne réellement. OpenCode est un agent de codage open source et indépendant des modèles que vous pouvez exécuter dans le terminal (également disponible en application de bureau ou extension d’IDE), ce qui en fait un moyen pratique d’essayer ce workflow dans votre propre environnement.

💡Dans ce guide, vous allez :

• Connecter Kimi K2.5 à OpenCode via l’API de Novita AI
• Installer OpenCode et être prêt à l’utiliser sur l’interface de votre choix (terminal/bureau/IDE)
• Construire un petit projet de démonstration.

Qu’est-ce qu’OpenCode ?

OpenCode est un agent de codage IA open source que vous pouvez exécuter dans plusieurs environnements de développement : le plus souvent sous forme d’interface terminal (CLI + TUI), mais également en application de bureau ou extension d’IDE.

OpenCode vs Claude Code

OpenCode et Claude Code sont tous deux des agents de codage IA basés sur le terminal, mais ils suivent des approches différentes.

• OpenCode est un agent open source et indépendant des fournisseurs : il met en avant la compatibilité avec « plus de 75 fournisseurs de LLM via Models.dev (y compris des modèles locaux) » et se positionne comme un outil flexible que vous pouvez connecter à différents backends de modèles.
• Claude Code, à l’inverse, est le CLI officiel d’Anthropic centré sur Claude : un outil en ligne de commande pour accéder aux modèles Claude dans le terminal, ainsi qu’un écosystème officiel d’extensions (plugins) et de connexions d’outils/données via MCP.

Tableau comparatif rapide

Aspect	OpenCode	Claude Code
Positionnement	Agent de codage terminal open source, multi-modèles	Agent de codage terminal officiel d’Anthropic, centré sur Claude
Choix de modèle/fournisseur	Plus de 75 fournisseurs de LLM via Models.dev, y compris des modèles locaux	Conçu autour de Claude ; extensible via MCP + plugins
Automatisation GitHub	Déclencheurs par commentaires /opencode ou /oc ; s’exécute sur l’exécuteur GitHub Actions	Les extensions se concentrent sur les plugins/MCP (écosystème officiel)
Point d’entrée tarifaire	L’outil est open source ; le coût dépend du backend de modèle que vous choisissez	Forfaits Claude (Pro/Max/Team/Enterprise)

Pourquoi Kimi K2.5 ?

Kimi K2.5 réunit multimodalité native, exécution d’outils réelle et orchestration d’agents à grande échelle dans un seul modèle ouvert. Entraîné sur environ 15 billions de tokens mixtes vision-texte, il couvre la compréhension d’images/vidéos, la génération de code et le débogage visuel.

Essayez Kimi M2.5 dès maintenant !

Source : Kimi

Points clés pratiques

• Meilleurs benchmarks agentiques que GPT-5.2, Claude 4.5 Opus et Gemini 3 Pro : Sur le graphique, Kimi K2.5 arrive en tête des suites d’évaluation agentiques : HLE-Full 50.2, BrowseComp 74.9, DeepSearchQA 77.1. Sur BrowseComp, K2.5 devance GPT-5.2 (65,8), Claude 4.5 Opus (57,8) et Gemini 3 Pro (59,2) — ce qui est utile pour des tâches à long terme nécessitant de la navigation, la collecte de preuves et l’affinement itératif.
• Codage au niveau des dépôts compétitif avec un avantage multilingue : K2.5 atteint 76,8 sur SWE-Bench Verified et 73,0 sur SWE-Bench Multilingual. Si Claude 4.5 Opus est légèrement plus élevé sur Verified (80,0) et que Gemini 3 Pro est également en tête sur ce benchmark (80,9), K2.5 reste très compétitif et se distingue dans les contextes multilingues — devançant GPT-5.2 (72,0) et loin devant Gemini 3 Pro (65,0) — ce qui est important pour les correctifs multi-fichiers dans des dépôts en langages mixtes.
• Meilleure compréhension d’images pour les workflows de développement (docs, schémas, UI) : Sur l’ensemble des benchmarks d’images, K2.5 est constamment au top : MMMU Pro 78,5, MathVision 84,2, OmniDocBench 1.5 88,8 — ce qui prend en charge des tâches pratiques comme la lecture de PDF techniques, l’interprétation de schémas et la transformation d’exigences visuelles en code.
• Raisonnement vidéo utile pour l’itération de produits réels : Pour les tâches vidéo, K2.5 obtient 86,6 sur VideoMMMU et 79,8 sur LongVideoBench, ce qui indique une meilleure compréhension vidéo sur long contexte — pratique pour analyser des démos de produits, déboguer des enregistrements d’UI ou extraire des exigences à partir de présentations.

Comment installer OpenCode

OpenCode propose plusieurs options d’installation. La plus rapide est le script d’installation en une ligne, et la plus portable est l’installation du package npm.

macOS / Linux

Recommandé :

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

Ou (cross-platform) :

npm install -g opencode-ai
# ou
bun add -g opencode-ai

Démarrer :

opencode

Windows

Recommandé :

npm install -g opencode-ai
# ou
bun add -g opencode-ai

curl | bash nécessite un environnement bash (WSL ou Git Bash). Dans PowerShell/CMD, utilisez npm/bun.

Démarrer :

opencode

Comment utiliser MiniMax M2.1 dans OpenCode

Obtenir votre clé API sur Novita AI

• Étape 1 : Créer un compte ou se connecter Rendez-vous sur [https://novita.ai](https://novita.ai) et inscrivez-vous ou connectez-vous.
• Étape 2 : Accéder à la gestion des clés Après connexion, recherchez « Clés API ».
• Étape 3 : Créer une nouvelle clé Cliquez sur le bouton « Ajouter une nouvelle clé ».
• Étape 4 : Enregistrez votre clé immédiatement Copiez et stockez la clé dès qu’elle est générée ; elle n’est généralement affichée qu’une seule fois.

Obtenir une clé API

Ajouter votre clé API Novita à OpenCode

1. Lancez OpenCode :

opencode

2. Dans l’invite OpenCode, exécutez :

/connect

3. Recherchez et sélectionnez Novita AI, puis collez votre clé API Novita.
4. Sélectionnez Kimi K2.5 (identifiant de modèle : moonshotai/kimi-k2.5).

C’est tout : OpenCode acheminera les requêtes agent via l’API de Novita AI en utilisant le modèle que vous avez sélectionné.

Construisez votre premier projet : Woolf Stream

Pour que la démo soit immédiatement visuelle (et facile à partager en captures d’écran), nous allons construire une application web monopage : Woolf Stream. Les utilisateurs téléchargent une image, choisissent quelques contrôles créatifs, et l’application appelle le point de terminaison de chat compatible OpenAI de Novita AI avec Kimi K2.5 (prise en charge de l’image dans le chat) pour générer un texte de prose de flux de conscience, inspiré des techniques modernistes du début du 20e siècle — sans citer ni imiter Virginia Woolf mot pour mot.

Ce que nous allons construire

• Une démo monopage Next.js 14 (App Router) avec TypeScript + TailwindCSS
• Panneau de clé API (champ de mot de passe + afficher/masquer, enregistrer/effacer dans le localStorage ; ne jamais coder en dur)
• Téléchargement d’image par glisser-déposer (png/jpg) avec aperçu et conversion en URL de données base64 côté client
• Contrôles :
  • Préréglages de longueur : 150 / 300 / 600 / 1000 mots
  • Curseur de ton : rêveur ↔ perçant
  • Menu déroulant de focus : sensoriel / mémoire / temps / regard social
• Flux de génération :
  • Bouton « Générer la prose » désactivé tant que la clé API + l’image ne sont pas présents
  • Indicateur de chargement + panneau d’erreur avec statut HTTP + conseils de dépannage
• Sortie :
  • Une carte de lecture avec la prose générée
  • Bouton de copie + Téléchargement .txt
  • Accordéon « Afficher l’invite utilisée » (pour la transparence et la reproductibilité)

Passer en mode Build et exécuter

Dans OpenCode, passez en mode Build, puis collez l’invite ci-dessous.

Invite

Construisez une démo monopage avec Next.js 14 (App Router) + TypeScript + TailwindCSS.

Objectif : L’utilisateur télécharge une image (png/jpg). L’application envoie l’image à un point de terminaison de chat compatible OpenAI (prise en charge de l’image dans le chat) et génère un beau passage de prose de flux de conscience inspiré des techniques modernistes de Virginia Woolf. La sortie est UNIQUEMENT DU TEXTE.

Exigences API (strictes) :

• URL de base personnalisée compatible OpenAI : https://api.novita.ai/openai
• Modèle : moonshotai/kimi-k2.5
• L’utilisateur saisit sa propre clé API (champ de mot de passe + afficher/masquer). Stockée uniquement dans le localStorage. Ne jamais coder en dur.
• Les requêtes incluent Authorization: Bearer {userKey}.

Exigences UI :

• Ambiance UI Monet / Nymphéas : palette pastel douce, texture papier, dégradé de fond subtil en coups de pinceau, ombres lumineuses douces, cartes arrondies, petite animation de ripple au survol. Responsive mobile.
• Composants : enregistrement/effacement de clé API, téléchargement par glisser-déposer + aperçu, contrôles : longueur (150/300/600/1000 mots), curseur de ton (rêveur↔perçant), menu déroulant de focus (sensoriel/mémoire/temps/regard social), bouton Générer (désactivé si clé ou image manquante), indicateur de chargement, panneau d’erreur.
• Sortie : prose rendue dans une carte de lecture + Copier + Télécharger .txt + accordéon « Afficher l’invite utilisée ».

Appel multimodal (obligatoire) :

• Utilisez POST /v1/chat/completions.
• Envoyez des messages où le contenu est un tableau contenant LES DEUX éléments suivants :

{type:“text”, text:“…instructions…”}

{type:“image_url”, image_url:{url:“data:image/png;base64,…”}}

• Affichez la réponse texte du modèle.

Contraintes de rédaction (important) :

• Produisez une prose ORIGINALE inspirée du flux de conscience moderniste du début du 20e siècle (rythme lyrique, intériorité, détails sensoriels, associations, temps fluide).
• Ne citez PAS et ne reproduisez AUCUN texte de Woolf. Ne prétendez pas être Woolf. Pas de lignes de pastiche directes.
• Ancrez-vous à l’image : reflétez la composition, la lumière, les couleurs, l’ambiance, le mouvement implicite ; préservez le placement des sujets.
• Sortie : un passage continu (1 à 3 paragraphes maximum). Pas de puces, pas d’analyse.

Livraison :

• Code entièrement exécutable + arborescence des fichiers.
• Un wrapper API qui injecte base_url et la clé utilisateur.
• Conversion image côté client -> URL de données base64.
• Erreurs claires avec code de statut HTTP et conseils de dépannage.

Exécuter localement

Après qu’OpenCode ait généré le projet :

npm install
npm run dev

Ouvrez l’URL locale affichée par Next.js (généralement http://localhost:3000) et vérifiez :

• La page s’affiche avec l’apparence Monet / Nymphéas
• L’enregistrement/effacement de la clé API fonctionne (stockée uniquement dans le localStorage), et l’affichage/masquage bascule correctement
• Le téléchargement par glisser-déposer fonctionne, l’aperçu affiche l’image sélectionnée
• Le bouton « Générer la prose » est désactivé tant que la clé API + l’image ne sont pas présents
• La prose est uniquement textuelle, 1 à 3 paragraphes, et clairement ancrée à l’image
• Copier + Télécharger .txt fonctionnent
• « Afficher l’invite utilisée » révèle l’invite exacte envoyée
• Les erreurs (clé invalide / réseau) affichent le statut HTTP et des conseils clairs

Démo : Woolf Stream

OpenCode au-delà du terminal : application de bureau et intégrations IDE

OpenCode est souvent utilisé dans le terminal, mais vous pouvez également l’exécuter en tant qu’application de bureau (Beta) ou directement dans votre IDE — et dans les deux cas, vous pouvez continuer à utiliser l’API compatible OpenAI de Novita AI. L’interface change, mais la configuration du modèle/fournisseur reste la même : sélectionnez minimax/minimax-m2.1.

Application de bureau

La version Desktop d’OpenCode est disponible pour macOS, Windows et Linux. Si vous préférez une interface autonome pour des sessions agent plus longues, l’application de bureau est parfaite — et elle peut utiliser la même configuration de fournisseur que vous avez déjà créée pour Novita AI.

Intégrations IDE

OpenCode propose des flux d’intégration officiels pour :

• VS Code
• Cursor
• Zed
• Windsurf
• VSCodium

Conclusion

OpenCode permet d’adopter facilement des workflows agentiques sans être lié à un seul fournisseur. Avec Kimi K2.5 sur Novita AI, vous bénéficiez d’une configuration pratique pour l’itération au niveau des dépôts et les tâches de développement multimodales — utilisable depuis le terminal (ou l’application de bureau/IDE) avec la même configuration API.

Obtenir une clé API

Novita AI est une plateforme cloud IA qui offre aux développeurs un moyen simple de déployer des modèles IA via notre API intuitive, tout en fournissant un cloud GPU abordable et fiable pour construire et mettre à l’échelle vos projets.

Questions fréquemment posées

Qu’est-ce qu’OpenCode ?

OpenCode est un framework d’agent de codage IA open source qui permet aux LLM d’écrire, d’exécuter et de déboguer du code dans un environnement de développement réel, accélérant les constructions de bout en bout.

Qui est le propriétaire d’OpenCode ?

OpenCode n’appartient pas à un grand laboratoire IA comme Claude ou Gemini. C’est un projet open source maintenu par l’équipe/la communauté OpenCode, dont le développement est piloté par les créateurs d’opencode.ai. Il n’y a pas de « propriétaire de modèle » propriétaire — le projet est conçu pour être indépendant des fournisseurs et autonome vis-à-vis de tout fournisseur de LLM unique.

OpenCode est-il meilleur que Claude ?

OpenCode n’est pas strictement « meilleur » que Claude Code — il est différent. OpenCode est open source et indépendant des modèles, ce qui en fait un meilleur choix si vous voulez de la flexibilité et la liberté d’exécuter plusieurs modèles (comme Kimi K2.5 via Novita AI) dans un seul workflow agent, tandis que Claude Code est le CLI officiel d’Anthropic centré sur Claude, qui offre l’expérience la plus fluide si vous êtes pleinement engagé dans l’écosystème Claude.

OpenCode est-il sûr ?

Oui, OpenCode ne stocke aucun de votre code ni de vos données de contexte, ce qui lui permet de fonctionner dans des environnements sensibles en matière de confidentialité.

OpenCode est-il gratuit ?

OpenCode est l’un de ces rares outils open source qui fait réfléchir. Il est actuellement en tête de GitHub avec plus de 80 000 étoiles — et après l’avoir essayé, cet élan prend tout son sens. Considérez-le comme un agent de codage IA du même type que Claude Code, mais entièrement gratuit et open source.