Anime-Sanctuary

Assistant IA sur son serveur

Vous voulez un assistant IA sur votre serveur, sans lui confier les clés de la maison. Installons-le sur un compte réservé, avec une sauvegarde derrière nous, puis regardons l'alternative qui tourne chez vous.

Parcours
Tutoriel 28 sur 35
Durée
25 min de lecture
Vérifié avec
Debian 13.7, Claude Code 2.1.318
Ce que vous saurez faire
  • Choisir entre un assistant en ligne et un modèle local.
  • Créer un compte réservé à l'assistant et sauvegarder avant de commencer.
  • Installer l'assistant, puis le lancer et vous connecter.
  • Choisir le mode de permission de l'assistant, et savoir quel matériel un modèle local demande.

Avant de commencer : Première connexion en SSH, Sécuriser SSH : couper les mots de passe, Utilisateurs, sudo et droits.

Sommaire
  1. Deux façons d'avoir un assistant sur son serveur
  2. Créer un compte réservé à l'assistant
  3. Sauvegarder avant
  4. Installer l'assistant
  5. Le premier lancement
  6. Ce qu'il peut exécuter, et comment le cadrer
  7. L'alternative : un modèle local
  8. Si ça échoue
  9. La suite
  10. Sources

Comment héberger un assistant IA sur son serveur ? Vous avez une machine sous Debian et des commandes que vous ne connaissez pas encore par cœur. Un assistant lit vos fichiers et propose les bonnes lignes, à une condition : qu'il ne puisse casser que ce que vous avez prévu. Ce tutoriel installe l'assistant dans un coin fermé du serveur, puis explique quand un modèle local est une meilleure idée. Prévenons tout de suite : l'assistant en ligne demande un compte en ligne payant, détaillé à l'étape 4. Le modèle local n'en demande aucun.

Deux façons d'avoir un assistant sur son serveur

Deux options existent. L'assistant en ligne est installé sur le serveur, mais il réfléchit chez son éditeur. Le modèle local réfléchit sur le serveur lui-même. Ici, l'assistant en ligne est Claude Code, un programme édité par Anthropic. Voici ce qui les distingue :

  • Un assistant en ligne est un programme que vous lancez dans le terminal et à qui vous écrivez en français. Il lit vos fichiers, propose des commandes et les exécute si vous acceptez. Il est léger et demande un compte en ligne payant, car sa réflexion se fait sur les machines de l'éditeur, par Internet.
  • Un modèle local est le « cerveau » de l'IA, un gros fichier que votre serveur fait tourner lui-même. Rien ne sort de chez vous, mais il lui faut de la mémoire et, idéalement, une carte graphique.

Nous commençons par l'assistant en ligne, parce que le calcul se fait chez l'éditeur : votre serveur n'a besoin que de 4 Go de mémoire. Le modèle local a son chapitre plus bas. Un compte Linux est une identité sur la machine, avec son dossier personnel et ses droits. L'assistant lance ses commandes avec les droits du compte qui l'a démarré. Fabriquons-lui donc un compte à sa taille.

Où vit l'assistant Votre ordinateur se connecte en SSH au serveur sous le compte alice. Sur le serveur, l'assistant vit dans le compte assistant, sans sudo. Il envoie ses questions à un service en ligne et reçoit des propositions de commandes. Votre ordinateur SSH mon-serveur alice sudo assistant sans sudo Internet Service en ligne
Vous arrivez en alice. L'assistant vit dans son propre compte, sans sudo, et parle à un service en ligne.

Texte alternatif : votre ordinateur se connecte en SSH à mon-serveur. Sur mon-serveur, deux comptes : alice avec sudo, et assistant sans sudo. Le compte assistant envoie ses questions à un service en ligne par Internet.

1Créer un compte réservé à l'assistant

