Skip to main content

C_ installation de Claude Code dans le VPS juxjux

Installation de Claude Code dans le VPS juxjux

Objectif

Pouvoir intervenir sur les containers du VPS (redémarrage, diagnostic, logs, fix rapide) depuis un mobile Android en mobilité, via SSH + tmux + Claude Code CLI directement installé sur le VPS.

Prérequis constatés (2026-07-21)

  • Node.js : v20.20.2 déjà présent sur le VPS (Debian) — aucune installation nécessaire
  • npm : v10.8.2
  • tmux : absent, installé via sudo apt-get install -y tmux (v3.3a-3)

Installation de Claude Code CLI

Installation en local user (pas de sudo npm install -g) pour éviter de faire tourner le CLI en root et éviter les conflits de permissions npm globales :

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
npm install -g @anthropic-ai/claude-code

Ajout du PATH dans ~/.bashrc :

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

Version installée : 2.1.197

Authentification

Choix retenu : login OAuth avec le compte claude.ai (Julien, plan Claude Pro) — pas de clé API Anthropic séparée, donc pas de facturation à l'usage additionnelle.

Procédure suivie (le VPS est headless, pas de navigateur local) :

  1. Lancer claude dans une session tmux dédiée (tmux new-session -d -s claude) pour que la session survive à une déconnexion SSH
  2. Choisir "Claude account with subscription" au login
  3. Le CLI affiche une URL https://claude.com/cai/oauth/authorize?... — impossible à ouvrir depuis le VPS, donc récupérée via tmux capture-pane et ouverte manuellement sur un navigateur (PC ou mobile)
  4. Après connexion sur claude.ai, un code xxxx#yyyy est retourné — collé dans le prompt Paste code here if prompted > via tmux send-keys
  5. Confirmation : Logged in as julien.bertrand@live.fr

Les credentials sont persistés dans ~/.claude/.credentials.json (permissions 600, debian:debian) — la connexion reste valide pour les sessions futures, pas besoin de se ré-authentifier à chaque lancement.

Usage depuis Android (Termux)

  1. Installer Termux depuis F-Droid (pas le Play Store, version obsolète)
  2. Se connecter en SSH au VPS : 
    ssh debian@51.77.141.54
  3. Rattacher ou créer la session tmux : 
    tmux attach -t claude   # si la session existe déjà
tmux new -s claude      # sinon
  4. Lancer claude (ou il tourne déjà si la session persiste)
  5. Détacher sans tuer la session : Ctrl+b puis d — permet de couper la connexion mobile sans interrompre Claude Code

Sécurité

  • Le VPS a déjà subi un incident de sécurité (CVE rclone RC, 2026-06-09 — voir page correspondante) : rester vigilant sur toute nouvelle surface d'exposition
  • Claude Code tourne en utilisateur debian (non-root), scope de travail /home/debian accepté comme dossier de confiance
  • Authentification liée au compte personnel Julien (Claude Pro) — pas de clé API partagée à protéger séparément
  • Accès à la session Claude Code = accès SSH au VPS (mot de passe debian) — aucune surface réseau supplémentaire ouverte (pas de port exposé, tout passe par SSH existant)

Points d'attention pour la suite

  • Lancer Claude Code dans un répertoire de projet dédié plutôt que /home/debian directement (recommandation affichée au premier lancement) — par exemple un dossier ~/claude-workspace ou directement dans le repo/stack à diagnostiquer
  • Penser à /init pour générer un CLAUDE.md propre au contexte VPS si l'usage se confirme
  • Vérifier que la session tmux ne meurt pas silencieusement (pas de Restart=always type systemd ici, contrairement aux services rclone)
Back to top