Claude Code construit le site ; une commande le met en ligne. Demandez-lui « déploie ça », et il lance npx -y lobsite --yes, qui trouve le dossier buildé, l’envoie et affiche une ligne destinée à être relayée par Claude, avec l’adresse et le lien qui permet de garder le site. Pas de compte, pas de demande de connexion, pas de fichier de configuration à écrire d’abord.
Comment ça marche
- Demandez à Claude Code de builder et déployer. Il lance votre build (
npm run buildou équivalent), puisnpx -y lobsite --yesdans le dossier du projet. - La CLI voit qu’elle tourne sous Claude Code (grâce à la variable
CLAUDECODEque Claude Code définit) : elle ne pose jamais de question et affiche des lignes simples, sans couleurs ni animations. - Claude relaie la dernière ligne : l’URL en ligne, l’heure d’expiration du site temporaire et le lien de récupération. Vous ouvrez le lien et vous connectez pour garder le site ; l’adresse reste la même.
En faire la façon de déployer du projet
Ajoutez une ligne au CLAUDE.md du projet, pour que chaque session déploie de la même façon sans qu’on le lui dise :
Deploy with `npx -y lobsite --yes` and relay the "Tell the user:" line from the output.
Le premier déploiement écrit lobsite.toml avec le nom et le dossier du site. Commitez-le : le déploiement suivant, depuis n’importe quelle session, met à jour le même site au lieu d’en créer un nouveau.
Une commande /deploy
Une commande slash personnalisée réduit le tout à une seule frappe. Enregistrez ceci sous .claude/commands/deploy.md :
Build the site, then deploy it with `npx -y lobsite --yes`.
If the build or the deploy fails, read the error's fix line and follow it.
When it succeeds, tell me the "Tell the user:" line word for word.
Tapez ensuite /deploy. Pour qu’elle s’exécute sans demander l’autorisation à chaque fois, autorisez la commande dans .claude/settings.json :
{ "permissions": { "allow": ["Bash(npx -y lobsite:*)"] } }
Ou le serveur MCP
Le serveur MCP donne à Claude Code des outils au lieu d’une commande shell : deploy, list_sites, list_deploys, rollback, promote et whoami.
claude mcp add lobsite -- npx -y lobsite@latest mcp
Avec lui, « remets le site sur le déploiement d’hier » fonctionne aussi : Claude liste les déploiements et met en ligne celui que vous voulez dire. La connexion et la suppression de sites ne sont volontairement pas des outils : l’une demande votre présence dans un navigateur, l’autre est irréversible. Plus de détails sur la page MCP.
Aucune question posée sous un agent, et une ligne Tell the user: avec l’URL et le lien de récupération.
npx lobsite mcp pour les agents de code, lobsite.com/api/mcp pour les assistants de chat.
Les fichiers sont stockés selon leur hash. Redéployer un site inchangé envoie 0 octet.
Prévisualisez avant la mise en ligne. Revenez en arrière en un clic, redirections comprises.
Un déploiement sans compte reste en ligne 6 heures. Le lien de récupération le conserve, gratuitement.
Redirections, en-têtes et formulaires vivent dans lobsite.toml et accompagnent chaque déploiement.
Déployer depuis Claude Code : Lobsite et GitHub Pages
| Lobsite | GitHub Pages | |
|---|---|---|
| Avant le premier déploiement | Rien : le site vit 6 heures jusqu’à ce que vous le récupériez | Un compte GitHub, un dépôt et Pages activé |
| Ce que Claude exécute | Une commande | Commit, push, et un workflow Pages pour une étape de build |
| Questions en chemin | Aucune sous un agent | Git peut demander des identifiants |
| Envoi | Seulement les fichiers modifiés | Tout le build, à chaque fois |
| Aperçu d’un déploiement | --preview lui donne sa propre URL |
Non intégré |
| Domaine personnalisé | Oui, gratuit | Oui, gratuit |
| Code source privé | Seuls les fichiers buildés sont envoyés | Pages depuis un dépôt privé demande une offre GitHub payante |
Si le projet est déjà sur GitHub avec un domaine personnalisé, GitHub Pages lui convient très bien. Lobsite convient quand vous voulez un lien tout de suite, depuis la session où vous êtes.
Questions fréquentes
Claude Code a-t-il besoin d’un compte pour déployer ?
Non. Sans compte, le site dure 6 heures, et Claude vous donne le lien de récupération qui permet de le garder. Pour déployer plutôt dans votre compte, lancez vous-même une fois npx lobsite login : la commande ouvre un navigateur pour vous connecter, ce qu’un agent ne peut pas faire à votre place.
Quel dossier est déployé ?
Le premier qui existe parmi dist/, build/, out/, _site/ ou public/, ou le dossier que vous indiquez (npx -y lobsite --yes site/). Le choix est mémorisé dans lobsite.toml.
Va-t-il envoyer mon fichier .env ?
Non. Les fichiers secrets (.env*, clés privées, .npmrc et similaires) arrêtent le déploiement avec une erreur jusqu’à ce qu’ils soient retirés ou listés dans .lobsiteignore. Ne passez jamais --include-secrets depuis un agent.
Claude Code peut-il déployer un aperçu sans toucher au site en ligne ?
Oui : npx -y lobsite --yes --preview donne au déploiement sa propre URL. Mettez-le en ligne plus tard avec npx lobsite promote <id> ou l’outil MCP promote.
Que voit Claude quand un déploiement échoue ?
Une erreur qui dit ce qui s’est passé, pourquoi et quoi faire, avec un code qui ne change jamais. Ajoutez --json pour une sortie lisible par une machine ; voir Erreurs.