Créez un compte à part, sans droit d'administrateur. Le préfixe sudo prête ces droits le temps d'une commande, et ce compte n'y aura pas droit. L'assistant ne pourra ainsi pas modifier le système lui-même. Le rappel complet se trouve dans Utilisateurs, sudo et droits. Connectez-vous d'abord par SSH, comme dans Première connexion en SSH. Ici, alice est un nom d'exemple : remplacez-le par votre propre utilisateur. Lancez ces deux commandes. La première crée le compte assistant sans mot de passe : tant que vous n'y ajoutez pas de clé, personne ne peut s'y connecter par SSH. La seconde, id, prouve que le compte existe en affichant ses numéros. Vous y entrerez depuis alice, à l'étape 3.

Sur le serveur, connecté en alice
sudo adduser --disabled-password --gecos "" assistant
id assistant
Résultat attendu
uid=1001(assistant) gid=1001(assistant) groups=1001(assistant),100(users)

Les numéros peuvent varier chez vous. Vérifiez maintenant qu'il n'a aucun droit d'administrateur. Cette commande demande à sudo (-l liste les droits, -U désigne le compte) ce que le compte Linux assistant a le droit de faire.

Sur le serveur, connecté en alice
sudo -l -U assistant
Résultat attendu
User assistant is not allowed to run sudo on mon-serveur.

Vérifiez que son dossier personnel est fermé aux autres comptes Linux. L'option -d de ls montre le dossier lui-même, pas son contenu. Les droits drwx------ signifient que seul le propriétaire y entre.

Sur le serveur, connecté en alice
ls -ld /home/assistant /home/alice
Résultat attendu
drwx------ 2 alice     alice     4096 Nov  6 09:19 /home/alice
drwx------ 2 assistant assistant 4096 Nov  6 09:19 /home/assistant

Les dates seront les vôtres. Les autres comptes n'entrent donc pas dans le dossier d'alice. Il reste à vous protéger des erreurs de l'assistant lui-même.

2Sauvegarder avant

Faites une copie de /etc, le dossier des réglages du système, avant de laisser l'assistant approcher quoi que ce soit. Une sauvegarde est une copie de réserve, pour revenir en arrière si une manœuvre tourne mal. Ici, la copie sera un seul fichier, une archive, rangé chez alice, dossier fermé aux autres comptes à l'étape précédente. Elle contient vos réglages, y compris les mots de passe chiffrés des comptes : gardez-la là et nulle part ailleurs.

Sur le serveur, connecté en alice
mkdir -p ~/sauvegardes
sudo tar -czf ~/sauvegardes/etc-avant-assistant.tar.gz -C / etc
sudo chown alice: ~/sauvegardes/etc-avant-assistant.tar.gz
chmod 600 ~/sauvegardes/etc-avant-assistant.tar.gz
ls -lh ~/sauvegardes
Résultat attendu
total 96K
-rw------- 1 alice alice 94K Nov  6 10:51 etc-avant-assistant.tar.gz

La taille et la date seront les vôtres. tar range un dossier entier dans un seul fichier : -c crée l'archive, -z la comprime, -f donne son nom et -C / se place d'abord à la racine du système, le dossier /. Ensuite chown donne le fichier à alice, et chmod 600 le réserve à elle seule : il contient des mots de passe chiffrés. Cette archive protège les réglages ; pour vos données, passez par Première sauvegarde avec rsync, qui copie vers une autre machine.

Reprendre un fichier de l'archive

Pour retrouver un fichier, extrayez-le dans un dossier à part, sans toucher à /etc. Ici, -x extrait et etc/hostname nomme le fichier voulu. Il apparaît dans ~/restauration/etc/hostname : vous l'ouvrez à côté du fichier actuel de /etc, puis vous ne recopiez que la ligne à rétablir.

Sur le serveur, connecté en alice
mkdir -p ~/restauration
tar -xzf ~/sauvegardes/etc-avant-assistant.tar.gz -C ~/restauration etc/hostname
ls ~/restauration/etc

3Installer l'assistant

