Guides

Par Matt Connor 2026-08-07

Claude sous Linux : application de bureau ou CLI ?

Q: Ai-je besoin de Node.js pour exécuter Claude Code sous Linux ?

Pas avec l’installation recommandée. curl -fsSL https://claude.ai/install.sh | bash télécharge un binaire compilé qui n’utilise pas Node.js à l’exécution. Node.js est nécessaire uniquement si vous installez le package npm, qui demande Node.js 22 ou version ultérieure depuis la version 2.1.198. Avec une ancienne version de Node.js, npm affiche un avertissement EBADENGINE, mais l’installation se termine quand même, car le même binaire natif est installé comme dépendance propre à la plateforme. Ne l’installez jamais avec sudo npm install -g, car cette commande crée des fichiers appartenant à root dans votre préfixe npm et empêche les mises à jour ultérieures.

Q: Comment me connecter à Claude Code via SSH ?

Exécutez claude. La commande affiche une URL d’autorisation. Ouvrez cette URL dans le navigateur de votre propre ordinateur, pas sur le serveur. Après votre authentification, le navigateur affiche un code de connexion au lieu d’effectuer une redirection, car il ne peut pas atteindre le listener de callback démarré par Claude Code sur l’adresse loopback de la machine distante. Collez ce code à l’invite Paste code here if prompted. Pour les sessions qui démarrent sans utilisateur présent, exécutez claude setup-token et définissez le token affiché comme CLAUDE_CODE_OAUTH_TOKEN partout où cela est nécessaire.

Q: Où Claude Code stocke-t-il mes informations de connexion sous Linux ?

Dans ~/.claude/.credentials.json avec le mode de fichier 0600, ou sous CLAUDE_CONFIG_DIR lorsque vous définissez cette variable. Linux n’utilise pas de keychain, contrairement à macOS. Tout processus exécuté avec votre compte utilisateur peut donc lire ce fichier. Une sauvegarde /home ou une image système contient par conséquent une session active. Exécutez /logout avant de créer un snapshot ou de copier un système. Si ANTHROPIC_API_KEY est également défini dans votre environnement, il prend le pas sur les informations d’abonnement stockées dès que vous l’autorisez, et /status indique lequel est actif.

Découvrez ce qui fonctionne nativement sous Linux : application bêta via apt, CLI Claude Code, plugins d’éditeur et forfait payant requis pour chacun.

Quelles parties de Claude s’exécutent nativement sous Linux aujourd’hui

Claude sous Linux fonctionne sur quatre interfaces distinctes. En août 2026, elles fonctionnent toutes sur une machine Ubuntu ou Debian standard. L’application de bureau s’installe depuis le dépôt apt d’Anthropic et est en version bêta. La CLI Claude Code (interface en ligne de commande) est un binaire compilé. Elle fonctionne sur davantage de distributions que l’application de bureau. L’application web sur claude.ai nécessite uniquement un navigateur. L’API est un endpoint HTTPS que vous appelez depuis votre propre code.

Deux fonctionnalités disponibles sous macOS et Windows manquent dans la bêta Linux de l’application de bureau : Computer Use, qui permet à Claude de contrôler les applications affichées à l’écran, et la dictée vocale. Anthropic indique que ces deux fonctionnalités ne sont pas encore disponibles sous Linux. La CLI possède sa propre fonction de dictée vocale. La limitation concerne donc l’application de bureau, et non Claude lui-même.

La disponibilité évolue. Considérez donc cette page comme une description des interfaces disponibles et vérifiez leur état actuel avant de baser votre planification dessus. La dernière section répertorie les pages à consulter.

Installer l’application de bureau Claude sur Ubuntu ou Debian

Les prérequis documentés sont Ubuntu 22.04 ou une version ultérieure, ou Debian 12 ou une version ultérieure, sur x86_64 (que dpkg appelle amd64) ou arm64. D’autres distributions basées sur Debian peuvent fonctionner, mais elles ne sont pas testées. Fedora et RHEL ne disposent pas encore de package. Sur ces distributions, utilisez donc la CLI ou le navigateur.

