Claude sous Linux : application desktop ou CLI ?

Composants de Claude qui s’exécutent nativement sous Linux aujourd’hui

Sous Linux, Claude est disponible sur quatre surfaces distinctes. En août 2026, les quatre fonctionnent 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 de ligne de commande) est un binaire compilé. Elle fonctionne sur davantage de distributions que l’application de bureau. L’application web disponible 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 version bêta de l’application de bureau Linux : 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 dispose de sa propre fonction de dictée vocale. L’absence concerne donc l’application de bureau, et non Claude lui-même.

La disponibilité évolue. Considérez cette page comme une description des différentes surfaces et vérifiez leur état actuel avant de concevoir votre environnement en fonction de celles-ci. La dernière section indique les pages à consulter.

Installer l’application de bureau Claude sur Ubuntu ou Debian

Les prérequis indiqué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 updater. Les nouvelles versions vous parviennent donc uniquement par votre gestionnaire de paquets. L’enregistrement du dépôt permet à apt upgrade de les détecter.

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 à écrire une seule ligne deb 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 telle qu’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 est la cause la plus probable de l’apparition de 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 option limite l’utilisation de cette clé à ce dépôt, au lieu de la faire approuver pour tout ce que apt lit.

sudo apt update && sudo apt install claude-desktop

Lancez l’application depuis le lanceur d’applications ou exécutez claude-desktop dans un terminal. Connectez-vous avec votre compte claude.ai ou via 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 tous les navigateurs récents, sur toutes les distributions. C’est donc la solution pour Fedora, RHEL, Arch, openSUSE et toute autre distribution ne proposant aucun package. Le navigateur donne aussi accès à Claude Code sur le web. La session s’exécute dans le cloud d’Anthropic et non sur votre machine. Elle utilise toujours les identifiants de votre abonnement.

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

Ce que la CLI permet et que l’application web ne permet pas

Lancez claude dans un répertoire : il travaille sur ce répertoire. C’est toute la différence, et 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 compiler 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 quitte. C’est ce que vous utilisez depuis une tâche cron ou un pipeline. Vous pouvez définir le format de cette réponse, car un style de sortie modifie le prompt système utilisé pour chaque réponse et peut garder une exécution scriptée concise, tandis qu’une session interactive fournit des explications.
• Il se connecte aux serveurs MCP (model context protocol) avec claude mcp add, ce qui fournit au modèle des outils allant au-delà du système de fichiers.
• Il fonctionne là où aucun environnement de bureau graphique n’est disponible, ce qui est le cas de tous les VPS (virtual private server) que vous louerez.

C’est ce dernier point qui rend la CLI intéressante 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 pour administrer le serveur. Cette utilisation impose ses propres règles, présentées en détail dans exécuter Claude Code sur un VPS dans tmux. La page utiliser Claude pour les tâches d’administration système courantes présente les tâches qu’il est pertinent de lui confier.

Les intégrations aux éditeurs se situent entre les deux. L’extension VS Code nécessite VS Code 1.94.0 ou une version ultérieure et fournit un panneau graphique dans l’éditeur, avec affichage des différences et validation du plan. Elle embarque une copie privée de la CLI pour ce panneau et n’ajoute pas claude à votre PATH. Saisir claude 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. Un plugin JetBrains est également disponible.

Avez-vous besoin de Node.js pour exécuter Claude Code sous Linux ?

Pas avec l’installation recommandée. L’installeur natif télécharge un binaire compilé. Ce binaire 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 n’est nécessaire qu’avec la méthode npm. Depuis la version 2.1.198 du package, celui-ci 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. Le package récupère en effet le même binaire natif comme dépendance spécifique à la plate-forme et le lie à l’emplacement prévu.

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

N’exécutez pas cette commande avec sudo. La documentation déconseille sudo npm install -g, car cette méthode 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. Ainsi, sudo apt install claude-code fonctionne de manière similaire au package pour ordinateur de bureau, avec sa propre clé de signature à l’emplacement https://downloads.claude.ai/keys/claude-code.asc.

Installer Claude Code par utilisateur ou à l’échelle du système ?

L’installateur natif s’installe par utilisateur. Il place un launcher dans ~/.local/bin/claude sous forme de lien symbolique vers ~/.local/share/claude/versions/. Il 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’effectue à l’échelle du système. Un seul binaire sert tous les utilisateurs. Elle nécessite root et Claude Code ne la met pas automatiquement à jour. Vous la mettez à niveau avec sudo apt update && sudo apt upgrade claude-code, la même commande que celle que vous utilisez déjà pour le reste du système.

Choisissez l’installation par utilisateur sur une machine à laquelle vous vous connectez avec votre propre compte, ce qui couvre la plupart des usages sur un 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 tous les utilisateurs et décider vous-même du calendrier des mises à 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 suit une version sortie environ une semaine plus tôt et ignore les versions qui présentent 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 sur le moment où une nouvelle version est installée. C’est important sur un serveur qui exécute une tâche longue sans surveillance, lorsque 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 propres à 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. Si la connexion SSH est interrompue, le travail en cours s’arrête avec elle.