Installez Claude Code depuis le compte assistant. Claude Code demande Debian 10 ou plus et 4 Go de RAM, la mémoire de travail de la machine. Il faut aussi curl, le programme qui télécharge une adresse web. Depuis alice, la commande suivante installe curl, ou vous dit qu'il est déjà là.

Sur le serveur, connecté en alice
sudo apt install -y curl

Pour travailler dans le compte assistant, ouvrez-y une session depuis alice. L'option -u assistant désigne le compte à ouvrir, et -i règle la session comme si l'assistant venait de se connecter. Vous en sortirez avec exit, qui ferme la session et vous ramène en alice.

Sur le serveur, connecté en alice
sudo -iu assistant

Vous êtes maintenant dans le compte assistant. L'installateur est un script de l'éditeur : un fichier de commandes que bash, le programme du terminal, lit ligne à ligne. Téléchargez-le d'abord dans un fichier, lisez-le avec less (q pour quitter), puis lancez-le. Vous y verrez surtout des téléchargements depuis des adresses de l'éditeur et des copies dans ~/.local. Si le texte vous semble illisible ou parle d'autres sites, arrêtez-vous et demandez conseil.

Sur le serveur, connecté en assistant
curl -fsSL https://claude.ai/install.sh -o install.sh
less install.sh
bash install.sh
Résultat attendu
Setting up Claude Code...

Checking installation status...
Installing Claude Code native build latest...
Setting up launcher and shell integration...
Setup notes:
  * Native installation exists but ~/.local/bin is not in your PATH. Run:

    echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

Claude Code successfully installed!

  Version: 2.1.318

  Location: ~/.local/bin/claude


  Next: Run claude --help to get started

Setup notes:
  * Native installation exists but ~/.local/bin is not in your PATH. Run:

    echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc


Installation complete!

Le numéro de version sera sûrement plus récent. L'installateur dit que le PATH, la liste des dossiers où le terminal cherche les programmes, ne contient pas encore ~/.local/bin. Il propose une commande pour l'ajouter, que vous pouvez ignorer : à la connexion suivante, Debian ajoute ce dossier toute seule. C'est ce que la commande suivante vérifie. Vous restez dans le compte assistant, mais exec bash -l remplace votre terminal par un neuf, comme à la connexion (-l veut dire « login »). Puis vous demandez la version.

Sur le serveur, connecté en assistant
exec bash -l
claude --version
Résultat attendu
2.1.318 (Claude Code)

Cette installation se met à jour toute seule en arrière-plan. Pour une mise à jour immédiate, tapez claude update.

4Le premier lancement

L'assistant se connecte à votre compte en ligne chez l'éditeur, à ne pas confondre avec le compte Linux. Un compte gratuit ne suffit pas. Deux formules existent :

  • Un abonnement payant chez l'éditeur, qui inclut l'usage de Claude Code. Le prix est fixe chaque mois, c'est ce que je conseille pour débuter.
  • Un compte Console, l'espace développeur de l'éditeur, où vous versez une somme à l'avance. Chaque question en consomme un peu : vous payez ce que vous utilisez, donc la facture varie.

Les prix changent : lisez la page officielle des offres, sur le site de l'éditeur, avant de payer. Vous êtes encore dans le compte Linux assistant. Créez un dossier de travail, puis lancez claude à l'intérieur.

Sur le serveur, connecté en assistant
mkdir -p ~/travail
cd ~/travail
claude --permission-mode manual

L'option --permission-mode choisit le mode de permission, expliqué plus bas. Ses valeurs possibles s'affichent avec claude --help.

L'assistant vous demande si vous faites confiance à ce dossier : répondez oui, c'est le vôtre. Il propose ensuite de vous connecter. Votre serveur n'a pas de navigateur, alors il affiche une adresse. Copiez-la, ouvrez-la sur votre ordinateur et connectez-vous à votre compte en ligne. Le navigateur affiche alors un code. Collez-le si l'assistant le demande, à l'invite Paste code here if prompted (« collez le code ici si on vous le demande »). Le terminal annonce Login successful.