Installez l’application depuis le dépôt apt plutôt qu’à partir d’un fichier .deb téléchargé. L’application Linux ne possède pas son propre mécanisme de mise à jour. Les nouvelles versions arrivent donc uniquement par votre gestionnaire de paquets, et l’enregistrement du dépôt permet à apt upgrade de les trouver.

sudo apt install curl gnupg
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc \
  https://downloads.claude.ai/claude-desktop/key.asc
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc

gpg --show-keys doit afficher l’empreinte 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Comparez-la avant d’enregistrer le dépôt. Une clé de signature que vous n’avez pas vérifiée est une clé à laquelle vous faites confiance sans contrôle. Si gpg indique que le fichier ne contient aucune donnée OpenPGP valide, le téléchargement a échoué. apt update échoue alors plus tard avec NO_PUBKEY BAA929FF1A7ECACE.

L’enregistrement du dépôt consiste en une seule ligne deb écrite dans /etc/apt/sources.list.d/claude-desktop.list. Copiez cette ligne depuis la page d’installation Linux d’Anthropic, code.claude.com/docs/en/desktop-linux, exactement comme elle y est affichée. L’adresse du dépôt est l’élément de cette procédure le plus susceptible de changer. Une ligne saisie de mémoire vous laisse ensuite généralement face à E: Unable to locate package claude-desktop. Lisez la ligne avant de la coller : arch=amd64,arm64 explique pourquoi apt ne trouve rien sur une autre architecture, et signed-by= désigne le fichier de keyring que vous venez de vérifier. Cette configuration limite l’utilisation de cette clé à ce dépôt, au lieu de lui accorder une confiance globale pour tout ce que apt lit.

sudo apt update && sudo apt install claude-desktop

Lancez l’application depuis votre lanceur d’applications ou exécutez claude-desktop dans un terminal. Connectez-vous avec votre compte claude.ai ou avec le SSO (single sign-on) de votre organisation si votre entreprise l’a configuré. L’application de bureau n’accepte pas de clé API Claude Console. L’authentification par clé est une fonctionnalité de la CLI.

E: Unable to locate package claude-desktop signifie qu’apt n’a jamais lu le dépôt. cat /etc/apt/sources.list.d/claude-desktop.list doit afficher la ligne deb que vous avez écrite, et dpkg --print-architecture doit afficher amd64 ou arm64, car aucun package n’est publié pour les autres architectures. Les mises à jour arrivent ensuite avec le reste de votre système, depuis sudo apt update && sudo apt upgrade.

Ce qui existe uniquement dans un navigateur

claude.ai fonctionne dans n’importe quel navigateur récent sur n’importe quelle distribution. C’est donc la solution pour Fedora, RHEL, Arch, openSUSE et toutes les autres distributions sans package. Le navigateur donne également accès à Claude Code sur le Web. La session s’exécute alors dans le cloud d’Anthropic et non sur votre machine. Elle utilise toujours les identifiants de votre abonnement.

La limite du navigateur est le point important à comprendre. Une session cloud ne peut pas lire les fichiers de votre propre serveur ni y exécuter une commande. Toute opération qui agit sur votre machine nécessite un logiciel installé sur celle-ci. Il faut donc utiliser la CLI ou l’application desktop.

Ce que la CLI vous offre contrairement à l’application web

Lancez claude dans un répertoire : il agit sur ce répertoire. C’est la différence essentielle, et tout le reste en découle.

Il lit et modifie les fichiers de votre répertoire de travail, puis affiche chaque modification avant de l’appliquer.
Il exécute les commandes shell que vous approuvez. Il peut ainsi construire un projet, exécuter une suite de tests, lire un journal ou inspecter un service directement sur le serveur.
Il fonctionne sans session interactive : claude -p "read the nginx error log and summarise it" affiche une réponse, puis se ferme. C’est le mode à utiliser depuis une tâche cron ou un pipeline.
Il se connecte aux serveurs MCP (model context protocol) avec claude mcp add. Le modèle dispose ainsi d’outils qui dépassent le simple accès au système de fichiers.
Il fonctionne sans environnement de bureau graphique, ce qui est le cas de tous les VPS (virtual private server) que vous louerez.

