Claude Code dans les IDE JetBrains

Utilisez Claude Code dans IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm ou Android Studio avec une seule clé API AI in IDE.

Cette intégration est différente de VS Code et Cursor : JetBrains n'a pas d'extension de chat autonome. Le plugin lance la commande claude dans le terminal intégré de l'IDE et s'y connecte via un socket local. Vous installez donc un CLI, un plugin, et vous configurez l'environnement du CLI. Rien ici n'est une installation en un clic, et tout guide qui le promet se trompe.

En quoi l'intégration JetBrains diffère

Comme c'est le CLI qui parle au réseau, toute la configuration AI in IDE appartient au CLI et non à une interface du plugin. Bonne nouvelle : un seul ~/.claude/settings.json configure le CLI, le plugin et toute session en terminal.

Versions et prérequis

Le plugin est publié sous le nom Claude Code [Beta]. Fonctions et menus de réglages évoluent d'une version à l'autre : consultez la page du plugin pour le build que vous installez au lieu de supposer qu'une option existe.

Installation

1. Le CLI

Copy
1
npm install -g @anthropic-ai/claude-code
2
claude --version

Vérifiez que claude se résout depuis un terminal ordinaire. Sinon, le plugin ne peut pas le lancer et affiche Cannot launch Claude Code. Les gestionnaires de version Node (nvm, fnm, asdf) sont la cause habituelle : le shell résout claude via un script d'initialisation que l'IDE n'exécute jamais. Installez avec un Node système, ou indiquez le chemin absolu à l'étape suivante.

2. Le plugin

Ouvrez Settings → Plugins → Marketplace, cherchez Claude Code, installez, puis redémarrez complètement l'IDE — pas seulement le projet. En Remote Development, installez le plugin sur l'hôte via Settings → Plugin (Host), pas sur votre client local : un plugin installé localement ne se connectera pas à un projet distant.

3. Indiquer le CLI au plugin

Settings → Tools → Claude Code [Beta] → Claude command accepte une chaîne de commande, pas seulement un chemin :

• claude lorsqu'il est dans le PATH
• /usr/local/bin/claude ou un autre chemin absolu
• npx @anthropic-ai/claude-code pour toujours exécuter la dernière version publiée
• wsl -d Ubuntu -- bash -lic "claude" sous Windows avec WSL, en remplaçant Ubuntu par votre distribution

C'est le correctif fiable pour les notifications command not found.

Créer et copier la clé API

1. Choisissez une offre sur la page tarifs. Un même compte peut contenir des clés distinctes pour Claude, GPT et Gemini ; chaque clé reste liée à son canal fournisseur.
2. Ouvrez API Keys et créez une clé.
3. Sélectionnez AWSQ ou CCMAX. Ce sont les canaux Claude Code ; les clés Codex et Gemini passent par d'autres points d'entrée et échouent ici.
4. Vous pouvez ensuite retrouver la clé complète dans la liste API Keys pour l’afficher ou la copier.

Configuration

Le CLI lit ~/.claude/settings.json (macOS/Linux) ou C:/Users/<UserName>/.claude/settings.json (Windows). Créez-le ainsi :

Copy
1
{
2
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
3
  "env": {
4
    "ANTHROPIC_BASE_URL": "https://api.aiinide.com",
5
    "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY",
6
    "API_TIMEOUT_MS": "600000",
7
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
8
  }
9
}

ANTHROPIC_BASE_URL reste l'hôte : le CLI ajoute /v1/messages. Une URL de base contenant /v1 produit /v1/v1/messages et une erreur 404. Si vous avez déjà un settings.json avec des permissions ou des hooks, ajoutez l'objet env au lieu de remplacer le fichier.

Pourquoi un fichier et non un export shell ? Parce qu'un IDE JetBrains lancé depuis le Dock ou le menu Démarrer n'exécute pas votre profil shell, et le plugin hérite de l'environnement de l'IDE. Un fichier est lu par le CLI lui-même et fonctionne quelle que soit la façon dont le terminal a été ouvert. Si vous tenez aux variables d'environnement, placez-les dans le profil et assurez-vous que l'IDE a été lancé depuis un shell, ou passez-les dans la ligne de commande du plugin.

L'écran de connexion au premier lancement du CLI ne vous concerne pas non plus : dès que ANTHROPIC_AUTH_TOKEN existe et qu'aucune session claude.ai n'est active, Claude Code utilise le jeton.

Vérifier

Commencez par lister les modèles pour vérifier la clé et son canal Claude. Cette requête ne consomme pas de quota.

Copy
1
curl --globoff -i 'https://api.aiinide.com/v1/models' \
2
  -H "x-api-key: YOUR_DASHBOARD_API_KEY" \
3
  -H "anthropic-version: 2023-06-01"

Le statut HTTP 200 renvoie la liste des modèles. Un statut 401 indique une clé absente, invalide ou expirée. Un statut 400 indique que la clé appartient à un autre canal. Dans l’exemple Messages ci-dessous, utilisez un identifiant de la liste.