Pour vérifier la connexion, quittez l'assistant avec /exit (il ferme l'assistant seulement, alors que exit ferme la session du compte) et interrogez l'outil. Il affiche quelques lignes de réglages : cherchez la ligne loggedIn, qui doit finir par true. Cette commande n'est utile que si vous doutez de votre connexion. Avec false, voyez « Si ça échoue ».

Sur le serveur, connecté en assistant
claude auth status

Relancez claude --permission-mode manual dans ~/travail, puis posez une première question sans danger : « Quelle version de Debian tourne ici et combien d'espace disque reste-t-il ? » S'il veut lancer une commande, il doit demander la permission : vous la lisez, puis vous acceptez ou vous refusez. S'il ne demande rien, voyez « Si ça échoue ». Voyons pourquoi cette permission compte.

Ce qu'il peut exécuter, et comment le cadrer

L'assistant peut lancer n'importe quelle commande permise au compte Linux assistant. Le mode de permission règle ce qu'il fait sans vous demander. Retenez celui-ci :

  • manual : il lit seul, mais demande avant de modifier ou d'exécuter. C'est le mode du lancement de l'étape 4, et le bon pour débuter.

La documentation en décrit d'autres, comme acceptEdits (il modifie les fichiers sans demander) ou auto, qui laissent l'assistant agir de plus en plus librement. Gardez-les pour plus tard ; le plus risqué, bypassPermissions, supprime tout garde-fou. Il se réserve aux conteneurs, c'est-à-dire des mini-machines jetables, isolées du reste de la vôtre.

Quatre habitudes complètent ce réglage :

  • Pas de sudo pour ce compte Linux. Quand une commande demande les droits d'administrateur, vous la lancez vous-même en alice, après l'avoir lue.
  • Pas de secrets à portée. Il lit tout ce que son compte lit (ses propres dossiers, mais aussi la plupart des réglages dans /etc), et ce qu'il lit part vers le service en ligne. Gardez mots de passe et clés hors de ~/travail, par exemple dans le dossier d'alice.
  • Pas de contenu inconnu collé tel quel. Un texte piégé peut tenter de lui donner des ordres, ce qu'on appelle une injection de prompt. Relisez ce que vous lui donnez à lire.
  • Pas de mode sans garde-fou. L'éditeur le réserve aux conteneurs, et l'outil refuse de le lancer en root, l'administrateur.

Avec un compte Linux limité et le mode manuel, l'assistant ne peut modifier que ce que son compte touche. La sauvegarde, elle, ne limite rien : elle vous permet de revenir en arrière. Il peut en revanche lire ce que son compte lit, et cela part chez l'éditeur. Si vous préférez que rien ne parte chez un tiers, il faut regarder l'autre voie.

L'alternative : un modèle local

Un modèle local garde vos données sur le serveur, mais il demande plus de matériel et répond moins bien qu'un grand service en ligne. Le tableau compare les deux voies.

CritèreAssistant en ligneModèle local
Où il réfléchitChez l'éditeurSur votre serveur
Ce qui quitte le serveurCe qu'il lit et vos questionsRien
Matériel4 Go de RAM au minimumAssez de mémoire disponible pour loger le modèle, plus de la marge
CoûtUn compte en ligne payantLe matériel et l'électricité
Agir sur le serveurIl propose et lance des commandesIl répond à vos questions, sans agir

Ollama est un programme qui télécharge et fait tourner un modèle local. Vous pouvez l'utiliser à la place de Claude Code, ou en plus : c'est un assistant qui répond à vos questions sans toucher au serveur. On l'installe et on le lance depuis alice, car son installation demande sudo, que le compte assistant n'a pas. Ce qui décide : la mémoire du serveur doit avoir assez de place libre pour contenir le modèle, tant qu'il tourne. Le nom llama3.2:1b désigne un petit modèle (1b : un milliard de réglages internes), qui pèse 1,3 Go à télécharger. Le modèle travaille en mémoire avec des données en plus de son poids : prévoyez au moins le double de 1,3 Go, soit 2,6 Go ici. Lisez la colonne available de cette commande : c'est la mémoire que les programmes peuvent encore obtenir.

