Agents IA. Démarrage rapide

Le module « Agents IA » du panneau BeAdmin crée sur votre serveur des espaces de travail isolés pour travailler avec l’IA. Chaque espace de travail dispose de son propre utilisateur avec accès SSH et d’une session tmux permanente : si vous fermez le terminal ou éteignez votre ordinateur portable, la session et les tâches qui y tournent continuent de s’exécuter, et à la connexion suivante vous retrouvez l’espace là où vous l’avez laissé. Un agent IA pour écrire du code s’installe par-dessus — par exemple Claude Code d’Anthropic.

Cet article décrit le scénario minimal : installer le module et Claude Code comme fournisseur d’IA, ajouter une clé API et votre propre clé SSH, vous connecter à un espace de travail et lancer l’agent.

Sans licence, vous disposez d’un espace de travail et d’un fournisseur d’IA, de quoi essayer le module. L’agent fonctionne avec votre propre clé API, et la consommation de tokens est facturée chez le fournisseur : le panneau ne la voit pas et ne la limite pas.

Ce dont vous avez besoin

• Un serveur avec BeAdmin et au moins 4 Go de mémoire vive. Sur un serveur qui en a moins, le module ne sera pas installé, car il ne pourrait pas fonctionner de façon stable : vérifiez donc la mémoire avant l’installation.
• Une clé API Anthropic. Vous pouvez en créer une dans votre compte sur platform.claude.com.
• Un ordinateur doté d’un client SSH : un terminal sous Linux et macOS, PowerShell ou WSL sous Windows. Si vous ne vous êtes encore jamais connecté à un serveur en SSH, commencez par l’article Se connecter à un serveur en SSH.

Si vous n’avez pas encore de serveur de ce type, chez nos partenaires, un VPS avec BeAdmin est prêt dès la commande.

Plus de 15 ans d’expérience dans l’hébergement. Votre VPS avec BeAdmin est prêt à l’emploi.

• Allemagne
• Pays-Bas
• Suède
• Suisse
• Espagne
• États-Unis

Choisir un serveur

La fiabilité européenne en toute simplicité. Lancez BeAdmin avec votre VPS en un clic.

• Allemagne
• Pays-Bas
• Suède
• Estonie
• Roumanie
• Suisse
• Espagne
• Royaume-Uni
• États-Unis

S’inscrire

Installer le module

Dans le menu latéral du panneau, ouvrez la section « Agents IA » et cliquez sur « Installer ». Vous pouvez suivre l’avancement de l’installation avec le bouton « Journaux ».

Une fois l’installation terminée, le panneau ouvre la liste des espaces de travail. L’installation crée et démarre elle-même le premier espace de travail, « Principal ». Pour en ajouter d’autres, vous devez acheter des emplacements supplémentaires — voir l’article Agents IA. Espaces de travail et accès.

ℹ️ Installation après la désinstallation du module

Si vous avez désinstallé le module sans cocher « Supprimer les fichiers des espaces de travail », puis que vous l’installez de nouveau, le panneau restaure les espaces enregistrés avec leurs fichiers et leurs clés SSH. Il ne crée pas de nouvel espace.

Installer Claude Code

L’agent IA s’installe séparément du module ; vous pouvez choisir un ou plusieurs fournisseurs selon vos préférences. Tant qu’aucun n’est installé, vous ne pouvez pas lancer d’agents dans un espace de travail.

1. Pour l’installer, ouvrez les paramètres depuis le menu à trois points dans l’en-tête de la page — l’entrée « Paramètres du module ».
2. Dans l’onglet « Fournisseurs d’IA », repérez la fiche de Claude Code et cliquez sur « Installer ».

Claude Code s’installe depuis le dépôt signé du fournisseur, ce qui prend en général quelques minutes. Quand l’état passe à « Installé », la fiche affiche la version de l’agent et l’état de la clé.

Clé API commune

L’agent fonctionne avec votre clé API. La clé que vous définissez dans les paramètres du module est dite commune : tous les espaces de travail qui n’ont pas de clé propre l’utilisent. Le premier espace n’a pas de clé propre, c’est donc la clé commune qui lui sert.

1. Sur la fiche de Claude Code, cliquez sur « Ajouter une clé ».
2. Dans la boîte de dialogue « Ajouter une clé API », collez la clé dans le champ « Clé » et cliquez sur « Enregistrer ».

Une fois enregistrée, la clé ne peut plus être consultée : elle est stockée chiffrée sur le serveur. Dans la ligne « Clé API » de la fiche apparaît la valeur « Définie », et le bouton « Ajouter une clé » devient « Remplacer la clé ».

Pour savoir en quoi la clé commune diffère de la clé d’un espace de travail et où obtenir une clé Anthropic, consultez l’article Agents IA. Clés API des fournisseurs.

Clé SSH

