Claude Octopus installation : guide complet pas à pas (Mac, Linux, Windows)

Yoda

il y a 3 heures

Ce qu'il faut retenir

L'installation de Claude Octopus se fait en deux commandes terminal sans modifier la configuration Claude Code existante.
Un abonnement Claude Pro, Teams ou Enterprise est requis - le plugin lui-même est gratuit et open source.
Sur Windows, les commandes d'installation doivent être exécutées séparément et non chaînées avec des opérateurs &&.

Résumé généré par IA

Claude Octopus est un plugin pour Claude Code, il s’installe en 2 commandes et ne touche pas à votre configuration Claude Code existante. Ce guide couvre l’installation complète, la configuration des providers optionnels et les premières commandes pour tirer immédiatement de la valeur de l’outil.

Sommaire

Toggle

Si vous découvrez d’abord le projet, lisez notre présentation complète de Claude Octopus avant de suivre ce guide.

Pré-requis avant d’installer Claude Octopus

Ce qui est obligatoire

Claude Code est le seul pré-requis non négociable. Claude Octopus est un plugin pour cet environnement, sans Claude Code, il ne peut pas fonctionner.

Vous avez besoin :

d’un abonnement Claude actif (Pro, Teams ou Enterprise)
de Claude Code installé et fonctionnel dans votre terminal
de Node.js (détecté automatiquement par Claude Code si déjà présent)

Vérifiez que Claude Code fonctionne avant de continuer :

claude --version

Ce qui est optionnel mais recommandé

Les providers externes sont tous optionnels. Claude seul donne accès aux 32 personas, aux 47 commandes et à la totalité des workflows. Les fonctionnalités multi-IA (orchestration parallèle, review adversariale à 4 agents, consensus à 75%) s’activent quand vous ajoutez des providers externes.

Providers disponibles et leur utilité principale :

Provider	Utilité dans Claude Octopus	Gratuit ?
Codex CLI (OpenAI)	Implémentation, logique, cas limites	Via abonnement OpenAI
Gemini CLI (Google)	Recherche, contexte, sécurité	Oui (quota gratuit généreux)
Perplexity	Veille CVE, données temps réel	Via API payante
OpenRouter	Passerelle vers d’autres modèles	Via crédits OpenRouter
Ollama	Modèles locaux (confidentialité maximale)	Oui, 100% local
GitHub Copilot	Si déjà abonné	Via abonnement GitHub

Recommandation pour commencer : installez d’abord Claude Octopus sans aucun provider externe. Ajoutez Gemini CLI en second, il a un quota gratuit généreux et apporte immédiatement de la valeur sur les tâches de recherche.

Méthode 1 : via le terminal (recommandée)

Ouvrez votre terminal (en dehors d’une session Claude Code active) et lancez :

bash

claude plugin marketplace add https://github.com/nyldn/claude-octopus

Cette méthode fonctionne sur Mac, Linux et Windows (PowerShell ou Terminal Windows). Sur Windows, lancez les deux commandes séparément – ne les chainez pas avec &&.

Méthode 2 : via l’interface Claude Code

Ouvrez une session Claude Code dans votre terminal :

bash

claude

Puis tapez dans la session :

/plugin

Naviguez vers l’onglet Marketplace, cherchez “octo” et installez depuis l’interface graphique. /plugin ouvre un menu interactif — vous ne pouvez pas lui passer de sous-commandes directement dans la session. Pour les installations scriptées ou automatisées, utilisez toujours la méthode terminal (Méthode 1).

Vérifier l’installation

Après installation, ouvrez une nouvelle session Claude Code et tapez :

/octo:setup

Claude Octopus détecte automatiquement les providers installés sur votre machine et vous montre ce qui est disponible, ce qui manque, et comment configurer chaque provider. Les indicateurs visuels (points colorés) vous montrent en temps réel quels providers sont actifs.

Configuration des providers externes

Codex CLI (OpenAI)

npm install -g @openai/codex
codex auth

Suivez l’authentification OAuth ou renseignez votre clé API OpenAI. Une fois installé, /octo:setup détecte Codex automatiquement.

Gemini CLI (Google)

npm install -g @google/gemini-cli
gemini auth

Gemini CLI offre un quota gratuit généreux pour commencer. Pour une présentation complète de Gemini CLI indépendamment de Claude Octopus, consultez notre fiche Gemini CLI.

Perplexity

Perplexity s’intègre via sa clé API. Dans votre terminal :

export PERPLEXITY_API_KEY=votre_cle_ici

Pour une persistance, ajoutez cette variable à votre .bashrc, .zshrc ou profil PowerShell. Claude Octopus détecte automatiquement la variable d’environnement au démarrage.

Ollama (option 100% locale)

# Installation Ollama
curl -fsSL https://ollama.com/install.sh | sh

# Télécharger un modèle
ollama pull llama3.2

# Vérifier qu'Ollama tourne
ollama serve

Ollama est la seule option si vous travaillez sur du code strictement confidentiel qui ne peut pas quitter votre machine. Les résultats sont moins bons qu’avec Claude ou Gemini, mais la confidentialité est totale.

Sécurité des credentials

Claude Octopus stocke vos credentials dans ~/.claude/.credentials.json avec des droits restreints (mode 0o600). Les écritures sont atomiques, pas de risque de fichier corrompu si deux sessions tournent en parallèle. Ne commitez jamais ce fichier dans votre dépôt git.

Votre premier /octo:review sur une PR existante

Le cas d’usage le plus direct pour commencer. Ouvrez une session Claude Code à la racine de votre projet git.

Étape 1 : positionner votre branche

git checkout votre-branche-pr
cd votre-projet
claude

Étape 2 : lancer la review

Dans la session Claude Code :

