Collaborateurs

Avec Claude Code : SSH

Claude Code publie depuis votre terminal, par SSH, avec la clé de votre poste. Il vous faut Claude Code, une clé SSH enregistrée, un alias et le skill spaces-adalan.

Installer Claude Code

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

irm https://claude.ai/install.ps1 | iex

Homebrew (brew install --cask claude-code) et WinGet (winget install Anthropic.ClaudeCode) conviennent aussi. Vérifiez ensuite l’installation, puis lancez claude dans un dossier de travail et connectez-vous avec votre compte Claude :

claude --version
claude doctor

Sous Windows, installez Git for Windows

Claude Code s’appuie alors sur Git Bash. C’est indispensable ici : les fichiers partent vers le serveur dans un flux binaire que PowerShell 5 abîme.

Le guide officiel d’installation : code.claude.com/docs/en/setup.

Votre clé SSH

Le serveur reconnaît votre poste à sa clé SSH. Affichez la vôtre, ou créez-la si la première commande ne trouve rien :

cat ~/.ssh/id_ed25519.pub
ssh-keygen -t ed25519 -C "prenom.nom@adalan.fr"

Envoyez la ligne qui commence par ssh-ed25519 à l’administrateur de la plateforme, qui l’enregistre sur votre Space. La clé privée, sans .pub, ne quitte jamais votre poste.

Déclarer l’alias SSH

Ajoutez ce bloc à la fin de ~/.ssh/config (sous Windows : C:\Users\vous\.ssh\config), avec votre Space :

Host adalan
    HostName spaces.adalan.ai
    User durand

Si la clé enregistrée n’est pas la clé par défaut du poste, ajoutez la ligne IdentityFile ~/.ssh/ma-cle au bloc. Toutes les commandes de cette documentation passent par cet alias : ssh adalan adalan ….

Première connexion : vérifier le serveur

ssh adalan adalan info

La première fois, SSH affiche l’empreinte du serveur et demande de la confirmer. Elle doit être exactement :

SHA256:jLMY1zS8q+eKRyTEH6qXkBA1c3enagOQLNSmrrXbIfU

Si elle correspond, répondez yes. La commande affiche alors votre Space :

Space       durand (Jean Durand)
Adresse     https://spaces.adalan.ai/durand/
Sites       https://spaces.adalan.ai/durand/<projet>/
Disque      0,0 Go utilisés sur 5,0 Go
Accès SSH   durand@spaces.adalan.ai

Message	Cause et solution
`Could not resolve hostname adalan`	L’alias manque ou est mal écrit dans `~/.ssh/config`.
`Permission denied (publickey)`	La clé du poste n’est pas enregistrée, ou ce n’est pas la bonne : vérifiez `IdentityFile`, sinon renvoyez la clé publique à l’administrateur. Si tout fonctionnait jusque-là, votre Space a peut-être été désactivé : voyez l’administrateur.
`REMOTE HOST IDENTIFICATION HAS CHANGED`	L’empreinte a changé. N’allez pas plus loin et prévenez l’administrateur.

Ce compte n’ouvre pas de terminal sur le serveur : il n’accepte que les commandes adalan. Pas de shell, pas de scp ni de rsync : les fichiers partent dans une archive tar, par le flux SSH.

Le skill spaces-adalan

Le skill donne à Claude Code le parcours de publication : nom du projet, vérifications avant envoi (secrets, données, liens relatifs), commande d’envoi, contrôle, compte rendu. Quand l’organisation adalan le fournit dans claude.ai, Claude Code le charge de lui-même si vous êtes connecté avec votre compte Claude : tapez /skills ; s’il figure dans la liste, rien à installer. Sinon, installez-le dans vos skills personnels :

mkdir -p ~/.claude/skills/spaces-adalan
curl -fsSL https://spaces.adalan.ai/docs/telechargements/spaces-adalan/SKILL.md \
  -o ~/.claude/skills/spaces-adalan/SKILL.md

Claude Code le prend en compte sans redémarrage ; tapez /skills pour le voir dans la liste, sinon relancez Claude Code. Relancez la même commande pour le mettre à jour quand la plateforme évolue. Le fichier est aussi téléchargeable ici.

Si vous aviez installé l’ancien skill deploiement-adalan, retirez-le, spaces-adalan le remplace :

rm -r ~/.claude/skills/deploiement-adalan

Publier depuis Claude Code

Demandez-le simplement, depuis le dossier du projet :

« Publie ce dossier sur ma plateforme adalan sous le nom offre-rh » ;
« Construis le projet et publie-le sur adalan sous le nom demo-vite, protégé par mot de passe » ;
« Publie cette application sur adalan sous le nom agent-rh, avec une base de données ».

Claude vérifie le dossier, construit si besoin, puis envoie l’archive :

COPYFILE_DISABLE=1 tar -czf - -C dist . | ssh adalan adalan deploy demo-vite --json

Vous pouvez lancer ces commandes vous-même : elles sont toutes dans la référence des commandes. Les règles de publication sont dans Publier un site et Publier une application.

Plusieurs postes, poste perdu

Un second ordinateur : créez une clé sur ce poste et envoyez sa clé publique à l’administrateur ; les deux clés restent valables.
Poste perdu ou volé : prévenez l’administrateur sans délai. Il révoque la clé de ce poste ; les sessions ouvertes avec elle sont coupées.