C’est ce dernier point qui rend la CLI importante dans un guide consacré aux serveurs. Un serveur loué dispose de SSH (secure shell), et de rien d’autre. Le terminal est donc la seule interface disponible. Cette utilisation impose ses propres règles. Exécuter Claude Code sur un VPS dans tmux les présente en détail. Utiliser Claude pour les tâches d’administration système courantes décrit les tâches que vous pouvez lui confier.

Les intégrations aux éditeurs se situent entre ces deux modes. L’extension VS Code nécessite VS Code 1.94.0 ou une version ultérieure. Elle ajoute un panneau graphique dans l’éditeur, avec l’affichage des différences et la validation du plan. Elle intègre une copie privée de la CLI pour ce panneau et n’ajoute pas claude à votre PATH. La commande claude saisie dans le terminal intégré nécessite donc toujours l’installation autonome. Les éditeurs basés sur VS Code installent la même extension depuis le registre Open VSX. Il existe également un plugin JetBrains.

Faut-il Node.js pour exécuter Claude Code sous Linux ?

Pas avec l’installation recommandée. L’installateur natif télécharge un binaire compilé, qui ne s’exécute pas avec Node.js.

curl -fsSL https://claude.ai/install.sh | bash
claude --version

claude --version doit afficher un numéro de version tel que 2.1.211 (Claude Code). Si le résultat semble incorrect, exécutez claude doctor. Cette commande affiche des diagnostics en lecture seule sur l’installation et vos fichiers de configuration, sans démarrer de session.

Node.js est uniquement nécessaire avec la méthode npm. Depuis la version 2.1.198 du package, le package npm demande Node.js 22 ou une version ultérieure. Avec une version plus ancienne de Node.js, npm affiche un avertissement EBADENGINE au lieu d’échouer, car le package inclut le même binaire natif comme dépendance spécifique à la plateforme et le lie à l’emplacement prévu.

npm install -g @anthropic-ai/claude-code

Ne l’exécutez pas avec sudo. La documentation déconseille sudo npm install -g, car cette commande crée des fichiers appartenant à root dans votre préfixe npm global. L’installation ou la mise à jour suivante échoue alors à cause des permissions. Lorsque le répertoire npm global n’est pas accessible en écriture, la mise à jour automatique en arrière-plan cesse de fonctionner. claude doctor répertorie les correctifs.

Anthropic publie également des dépôts de packages signés pour Debian, Fedora, RHEL et Alpine. sudo apt install claude-code fonctionne donc de manière similaire au package pour poste de travail, avec sa propre clé de signature dans https://downloads.claude.ai/keys/claude-code.asc.

Faut-il installer le logiciel pour un utilisateur ou pour tout le système ?

L’installeur natif effectue une installation par utilisateur. Il place un launcher dans ~/.local/bin/claude sous forme de lien symbolique vers ~/.local/share/claude/versions/, ne nécessite pas root et se met à jour en arrière-plan. Chaque utilisateur de la machine dispose d’une copie distincte, avec sa propre version.

L’installation avec un gestionnaire de paquets s’applique à tout le système. Un seul binaire sert tous les utilisateurs, nécessite root et ne se met pas à jour automatiquement via Claude Code. Vous le mettez à niveau avec sudo apt update && sudo apt upgrade claude-code, la même commande que vous utilisez déjà pour les autres logiciels de la machine.

Choisissez l’installation par utilisateur sur une machine à laquelle vous vous connectez avec votre propre compte, ce qui couvre la plupart des usages sur VPS. Choisissez l’installation avec un gestionnaire de paquets sur un serveur partagé ou dans une image de machine, si vous voulez une seule version pour tout le monde et contrôler son calendrier de mise à jour. Avec une installation native, deux paramètres dans ~/.claude/settings.json déterminent le comportement des mises à jour :

