Faire tourner Claude Code ou Codex sur un VPS : le guide complet

Les agents de code comme Claude Code d'Anthropic et Codex CLI d'OpenAI lisent un projet, modifient des fichiers et lancent des commandes depuis le terminal. Les installer sur un VPS plutôt que sur son ordinateur a trois avantages : la session continue quand vous fermez votre portable, l'agent travaille dans un environnement isolé de vos fichiers personnels, et vous le retrouvez en SSH depuis n'importe quel appareil. Ce guide installe les deux outils sur un VPS Linux et met en place un environnement propre et sûr.

1. Pourquoi un VPS pour un agent de code

2. Préparer le serveur

Partez d'un VPS Linux sous Ubuntu 24.04 et sécurisez-le avant tout : utilisateur personnel, clé SSH, pare-feu. Voir premiers pas sur votre VPS. Créez ensuite un utilisateur dédié à l'agent, sans droits root :

adduser --disabled-password --gecos "" agent
apt update && apt install -y git tmux curl build-essential
su - agent

Travailler avec un utilisateur sans droits d'administration limite ce que l'agent peut modifier sur le système, même si une commande se passe mal.

3. Installer Claude Code

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

Au premier lancement, Claude Code vous propose de vous connecter avec votre compte Claude ou une clé API Anthropic. Sur un serveur sans navigateur, il affiche une adresse à ouvrir sur votre ordinateur pour valider la connexion. Placez-vous ensuite dans le dossier d'un projet et lancez claude.

4. Installer Codex CLI

Codex CLI s'installe avec npm, il faut donc Node.js. Installez la version LTS en root, puis l'outil :

curl -fsSL https://deb.nodesource.com/setup_lts.x | bash -
apt install -y nodejs
npm install -g @openai/codex
su - agent
codex

Codex se connecte avec votre compte ChatGPT ou une clé API OpenAI. Les deux agents peuvent cohabiter sur le même serveur.

5. Garder la session ouverte avec tmux

Sans précaution, l'agent s'arrête dès que la connexion SSH se coupe. tmux garde la session en vie sur le serveur :

tmux new -s agent          # crée une session nommée « agent »
claude                     # ou codex, dans le dossier du projet
# Ctrl+B puis D pour se détacher : l'agent continue
tmux attach -t agent       # pour revenir plus tard, depuis n'importe quel appareil

Vous pouvez ouvrir plusieurs fenêtres dans la même session (Ctrl+B puis C) : une pour l'agent, une pour suivre les tests ou les journaux.

6. Accès Git en sécurité

L'agent a besoin de cloner et de pousser du code. Ne lui donnez pas votre clé SSH personnelle :

• Une clé de déploiement par dépôt : créez une clé dédiée sur le serveur (ssh-keygen -t ed25519 -f ~/.ssh/depot) et ajoutez-la comme clé de déploiement du seul dépôt concerné.
• Ou un jeton à portée limitée : un jeton d'accès restreint à un dépôt et aux droits nécessaires, avec une date d'expiration.
• Une branche de travail : faites travailler l'agent sur une branche, et relisez avant de fusionner.

7. Les règles de sécurité à respecter

• Pas de secrets de production sur le serveur de l'agent : utilisez des bases et des clés de test.
• Relisez les commandes qu'il propose avant de les autoriser, au moins tant que vous découvrez l'outil. Les deux agents demandent une confirmation avant d'exécuter une commande ou de modifier un fichier, selon le mode choisi.
• Clés API dans des variables d'environnement, avec des droits limités et un plafond de dépenses chez le fournisseur.
• Mises à jour : relancez régulièrement l'installation de Claude Code ou npm update -g @openai/codex, et mettez le système à jour.
• Sauvegardes : si l'agent travaille sur des fichiers qui ne sont pas encore poussés, sauvegardez-les. Voir sauvegardes avec Borg.

8. Quelle configuration choisir

Ce n'est pas l'agent qui consomme, mais ce qu'il lance : installation de dépendances, compilation, suites de tests, conteneurs. Le stockage NVMe accélère nettement ces opérations. Les offres sont sur la page VPS agents IA, et les fiches Claude Code et Codex CLI de notre marketplace résument l'installation.

9. Le coût total

Il se compose de deux parties distinctes :

• Le serveur : le prix du VPS, fixe chaque mois.
• Le modèle : votre abonnement Claude ou ChatGPT, ou la consommation de votre clé API, facturée par Anthropic ou OpenAI selon l'usage.

Avec une clé API, fixez un plafond de dépenses mensuel dans la console du fournisseur : un agent qui tourne longtemps sur un gros projet peut consommer beaucoup.

10. Un exemple de journée de travail

Voici comment s'organise concrètement le travail avec un agent sur un serveur distant :

1. Le matin, depuis votre ordinateur : ssh agent@IP_DU_VPS, puis tmux attach -t agent. Vous retrouvez la session exactement où vous l'avez laissée.
2. Vous décrivez une tâche précise : « ajoute la pagination à l'API des commandes et écris les tests correspondants ». Plus la consigne est concrète, plus le résultat est fiable.
3. L'agent lit le projet, propose un plan, modifie les fichiers et lance les tests. Vous validez les commandes au fil de l'eau ou laissez-le travailler dans un mode plus autonome sur une branche dédiée.
4. Vous vous détachez avec Ctrl+B puis D pendant une longue tâche, par exemple une migration de dépendances, et vous revenez plus tard, même depuis votre téléphone avec une application SSH.
5. Vous relisez la branche avec git diff ou dans l'interface de votre forge, puis vous fusionnez.

Pour aller plus vite, ajoutez à la racine de chaque projet un fichier d'instructions (par exemple CLAUDE.md pour Claude Code ou AGENTS.md pour Codex) qui décrit les commandes de test, les conventions de code et ce que l'agent ne doit jamais toucher. L'agent le relit à chaque session.

11. Aller plus loin : agents autonomes et notifications

Un VPS permet aussi de faire tourner des agents qui travaillent sans vous, par exemple pour trier des tickets, surveiller un dépôt ou préparer un rapport chaque matin :

• Tâches planifiées : un script lancé par cron qui appelle l'agent en mode non interactif sur une tâche précise, puis enregistre le résultat.
• Notifications : à la fin d'une tâche, un message envoyé sur Telegram ou Discord par un simple appel HTTP. Voir VPS bot Telegram.
• Automatisations : n8n peut déclencher l'agent à partir d'un formulaire, d'un e-mail ou d'un webhook. Voir n8n sur VPS.

Dans tous les cas, gardez la même prudence : droits limités, clés de test, relecture humaine avant toute mise en production.

Questions fréquentes