Intégrer Claude Code dans Zed (ACP) : le guide complet 2026

Intégrer Claude Code dans Zed : ce qui change en 2026

Pendant longtemps, utiliser Claude Code signifiait vivre dans le terminal ou dans l'extension VS Code. En 2026, un troisième chemin s'est imposé pour les développeurs qui privilégient la vitesse : Zed. Grâce au protocole ACP (Agent Client Protocol), l'agent d'Anthropic tourne désormais nativement dans cet éditeur écrit en Rust, réputé pour sa fluidité. Vous conservez toute la puissance agentique de Claude Code — édition de fichiers, exécution de commandes, planification — mais dans une interface graphique ultra-réactive plutôt que dans une fenêtre de terminal.

Ce guide explique comment intégrer Claude Code dans Zed de bout en bout : ce qu'est le protocole ACP, les prérequis, l'installation via le panneau Agent, la configuration manuelle dans settings.json, l'authentification par abonnement ou clé API, l'usage au quotidien, et les limites actuelles de la bêta avec leurs solutions. Si vous débutez avec l'agent, gardez à portée notre guide complet de Claude Code, qui pose les bases du travail en mode agentique.

Sommaire

Qu'est-ce que Zed et pourquoi l'associer à Claude Code<a id="zed"></a>

Zed est un éditeur de code moderne, open-source et écrit en Rust, conçu dès le départ pour la performance : ouverture instantanée, latence de frappe quasi nulle, édition collaborative en temps réel. Là où d'autres éditeurs peinent sur de gros dépôts, Zed reste réactif. C'est précisément ce profil qui en fait un compagnon idéal pour un agent : quand Claude Code modifie une dizaine de fichiers en quelques secondes, vous voulez un éditeur qui suit le rythme sans broncher.

L'intérêt d'associer les deux est simple. Claude Code apporte le cerveau agentique — il lit votre code, planifie, écrit, teste, corrige. Zed apporte l'interface — une revue visuelle des changements, la coloration syntaxique, la navigation dans le projet. Vous cessez de faire des allers-retours entre un terminal et un éditeur : tout se passe au même endroit. Pour ceux qui découvrent Claude Code, l'installation sur Mac, Windows ou Linux reste le point de départ, mais l'intégration Zed change ensuite radicalement le confort d'usage.

ACP : le protocole qui connecte Claude Code à Zed<a id="acp"></a>

Le cœur de cette intégration porte un nom : ACP, pour *Agent Client Protocol*. C'est un standard ouvert, introduit par Zed Industries, qui permet à n'importe quel éditeur de dialoguer avec n'importe quel agent d'IA, sans intégration sur mesure pour chacun. Techniquement, ACP repose sur du JSON-RPC : l'éditeur (le « client ») et l'agent échangent des messages structurés — « voici le fichier ouvert », « propose une modification », « exécute cette commande », « voici le résultat ».

Pour Claude Code, un adaptateur officiel fait le pont : le paquet npm @zed-industries/claude-code-acp enveloppe le SDK de Claude Code et traduit ses interactions au format ACP. Zed n'a donc pas besoin de connaître les détails internes de Claude Code ; il parle ACP, et l'adaptateur se charge du reste.

Cette approche par protocole ouvert est une petite révolution. En janvier 2026, Zed et JetBrains ont co-lancé un registre d'agents ACP, permettant de découvrir et connecter des agents comme Claude Code, Gemini CLI, Codex, OpenCode, Goose ou Cline directement depuis l'éditeur. On retrouve là la même philosophie d'interopérabilité que celle du protocole MCP (Model Context Protocol), qui standardise cette fois la connexion des agents à des outils et des données. La montée en puissance de ces standards ouverts pour agents autonomes est bien décrite sur des ressources spécialisées comme formation-openclaw.com, qui traite des agents IA open-source et de leur auto-hébergement en entreprise.

Prérequis avant de commencer<a id="prerequis"></a>

Avant d'intégrer Claude Code dans Zed, réunissez trois éléments :

Vérifiez rapidement votre version de Node dans le terminal intégré de Zed :

node --version

Si la commande échoue ou renvoie une version ancienne, installez Node avant d'aller plus loin. C'est la cause numéro un des messages « failed to launch » côté agent.

Installer Claude Code dans Zed, étape par étape<a id="installation"></a>

La méthode recommandée passe par le panneau Agent de Zed, sans toucher au moindre fichier de configuration.