Sur le serveur, connecté en alice
free -h
Résultat attendu
               total        used        free      shared  buff/cache   available
Mem:            62Gi        11Gi       1.8Gi       753Mi        51Gi        51Gi
Swap:          8.0Gi       136Mi       7.9Gi

L'installation et un premier essai tiennent en cinq commandes :

  • apt install ajoute zstd, dont l'installateur a besoin pour décompresser.
  • curl télécharge le script d'Ollama dans un fichier, sans l'exécuter.
  • less l'ouvre : flèches pour défiler, q pour quitter. Vous y verrez des téléchargements depuis ollama.com ; si le texte parle d'autres sites, arrêtez-vous.
  • sh l'exécute (ce script est écrit pour sh, à la différence de celui de l'étape 3). Il peut demander votre mot de passe sudo en cours de route.
  • ollama run télécharge le modèle, patientez, et ouvre une conversation en texte ; /bye en sort.
Sur le serveur, connecté en alice
sudo apt install -y zstd
curl -fsSL https://ollama.com/install.sh -o install.sh
less install.sh
sh install.sh
ollama run llama3.2:1b
Carte graphique et mémoire du modèle

Une carte graphique (GPU) calcule bien plus vite que le processeur. Ollama s'en sert avec une carte NVIDIA compatible et un pilote en version 550 ou plus (le programme de NVIDIA qui fait parler le système à la carte). Sans carte, il utilise le processeur, plus lentement. Une fois le modèle chargé, la commande ollama ps montre la mémoire qu'il occupe.

Si ça échoue

Quatre situations reviennent :

  • claude: command not found. Vous n'avez pas rouvert le compte après l'installation, donc le terminal ne cherche pas encore dans ~/.local/bin. Tapez exit pour revenir en alice, puis rouvrez le compte avec sudo -iu assistant. Sans le -i, un simple sudo -u assistant ne lit pas le profil, le fichier de réglages que le terminal lit à la connexion, et reproduit l'erreur.
  • Not logged in · Please run /login, loggedIn à false, ou un code refusé. L'outil est installé mais pas connecté. Lancez claude, tapez /login et suivez l'adresse affichée. Si l'adresse ne s'ouvre pas ou si le code est refusé, relancez /login pour en obtenir un neuf.
  • curl: command not found. Le script d'installation ne se télécharge pas, donc rien ne s'installe. Faites-le dans cet ordre. Tapez exit pour revenir en alice. Installez curl avec sudo apt install -y curl. Rouvrez le compte avec sudo -iu assistant. Reprenez enfin l'étape 3 au téléchargement de install.sh.
  • L'assistant exécute des commandes sans rien demander. Il n'est pas en mode manuel. Quittez-le avec /exit, puis relancez claude --permission-mode manual : l'option est écrite à la fin de la ligne de lancement.

La suite

Votre assistant vit désormais dans un compte Linux limité, et une copie de /etc est rangée chez alice. Il vous aide quand vous êtes devant l'écran, mais il ne vous prévient de rien quand vous dormez. L'article suivant, Supervision simple, installe la surveillance qui vous alerte quand le serveur va mal.

Sources (consultées le 5 novembre 2026)

  • Claude Code : installation, connexion, sécurité, modes de permission.
  • Ollama : installation sous Linux, FAQ, cartes graphiques, modèle llama3.2.
  • Commandes : essais sous Debian 13.7 (création du compte, sudo, sauvegarde, installation). Ollama : installation et petit modèle essayés sur processeur seul ; téléchargement du script et sa lecture avec less essayés en conteneur. Non testés, donc à vérifier chez vous : la connexion à votre compte en ligne, le premier échange, les modes de permission en session et toute carte graphique.