/octo:review

Claude Octopus vous propose 5 options de focus :

Security (vulnérabilités, OWASP)
Performance (goulots, optimisations)
Logic (cas limites, comportements inattendus)
Architecture (cohérence, dette technique)
All areas (Recommended) – les 4 angles simultanément

Sélectionnez “All areas” pour un premier test.

Étape 3 : interpréter les résultats

Chaque finding est taggé par severity et par agent source. Le gate à 75% a déjà filtré les résultats, ce que vous lisez a été confirmé par plusieurs agents ou jugé suffisamment critique pour être remonté même sans consensus total.

Les findings sont organisés par fichier et par ligne, comme des commentaires de PR standard. Si vous avez configuré l’intégration GitHub (voir ci-dessous), ils apparaissent directement comme commentaires inline sur votre PR.

Étape 4 : intégration GitHub (optionnelle)

Pour que les commentaires s’affichent directement sur vos PR GitHub, ajoutez un fichier REVIEW.md à la racine de votre repo :

# Claude Octopus Review Config
focus: security, logic, architecture
threshold: 75
auto_reply_ci: true

Le champ auto_reply_ci active le “reaction engine” qui répond automatiquement aux échecs CI et aux review comments.

Configurer le niveau d’autonomie

Claude Octopus propose 3 niveaux pour les workflows complets (pas uniquement la review) :

Supervisé : vous validez avant chaque phase (Discover, Define, Develop, Deliver). Recommandé pour vos premiers projets avec l’outil.

/octo:embrace --mode supervised

Semi-autonome : le pipeline tourne seul, mais s’arrête et vous notifie en cas d’échec d’une phase.

/octo:embrace --mode semi-autonomous

Autonome : pipeline complet sans interruption. À utiliser quand vous faites confiance au setup et que la spec est bien définie.

/octo:embrace --mode autonomous

Troubleshooting fréquent

“Provider not detected”

Claude Octopus détecte les providers au démarrage d’une session. Si vous venez d’installer Codex CLI ou Gemini CLI, fermez la session Claude Code en cours et ouvrez-en une nouvelle.

# Vérifier que Codex est accessible
codex --version

# Vérifier Gemini
gemini --version

“Plugin not found” lors de l’installation

Utilisez le nom de plugin correct : octo@nyldn-plugins (pas claude-octopus). Le nom a changé dans les versions récentes.

Erreur sur Windows avec PowerShell

Sur Windows, ne chainez pas les commandes avec &&. Exécutez claude plugin marketplace add ... puis, dans une nouvelle ligne, claude plugin install octo@nyldn-plugins.

Mise à jour de Claude Octopus

claude plugin uninstall claude-octopus 2>/dev/null
claude plugin uninstall octo 2>/dev/null
rm -rf ~/.claude/plugins/cache/nyldn-plugins/claude-octopus
claude plugin marketplace add https://github.com/nyldn/claude-octopus

Exécutez ces commandes dans votre terminal, pas à l’intérieur d’une session Claude Code active.

Les résultats de review semblent incomplets

Vérifiez que votre CLAUDE.md ou REVIEW.md est présent à la racine du projet. Claude Octopus l’utilise pour ajuster le comportement de review selon le contexte de votre codebase (stack, conventions, règles custom).

Aller plus loin après l’installation

Une fois la review de base fonctionnelle, les prochaines étapes naturelles sont :

Tester le Dark Factory Mode sur une feature bien délimitée – voir notre guide du Dark Factory Mode
Comprendre quel persona s’active sur vos requêtes habituelles – voir notre guide des 32 personas
Si vous êtes sur un compte Teams ou Enterprise, comparer avec le Claude Code Review officiel d’Anthropic pour décider quelle solution convient à votre équipe

Ce que vous avez maintenant

Après ce guide, vous avez :

Claude Octopus installé et fonctionnel
Au moins Claude comme provider (et potentiellement Gemini)
Un premier /octo:review lancé sur une PR

La valeur de l’outil se révèle surtout sur la durée – notamment avec la mémoire persistante cross-session qui enrichit progressivement le contexte de vos projets. Donnez-lui quelques sessions avant de juger.

FAQ Claude Octopus installation

Faut-il payer pour utiliser Claude Octopus ?

Le plugin est gratuit et open source. Vous payez uniquement les tokens consommés chez chaque provider via vos abonnements existants. Claude seul suffit pour commencer, les providers externes (Codex, Gemini, Perplexity) sont optionnels.

Claude Octopus fonctionne-t-il sans abonnement Claude Pro ?

Non. Claude Octopus est un plugin pour Claude Code, qui nécessite un abonnement Claude actif (Pro, Teams ou Enterprise). Un compte gratuit ne donne pas accès à Claude Code.

Peut-on installer Claude Octopus sur Windows ?

Oui. L’installation fonctionne via PowerShell ou le Terminal Windows. Point important : n’enchainez pas les deux commandes d’installation avec && exécutez-les séparément, l’une après l’autre.

Quelle est la différence entre /plugin dans Claude Code et claude plugin dans le terminal ?

Ce sont deux méthodes d’installation différentes. /plugin dans une session Claude Code ouvre une interface interactive pour naviguer dans le marketplace, il n’accepte pas de sous-commandes directes. claude plugin ... dans votre terminal est la méthode scriptable, recommandée pour l’installation initiale.

Pourquoi Claude Octopus ne détecte-t-il pas Codex CLI ou Gemini CLI après installation ?

La détection se fait au démarrage d’une session. Si vous venez d’installer un provider, fermez la session Claude Code en cours et ouvrez-en une nouvelle. Vérifiez aussi que le CLI est bien accessible dans votre PATH en lançant codex --version ou gemini --version dans votre terminal.