tmux résout le second problème. Une session tmux appartient au serveur tmux de la machine distante, et non à votre connexion. Une coupure 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 est le premier problème. Exécutez claude pour afficher une URL d’autorisation. Ouvrez cette URL dans le navigateur de votre ordinateur. Après votre authentification, le navigateur affiche un code de connexion au lieu de revenir à l’application, car le navigateur de votre ordinateur portable ne peut pas atteindre le serveur de callback démarré 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. Il n’enregistre le token nulle part. Copiez-le et définissez-le à l’endroit approprié.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Ce token nécessite un forfait payant et peut uniquement envoyer des requêtes aux 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 est le sujet de garder les secrets hors de portée des agents IA.

Les petits serveurs rencontrent un autre obstacle. L’installation nécessite environ 512 MB de mémoire libre. La configuration matérielle documentée pour l’exécution nécessite au moins 4 GB de RAM. 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 secours. Il est beaucoup plus lent que la RAM, mais 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 à /etc/fstab si vous voulez le réactiver après un redémarrage. Les autres éléments à sécuriser avant d’autoriser un agent à exécuter des commandes sur un serveur en production sont présentés dans exécuter Claude Code en toute sécurité sur un VPS.

Emplacement de vos identifiants Claude sous Linux

Sous Linux, /login écrit l’identifiant dans ~/.claude/.credentials.json avec le mode de fichier 0600. macOS stocke le même identifiant 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 chaque processus exécuté avec votre compte peut le lire. La définition de CLAUDE_CONFIG_DIR déplace ce fichier sous 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 permet donc à toute personne pouvant la lire d’utiliser votre compte. De même, une image système créée à partir d’une machine sur laquelle vous vous êtes connecté inclut cette session dans chaque instance clonée. Exécutez /logout avant de créer un snapshot.

La priorité des identifiants pose souvent problème aux utilisateurs qui disposent à la fois d’un abonnement et d’une clé 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 quel identifiant est actif, et unset ANTHROPIC_API_KEY vous reconnecte avec votre abonnement.

Les sessions 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. Tenez-en compte avant de laisser une session sans surveillance fonctionner pendant un week-end : elle cesse alors de progresser et ne peut pas se rétablir seule.

Une seule souscription Claude couvre-t-elle tous les usages ?

Un forfait payant donne accès à 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 de la même souscription dans chaque cas. La limite d’utilisation est également commune à toutes ces interfaces. Une longue exécution de la CLI sur votre serveur réduit donc la capacité restante dans l’application de bureau. Lorsque l’une des interfaces refuse une opération, vous devez déterminer quelle fenêtre de limite vous avez atteinte et comment réagir. Le forfait gratuit de claude.ai n’inclut pas l’accès à Claude Code. La CLI et les fonctionnalités 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. La définition de ANTHROPIC_API_KEY fait passer la CLI sur ce mode de facturation. Il s’agit d’un choix explicite, et non d’un mécanisme de secours.

Les prix et les limites des forfaits changent trop souvent pour être reproduits ici. Deux pages suivent les valeurs actuelles : le coût réel de Claude Code et le forfait Claude dont vous avez besoin. Si vous comparez la facturation au token à un forfait mensuel, la comparaison entre l’API et une souscription vous aide à déterminer le seuil de rentabilité.

Les erreurs d’installation que vous rencontrerez 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 n’est pas présent dans le chemin de recherche de votre shell. Vérifiez-le avec echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin" : cette commande 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’installeur a sélectionné le 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 vous avez reçu le mauvais binaire. Supprimez donc l’installation, puis relancez l’installeur. Sur Alpine et les autres systèmes musl, la correction est inverse : apk add libgcc libstdc++ ripgrep.

Deux copies de claude sur un même serveur. which -a claude répertorie toutes les correspondances trouvées 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é est toujours présent.

Où vérifier l’état actuel

• État du poste 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 offre : claude.com/pricing

Tous les numéros de version et toutes les dates de ce guide correspondent à un instantané d’août 2026. L’organisation générale reste valable : quatre interfaces, un seul login pour les interfaces payantes, et un choix à faire pour déterminer si la CLI est installée pour votre utilisateur ou pour toute 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 vos mises à niveau système habituelles. 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 paquet. 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 paquet npm, qui demande Node.js 22 ou version ultérieure depuis la version 2.1.198. Avec une version plus ancienne de Node.js, npm affiche un avertissement EBADENGINE, mais l’installation se termine tout de même, car le même binaire natif est installé comme dépendance propre à la plateforme. N’utilisez jamais sudo npm install -g, car cette commande crée des fichiers appartenant à root dans votre préfixe npm et bloque 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 ainsi une session valide. 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 est prioritaire sur les informations de connexion de l’abonnement stockées dès que vous l’approuvez. /status indique lequel est actif.

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

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