{
  "autoUpdatesChannel": "stable",
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Le canal stable utilise une version qui date d’environ une semaine et ignore les versions présentant des régressions importantes. DISABLE_AUTOUPDATER désactive uniquement la vérification en arrière-plan. claude update continue donc de fonctionner et vous gardez le contrôle du moment où une nouvelle version est installée. C’est important sur un serveur qui exécute une tâche longue sans intervention, si vous préférez que le binaire ne change pas pendant son exécution.

Se connecter en SSH et conserver la session active

Deux problèmes spécifiques à Linux apparaissent lors de la première exécution de la CLI sur un serveur loué. La procédure de connexion nécessite un navigateur, mais le serveur n’en possède pas. Une connexion SSH interrompue interrompt aussi le travail en cours.

tmux résout le second problème. Une session tmux appartient au serveur tmux de la machine distante, et non à votre connexion. Une interruption de la liaison laisse donc le processus s’exécuter.

tmux new -s claude
claude

Détachez-vous avec Ctrl-b puis d, et revenez plus tard avec tmux attach -t claude.

La connexion constitue le premier problème. Exécutez claude : la commande affiche une URL d’autorisation. Ouvrez cette URL dans le navigateur de votre propre ordinateur. Après votre authentification, le navigateur affiche un code de connexion au lieu de rediriger vers l’application, car le navigateur de votre ordinateur portable ne peut pas atteindre le serveur de callback lancé par Claude Code sur l’adresse loopback de la machine distante. Collez ce code dans le terminal à l’invite Paste code here if prompted. Le terminal affiche alors Login successful.

Pour une session qui doit démarrer sans surveillance, claude setup-token ouvre la même page d’autorisation dans le navigateur et affiche un token OAuth valable un an dans le terminal. Le token n’est enregistré nulle part. Copiez-le et définissez-le à l’endroit nécessaire.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Ce token nécessite un forfait payant et peut uniquement effectuer des requêtes auprès des modèles. Traitez-le comme un mot de passe valable un an. L’emplacement où le conserver et la manière d’empêcher un agent de le lire sont expliqués dans garder les secrets hors de portée des agents IA.

Les petits serveurs rencontrent un autre problème. L’installation nécessite environ 512 MB de mémoire disponible, et la configuration matérielle documentée pour l’exécution exige 4 GB de RAM ou plus. Sur une instance de 1 GB, l’out-of-memory killer du kernel interrompt donc l’installation :

Setting up Claude Code...
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

Ajoutez du swap, puis relancez l’installateur. Le swap est un espace disque que le kernel utilise comme mémoire de débordement. Il est beaucoup plus lent que la RAM, mais il suffit pour terminer une installation.

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

swapon active le fichier uniquement pour ce boot. Ajoutez une ligne pour /swapfile dans /etc/fstab si vous voulez le réactiver après un reboot. Les autres mesures à prendre avant d’autoriser un agent à exécuter des commandes sur un serveur en production sont expliquées dans exécuter Claude Code en toute sécurité sur un VPS.

Où sont stockées vos informations d’identification Claude sous Linux

Sous Linux, /login écrit l’information d’identification dans ~/.claude/.credentials.json avec le mode de fichier 0600. macOS stocke la même information d’identification dans le trousseau chiffré. Une habitude prise sur Mac ne s’applique donc pas sous Linux : le token est un fichier en clair dans votre répertoire personnel, et tous les processus exécutés avec votre compte peuvent le lire. La définition de CLAUDE_CONFIG_DIR déplace le fichier dans ce répertoire.

Deux conséquences en découlent. Une sauvegarde de /home contient une session active. Copier cette sauvegarde sur une machine partagée donne donc accès à votre compte à toute personne pouvant la lire. De même, une image de machine créée à partir d’un système sur lequel vous vous êtes connecté transmet cette session à chaque instance clonée depuis cette image. Exécutez /logout avant de créer un snapshot.

La priorité entre les informations d’identification pose souvent problème aux utilisateurs qui disposent à la fois d’un abonnement et d’une clé d’API. Lorsque ANTHROPIC_API_KEY est défini dans votre shell, Claude Code l’utilise après votre validation. Votre abonnement reste alors inutilisé, tandis que la clé est facturée au token. /status indique quelle information d’identification est active, et unset ANTHROPIC_API_KEY vous reconnecte avec votre abonnement.

Les sessions de connexion expirent. Dans les trois jours précédant l’expiration, la ligne de démarrage affiche Your login expires in 3 days. Cet avertissement ne bloque jamais une requête. Après l’expiration, chaque requête échoue avec Login expired · Please run /login. Vous devez le savoir avant de laisser une session sans surveillance fonctionner pendant un week-end : elle cesse alors de progresser et ne peut pas récupérer automatiquement.

Un abonnement Claude couvre-t-il tout ?

Un seul forfait payant couvre toutes les interfaces avec le même identifiant. Un compte Pro, Max, Team ou Enterprise vous connecte à claude.ai dans un navigateur, à l’application de bureau, à la CLI et à l’extension VS Code. Il s’agit du même abonnement dans chaque cas. Le forfait gratuit de claude.ai n’inclut pas l’accès à Claude Code. La CLI et les fonctions Claude Code de l’application de bureau nécessitent donc un forfait payant ou un compte Claude Console.

L’API est un produit différent, avec une facturation distincte. Un compte Console facture les tokens réellement envoyés. Ce modèle convient à un service que vous développez plutôt qu’à une utilisation interactive dans un terminal. Définir ANTHROPIC_API_KEY fait passer la CLI sur ce mode de facturation. Il s’agit d’un choix, pas d’un mécanisme de repli.

Les prix et les limites des forfaits changent trop souvent pour être reproduits ici. Deux pages présentent les chiffres actuels : ce que Claude Code coûte réellement et le forfait Claude dont vous avez besoin. Si vous comparez la facturation par token à un forfait mensuel, l’API comparée à un abonnement explique où se situe le seuil de rentabilité.

Les erreurs d’installation que vous verrez réellement

bash: claude: command not found juste après une installation réussie. Le binaire se trouve dans ~/.local/bin/claude, mais ce répertoire ne figure pas dans le chemin de recherche de votre shell. Vérifiez-le avec echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin", qui n’affiche rien lorsque l’entrée est absente. Corrigez le problème pour bash avec echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc, puis exécutez source ~/.bashrc. L’installation de l’extension VS Code seule ne crée jamais ce fichier, car l’extension conserve sa copie CLI dans son propre répertoire.

Error loading shared library libstdc++.so.6. L’installateur a sélectionné la build musl pour un système glibc. Cela se produit lorsque des paquets de cross-compilation musl sont présents et que la détection les interprète mal. Exécutez ldd --version 2>&1 | head -1 : une sortie contenant GNU libc ou GLIBC signifie que vous utilisez glibc et que le mauvais binaire a été installé. Supprimez l’installation, puis relancez l’installateur. Sur Alpine et les autres systèmes musl, la correction est inverse : apk add libgcc libstdc++ ripgrep.

Deux copies de claude sur le même serveur. which -a claude répertorie toutes les correspondances dans votre PATH. Une installation native est un lien symbolique de ~/.local/bin/claude vers ~/.local/share/claude/versions/, une ancienne installation npm locale se trouve sous ~/.claude/local/, et npm -g ls @anthropic-ai/claude-code révèle une installation npm globale. Supprimez les copies dont vous ne voulez pas, car une ancienne copie située plus tôt dans votre PATH donne l’impression qu’un bug corrigé ne l’est pas.

Où vérifier l’état actuel

État du bureau Linux, prérequis et commandes d’installation : code.claude.com/docs/en/desktop-linux
Distributions prises en charge et toutes les méthodes d’installation de la CLI : code.claude.com/docs/en/setup
Plateformes proposant une application à télécharger : claude.com/download
Contenu et tarif de chaque forfait : claude.com/pricing

Chaque numéro de version et chaque date de ce guide correspondent à un instantané d’août 2026. Ce qui reste valable, c’est la structure : quatre interfaces, un seul compte pour les interfaces payantes, et un choix à faire pour déterminer si la CLI appartient à votre utilisateur ou à l’ensemble de la machine.

FAQ

Existe-t-il une application de bureau Claude pour Linux ?

Oui. En août 2026, elle est en bêta et prend en charge Ubuntu 22.04 ou version ultérieure ainsi que Debian 12 ou version ultérieure, sur amd64 ou arm64. Installez-la avec sudo apt install claude-desktop après avoir ajouté le dépôt apt d’Anthropic et sa clé de signature, afin que les nouvelles versions soient installées avec les mises à jour habituelles du système. La version Linux possède les mêmes onglets que l’application macOS, notamment l’onglet Claude Code. Computer Use et la dictée vocale ne sont pas encore disponibles dans la version Linux. Fedora et RHEL ne disposent d’aucun package. Sur ces distributions, utilisez donc la CLI ou claude.ai dans un navigateur.

Ai-je besoin de Node.js pour exécuter Claude Code sous Linux ?

Pas avec l’installation recommandée. curl -fsSL https://claude.ai/install.sh | bash télécharge un binaire compilé qui n’utilise pas Node.js à l’exécution. Node.js est nécessaire uniquement si vous installez le package npm, qui demande Node.js 22 ou version ultérieure depuis la version 2.1.198. Avec une ancienne version de Node.js, npm affiche un avertissement EBADENGINE, mais l’installation se termine quand même, car le même binaire natif est installé comme dépendance propre à la plateforme. Ne l’installez jamais avec sudo npm install -g, car cette commande crée des fichiers appartenant à root dans votre préfixe npm et empêche les mises à jour ultérieures.

Comment me connecter à Claude Code via SSH ?

Exécutez claude. La commande affiche une URL d’autorisation. Ouvrez cette URL dans le navigateur de votre propre ordinateur, pas sur le serveur. Après votre authentification, le navigateur affiche un code de connexion au lieu d’effectuer une redirection, car il ne peut pas atteindre le listener de callback démarré par Claude Code sur l’adresse loopback de la machine distante. Collez ce code à l’invite Paste code here if prompted. Pour les sessions qui démarrent sans utilisateur présent, exécutez claude setup-token et définissez le token affiché comme CLAUDE_CODE_OAUTH_TOKEN partout où cela est nécessaire.

Où Claude Code stocke-t-il mes informations de connexion sous Linux ?

Dans ~/.claude/.credentials.json avec le mode de fichier 0600, ou sous CLAUDE_CONFIG_DIR lorsque vous définissez cette variable. Linux n’utilise pas de keychain, contrairement à macOS. Tout processus exécuté avec votre compte utilisateur peut donc lire ce fichier. Une sauvegarde /home ou une image système contient par conséquent une session active. Exécutez /logout avant de créer un snapshot ou de copier un système. Si ANTHROPIC_API_KEY est également défini dans votre environnement, il prend le pas sur les informations d’abonnement stockées dès que vous l’autorisez, et /status indique lequel est actif.

Mon abonnement Claude Pro couvre-t-il aussi la CLI et l’application web ?

Oui. Un forfait Pro, Max, Team ou Enterprise vous connecte à claude.ai, à l’application de bureau, à la CLI et à l’extension VS Code avec un seul compte. Le forfait gratuit de claude.ai n’inclut pas Claude Code. La CLI du terminal nécessite donc un forfait payant ou un compte Claude Console. L’API est facturée séparément, au token, depuis un compte Console. Il s’agit d’un produit différent d’un abonnement.

#claude #linux #claude-code #cli#desktop