Migrer de OpenCode vers Claude Code sans rien perdre
Vous voulez passer de OpenCode à Claude Code, mais votre installation actuelle fonctionne : vos extensions MCP tournent, votre vault est branché, votre fichier de contexte est lu à chaque session. Et c'est exactement ce qui vous retient : la peur de tout casser, d'oublier une extension en route, ou de passer des heures à reconfigurer à l'aveugle.
Cette masterclass vous donne une méthode de migration en 7 étapes, chacune pensée pour neutraliser une peur précise : inventaire, sauvegarde, vérification du terrain, rebranchement, transfert du contexte, validation, nettoyage. À la fin, rien n'a cassé et rien n'a été oublié.
Ce que cet exercice ne peut pas casser
La méthode est construite pour qu'il n'y ait rien à perdre : la sauvegarde vient avant tout le reste, rien ne se supprime avant au moins une semaine, et votre installation OpenCode reste intacte pendant toute la migration. Au pire, vous revenez à votre point de départ avec votre dossier de secours.
Ce que vous saurez faire à la fin
- Dresser l'inventaire complet de vos extensions MCP : nom, commande de lancement, rôle.
- Migrer de OpenCode vers Claude Code sans rien casser : sauvegarde d'abord, nettoyage en dernier.
- Prouver qu'une extension rebranchée répond vraiment, au lieu de la croire migrée parce qu'elle est déclarée.
- Niveau membre· le prompt prêt à coller qui dresse votre inventaire MCP et bâtit votre plan de migration, commande par commande, chacune commentée.
Chaque étape neutralise une peur. L'ordre n'est pas négociable : on sauvegarde avant de brancher, on valide avant de nettoyer.
Pourquoi 7 étapes, et dans cet ordre
Une migration ratée n'échoue presque jamais sur la technique. Elle échoue sur un oubli (une extension qu'on redécouvre trois semaines plus tard, au moment où on en a besoin) ou sur une précipitation (l'ancienne installation supprimée avant d'avoir prouvé que la nouvelle tient). La méthode déroule 7 étapes, et chacune existe pour neutraliser une peur précise. On inventorie avant de toucher, on sauvegarde avant de brancher, on valide avant de nettoyer.
1Inventaire : votre carte avant le voyagedoute : « et si j'oublie une extension ? »
Listez chaque extension MCP de votre installation OpenCode : son nom, sa commande de lancement, ce qu'elle vous sert à faire. Ce qui n'est pas sur la carte n'arrive pas de l'autre côté. Si une commande est ambiguë ou incomplète, notez-le : mieux vaut un trou identifié qu'une certitude inventée.
2Sauvegarde : le point de retourdoute : « et si je casse tout ? »
Copiez l'intégralité de votre configuration OpenCode dans un dossier de secours, puis vérifiez que la copie est complète. Tant que ce dossier existe, rien n'est irréversible : vous pouvez vous tromper à n'importe quelle étape et revenir à votre point de départ.
3Vérification du terrain : le sol porte-t-il ?doute : « est-ce qu'il lit vraiment mes fichiers ? »
Lancez Claude Code dans votre projet et faites-lui une première demande simple, juste pour confirmer qu'il lit bien vos fichiers. Avant de brancher la moindre extension, on vérifie que la base fonctionne. Sinon, on déboguera deux problèmes à la fois sans savoir lequel est en cause.
4Rebranchement : une extension à la foisdoute : « vais-je devoir tout reconfigurer ? »
Pour chaque extension de votre inventaire, déclarez-la dans Claude Code en gardant son nom et sa commande d'origine. Rien ne se réinvente : on rebranche, on ne reconfigure pas. Et on les traite une par une, jamais en bloc : si l'une coince, vous savez exactement laquelle.
5Transfert du contexte : vos instructions suiventdoute : « et mes instructions, je les perds ? »
Recopiez votre fichier d'instructions là où Claude Code le lit. C'est lui qui fait que votre assistant vous connaît dès la première phrase. Vous n'en avez pas ? Ce n'est pas bloquant : une trame minimale suffit pour démarrer, vous l'enrichirez ensuite.
6Validation : déclarée n'est pas migréedoute : « elle apparaît dans la liste, mais répond-elle ? »
Pour chaque extension rebranchée, faites une demande concrète qui prouve qu'elle répond vraiment. Une extension déclarée mais jamais testée est une panne qui attend son moment. La preuve, c'est la réponse, pas la présence dans une liste.
7Nettoyage : en dernier, jamais avantdoute : « quand puis-je supprimer l'ancien ? »
Rien ne se supprime avant au moins une semaine de travail réel sur la nouvelle installation. C'est le temps qu'il faut pour croiser tous vos usages, y compris ceux du vendredi. Une fois la migration confirmée, et seulement là, vous nettoyez l'ancienne configuration.
À vous de jouer : votre carte de migration
Avant de lancer le prompt, construisez votre carte à la main. C'est elle qui décide de la qualité du plan : plus votre matière est précise, plus le plan colle à votre cas.
Le résultat, en 30 secondes
À partir de votre carte, le prompt produit quatre blocs : votre inventaire MCP en tableau (nom, commande, rôle), votre plan de migration en 7 étapes avec chaque commande commentée et son résultat attendu, votre checklist de validation, et la liste de ce qui reste en suspens si une information manquait.
Étape 2, Sauvegarde. La commande de copie, suivie de vos chemins, commentée en une ligne : copie l'intégralité de votre configuration OpenCode dans un dossier de secours. Résultat attendu : « vous devriez voir les mêmes fichiers des deux côtés ». Plus bas : votre checklist, une ligne de test par extension, et les questions en suspens.
Le prompt prêt à coller
# RÔLE Tu es un ingénieur en environnements de développement, spécialiste des assistants IA en ligne de commande (OpenCode, Claude Code) et du protocole MCP. Ton exigence : une migration où rien ne casse et rien n'est oublié. Tu ne t'appuies QUE sur ce que je te donne. Ce qui manque, tu me le demandes, tu ne l'inventes jamais. Si tu n'es pas sûr d'un chemin de fichier ou d'une commande, tu le signales au lieu de deviner. # CONTEXTE Je migre mon installation de OpenCode vers Claude Code. Je veux garder mes extensions (MCP), mon vault et mon fichier de contexte, sans rien casser ni reconfigurer à l'aveugle. Ma matière (si j'en ai) : [collez ici le contenu de votre config OpenCode, ou votre liste d'extensions avec leur commande de lancement. Sinon, laissez vide et lisez le MODE DE TRAVAIL.]
Le prompt déroule les 7 étapes à partir de votre matière : votre inventaire MCP en tableau, votre plan de migration avec chaque commande commentée, votre checklist de validation par extension. Et si vous partez de zéro, il passe en mode interview et vous interroge étape par étape. Laissez votre email, je vous l'envoie.
Vérifiez que c'est à vous
Vous avez déclaré vos six extensions dans Claude Code et elles apparaissent toutes dans la liste. Votre installation OpenCode ne sert plus. Votre migration est-elle terminée ?
D'abord avec vos mots, sans regarder les options :
Expliquez-le pour l'ancrer
En une phrase, à un confrère qui hésite à changer d'assistant : pourquoi la sauvegarde vient-elle avant le premier branchement, et le nettoyage une semaine après le dernier test ? Si vous savez le dire simplement, la méthode est à vous.
Ce que vous savez faire maintenant
- Une migration se joue sur l'inventaire : ce qui n'est pas sur la carte n'arrive pas de l'autre côté.
- Déclarée n'est pas migrée : seule une demande concrète qui répond prouve qu'une extension fonctionne.
- Rien ne se supprime avant une semaine : le dossier de secours reste votre point de retour jusqu'à la migration confirmée.
Une migration où rien ne casse et rien n'est oublié.