La connexion à un espace de travail se fait en SSH, avec authentification par clé. Vous ajoutez la clé publique sur la page de l’espace de travail dans le panneau, tandis que la clé privée reste sur votre ordinateur.

Nous partons du principe que votre ordinateur possède au moins une clé SSH. Si ce n’est pas le cas, créez-en une en suivant l’article Se connecter à un serveur en SSH.

Affichez le contenu du fichier de la clé publique et copiez-le en entier. La clé publique se trouve à côté de la clé privée et se termine par .pub : ~/.ssh/id_ed25519.pub pour une clé ed25519, ou ~/.ssh/id_rsa.pub pour la clé RSA que crée l’article sur la connexion SSH.

cat ~/.ssh/id_ed25519.pub

cat ~/.ssh/id_rsa.pub

‼️ Ne saisissez pas de clé privée dans le panneau

Seule la clé publique s’ajoute dans le panneau — le fichier portant l’extension .pub. Ne communiquez jamais la clé privée — le fichier jumelé sans .pub — et ne la collez nulle part : elle doit rester uniquement sur votre ordinateur.

1. Dans la section « Agents IA », ouvrez la page de l’espace « Principal » : cliquez sur « Accéder à l’espace de travail » ou sur la fiche de l’espace elle-même.
2. Dans la section « Clés SSH », cliquez sur « Ajouter une clé ».
3. Dans la boîte de dialogue « Ajouter une clé SSH », collez la clé publique dans le champ « Clé publique ». Dans le champ « Commentaire », vous pouvez indiquer, par exemple, le nom de l’appareil : cela permet de distinguer plus facilement la clé des autres.
4. Cliquez sur « Ajouter ». Si la clé n’a pas été collée en entier, la notification « Impossible de lire la clé, vérifiez qu’elle a été copiée en entier » apparaît.

Se connecter à l’espace de travail

Sur la page de l’espace de travail, la carte « Commande de connexion » affiche une commande de ce type :

ssh -t aibox-4kq7m2@192.168.1.100 beadmin-aibox-attach

Ici, aibox-4kq7m2 est l’utilisateur système de l’espace de travail, et après le @ figure l’adresse par laquelle vous avez ouvert le panneau.

1. Cliquez sur l’icône de copie à droite de la commande.
2. Ouvrez un terminal sur votre ordinateur, collez la commande et appuyez sur Entrée. À la première connexion, SSH demande s’il faut faire confiance au serveur — saisissez yes.
3. Vous arrivez dans la session tmux nommée dev. Elle s’ouvre dans le répertoire workspace de votre espace de travail.

La commande se connecte à la session déjà en cours, ou en crée une nouvelle s’il n’y en a pas. Tant que l’espace de travail est arrêté, le panneau affiche à la place de la commande l’indication « L’espace de travail est arrêté. Démarrez-le pour vous connecter » : cliquez sur « Démarrer » dans l’en-tête de la page.

Si SSH demande un mot de passe

L’authentification par clé fonctionne lorsque SSH trouve la clé privée associée à la clé publique ajoutée dans le panneau. Si une demande de mot de passe apparaît au lieu de la connexion, c’est que la clé ne se trouve pas dans un fichier standard (~/.ssh/id_ed25519 ou ~/.ssh/id_rsa) et n’a pas été ajoutée à l’agent SSH de votre ordinateur. Ajoutez-la à l’agent avec la commande ssh-add :

ssh-add ~/.ssh/nom_du_fichier_de_cle

Ou indiquez le fichier de clé avec l’option -i :

ssh -i ~/.ssh/nom_du_fichier_de_cle -t aibox-4kq7m2@192.168.1.100 beadmin-aibox-attach

Lancer l’agent

Dans la session tmux, saisissez la commande :

claude

Claude Code démarre. Il fonctionne avec la clé API que vous avez ajoutée dans le panneau.

Revenir à la session

Pour partir sans interrompre l’agent, fermez le terminal ou détachez-vous de la session : appuyez sur Ctrl+B, puis sur D. La session reste sur le serveur, avec les tâches qui y tournent. Pour y revenir, exécutez la même commande de connexion.

⚠️ La commande exit termine la session

Si vous exécutez exit dans le shell de la session, celle-ci se ferme avec tout ce qui y tourne, agent compris. L’espace de travail reste actif, et la connexion suivante ouvre une nouvelle session vide.

Étapes suivantes

• Agents IA. Espaces de travail et accès — création, renommage, démarrage et arrêt des espaces de travail, clés SSH de l’espace, limites et achat d’emplacements.
• Agents IA. Clés API des fournisseurs — clé commune et clé d’un espace de travail, ce qui se passe à leur suppression, où obtenir une clé.
• Agents IA. Gérer le module — paramètres du module, installation et désinstallation d’un fournisseur, mise à jour, réinstallation et désinstallation du module.