1. Le terminal d'abord. Dans le terminal intégré de l'IDE, à la racine du projet, lancez claude. Vous devez obtenir une invite sans écran de connexion. Si cela échoue, le plugin ne peut pas fonctionner non plus : corrigez le CLI et l'environnement avant de toucher au plugin.
2. Connexion depuis l'IDE. Projet ouvert, lancez claude depuis le terminal de l'IDE ou appuyez sur Cmd+Esc / Ctrl+Esc. Le plugin démarre le CLI et se connecte.
3. Confirmer la connexion. Demandez /status : version, modèle et état du compte. Une session connectée affiche aussi les modifications de fichiers sous forme de diffs dans l'IDE plutôt que dans le terminal.
4. Connecter un terminal externe si vous avez lancé claude hors de l'IDE : tapez /ide dans Claude Code. Le succès affiche Connected to IntelliJ IDEA. (avec le nom de votre IDE). Lancez le CLI depuis la racine du projet, sinon l'ensemble de fichiers ne correspondra pas.
5. Testez un appel au modèle avec la clé vérifiée.

Copy
1
curl --globoff 'https://api.aiinide.com/v1/messages' \
2
  -H "x-api-key: YOUR_DASHBOARD_API_KEY" \
3
  -H "anthropic-version: 2023-06-01" \
4
  -H "Content-Type: application/json" \
5
  -d '{"model":"MODEL_ID_FROM_LIST","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'

1. Consommation. Utilisation affiche les tokens facturés à la clé après le premier message réussi.

Dépannage

Utilisez un identifiant exact renvoyé par GET /v1/models. Une faute dans un nom claude-* peut diriger la requête vers le modèle Claude configuré par défaut, qui sera alors facturé à son propre tarif.

API Error: 404

Réglez ANTHROPIC_BASE_URL sur https://api.aiinide.com. Ajouter /v1 envoie la requête vers /v1/v1/messages, qui renvoie une erreur 404.

API Error: 400

• Mauvais canal. Une clé Codex ou Gemini s'authentifie sur /responses ou /v1beta/models/... ; sur ce point d'entrée elle renvoie 400. Créez une clé AWSQ ou CCMAX.
• settings.json cassé. Le CLI retombe silencieusement sur ses valeurs par défaut quand le JSON ne se parse pas, et la requête part vers le vrai point d'entrée Anthropic avec votre jeton de proxy, donc elle échoue. Validez le fichier — la ligne $schema donne des erreurs directement dans l'IDE.

Vérification de la clé API

Utilisez le statut de GET /v1/models pour vérifier la clé. Si elle est absente ou invalide, le point d’entrée natif POST /v1/messages peut renvoyer HTTP 200 avec un message d’authentification dans content.

• Réglages au mauvais endroit. En Remote Development ou dans un conteneur, ~/.claude/settings.json doit exister sur l'hôte ou dans le conteneur qui exécute le CLI, pas sur votre portable.
• Un ANTHROPIC_API_KEY résiduel. Si votre environnement exporte aussi une clé Anthropic, elle peut primer sur ANTHROPIC_AUTH_TOKEN. Supprimez-la et redémarrez l'IDE.
• Clé expirée. Vérifiez l'expiration dans le tableau de bord ; faites une rotation plutôt que de prolonger.

Échecs d'intégration propres à JetBrains

Délais et proxy

API_TIMEOUT_MS couvre les longs tours d'agent ; un proxy d'entreprise ajoute de la latence à chaque requête. Si les requêtes échouent à intervalle fixe, le délai n'est pas lu — vérifiez qu'il est bien dans env de settings.json et redémarrez l'IDE. Derrière un proxy qui inspecte le TLS, placez NODE_EXTRA_CA_CERTS vers l'autorité racine du proxy dans le même bloc env.

Note sur les modes de permission

Dans JetBrains, le plugin peut modifier des fichiers de configuration que l'IDE peut exécuter. Restez en mode Manual avec acceptEdits désactivé pour les dépôts non fiables, et choisissez sciemment les dossiers de projet ouverts dans une session qui peut écrire.

Modèles et tarifs

Tarifs de base d'Opus 5.5 : 4 $ par million de tokens en entrée, 0,20 $ en lecture de cache, 20 $ en sortie. Consommation de quota : 0,8× sur AWSQ et 2× sur CCMAX. Le mode Fast double les tarifs de base et de cache lorsque l'amont l'utilise.

• Offres : tarifs
• Clés et quota : API Keys
• Détails du protocole : Configuration
• Fiche officielle du plugin : JetBrains Marketplace
• Guide d'intégration officiel : code.claude.com JetBrains

Questions fréquentes

Pourquoi pas d'installation en un clic ? Parce que le plugin n'embarque délibérément pas le CLI : il lance votre claude installé pour que le terminal et l'IDE partagent une seule configuration. D'où l'installation du CLI puis du plugin, dans cet ordre.

Peut-on réutiliser l'extension VS Code ? Non. L'extension VS Code et Cursor est un produit distinct ; ici, l'interface est le CLI dans le terminal de l'IDE. Ce qui se réutilise, c'est ~/.claude/settings.json, lu par les deux.

Le plugin exige-t-il une connexion Anthropic ? Non. Avec ANTHROPIC_AUTH_TOKEN et ANTHROPIC_BASE_URL définis, le CLI saute l'écran de connexion et envoie les requêtes à AI in IDE.

Quels IDE sont pris en charge ? Les IDE documentés sont IntelliJ IDEA, PyCharm, WebStorm, PhpStorm, GoLand et Android Studio. D'autres IDE de la même plateforme fonctionnent souvent ; le plugin est en beta, vérifiez donc les diffs et /ide avant de vous y fier.