C'est tout : en moins de deux minutes, Claude Code est opérationnel dans Zed. Le principe rappelle celui de l'extension Claude Code pour VS Code, à la différence près que Zed passe par un protocole ouvert plutôt que par un plugin dédié.

Configurer un agent personnalisé dans settings.json<a id="settings"></a>

Si vous voulez un contrôle plus fin — par exemple pointer vers une version spécifique de l'adaptateur, ou passer des variables d'environnement — Zed permet d'ajouter un agent personnalisé directement dans son fichier de réglages. Depuis Agent Settings → External Agents → Add Custom Agent, Zed ouvre settings.json avec une structure agent_servers à compléter :

{
  "agent_servers": {
    "Claude Code": {
      "command": "npx",
      "args": ["@zed-industries/claude-code-acp"],
      "env": {
        "ANTHROPIC_API_KEY": "votre_cle_api"
      }
    }
  }
}

Ici, Zed lance l'adaptateur via npx, lui passe les arguments nécessaires et injecte votre clé API par variable d'environnement. Vous pouvez omettre la clé du bloc env si vous préférez vous authentifier avec /login à l'exécution. Cette configuration manuelle est utile en environnement d'entreprise, où l'on veut verrouiller la version de l'adaptateur ou router les appels via un proxy interne.

Utiliser Claude Code dans Zed au quotidien<a id="usage"></a>

Une fois l'agent connecté, l'expérience se rapproche de Claude Code en terminal, mais avec le confort visuel de Zed. Trois fonctions ressortent.

La revue des changements en multibuffer. Quand l'agent propose des modifications, Zed les affiche dans un tampon multiple où vous pouvez accepter ou rejeter chaque bloc (hunk) individuellement. Fini le « tout ou rien » : vous validez ligne à ligne ce qui vous convient. C'est l'un des vrais atouts de l'intégration graphique par rapport au terminal.

Le mode plan. Arrivé peu après le lancement de la bêta, il fait d'abord réfléchir l'agent — qui expose son plan d'action — avant toute modification du code. Vous validez la stratégie, puis l'agent exécute. C'est le même principe que celui détaillé dans notre guide du mode plan de Claude Code, transposé dans l'interface de Zed.

Les slash commands personnalisées. Elles passent par le SDK de Claude Code et restent disponibles dans Zed, ce qui vous permet de rejouer vos workflows habituels.

Pour visualiser concrètement la logique agentique de Claude Code — la boucle « décrire, planifier, coder, vérifier » que vous retrouverez à l'identique dans Zed — cette formation vidéo en français constitue un excellent complément :

Zed vs VS Code, JetBrains et Cursor<a id="comparatif"></a>

Quel éditeur choisir pour piloter Claude Code ? Chacun a son profil.

En pratique, l'énorme avantage d'ACP est que vous n'êtes plus enfermé : le même agent Claude Code se branche indifféremment sur Zed ou JetBrains, et vous pouvez même connecter vos propres services et API à l'agent — un sujet abordé côté données et intégrations sur immoapi.app. Vous choisissez l'éditeur pour ses qualités d'éditeur, pas pour son support d'un agent particulier.

Limites de la bêta et dépannage<a id="limites"></a>

L'intégration étant récente, quelques limites subsistent — toutes en voie de résolution.

Ces frictions restent mineures au regard du gain de confort. Et comme l'agent sous-jacent est identique à celui du terminal, tout ce que vous savez déjà sur Claude Code — sa mémoire de projet, ses hooks, ses sous-agents — reste valable dans Zed.

Bonnes pratiques<a id="bonnes-pratiques"></a>

Quelques réflexes tirent le meilleur de Claude Code dans Zed :

Passez à la vitesse supérieure

Vous savez désormais intégrer Claude Code dans Zed via ACP, de l'installation en deux minutes à la configuration avancée dans settings.json, en passant par l'usage quotidien et le dépannage. Reste l'étape suivante : faire de cette productivité un levier pour déléguer à l'IA une part croissante de votre travail de développeur.

👉 Découvrez comment déléguer une grande partie de votre travail à l'IA et vous concentrer sur l'essentiel : se faire remplacer par l'IA.

---

*Cet article fait partie de notre série de guides pratiques sur Claude Code. Pour aller plus loin, explorez le guide complet de Claude Code et notre comparatif Claude Code vs Cursor.*