Claude Code est l'un des assistants de codage IA les plus puissants disponibles aujourd'hui, mais l'utiliser depuis une fenêtre console locale a de vraies limites : tu es lié à la machine où il est installé, tu ne peux pas y accéder depuis ton téléphone et il n'y a pas de moyen simple de partager une session avec un collègue.
sgcClaudeCodeRemote résout tout cela. C'est un serveur Windows léger qui encapsule Claude Code dans un terminal web, te permettant de te connecter depuis n'importe quel navigateur — sur ton ordinateur de bureau, portable, tablette ou téléphone. Sous le capot, il utilise l'API pseudo-console Windows ConPTY pour une vraie session terminal, et sgcWebSockets pour streamer les I/O du terminal vers le navigateur en temps réel.
Cet article couvre les fonctionnalités, les options de configuration et les avantages par rapport à l'exécution directe de Claude Code depuis la console.
Pourquoi utiliser Claude Code à distance ?
sgcClaudeCodeRemote adresse les points de friction les plus courants que rencontrent les développeurs quand ils travaillent avec Claude Code en console.
|
Accès depuis n'importe quel appareil Ouvre un navigateur sur ton téléphone, tablette ou portable et connecte-toi à Claude Code qui tourne sur ta machine de développement. Pas de Node.js, pas d'installation CLI — juste une URL. |
Sessions collaboratives Plusieurs développeurs peuvent rejoindre la même session nommée et voir la sortie de Claude en temps réel. Pair programming intégré — pas besoin d'outils de partage d'écran. |
Sécurisé par défaut Authentification par mot de passe avec protection contre le brute-force, timeouts configurables, blocage d'IP et chiffrement TLS 1.3 optionnel pour les déploiements exposés sur Internet. |
Terminal adapté au mobile
L'interface web est conçue pour fonctionner sur les appareils mobiles. Une barre d'outils de touches optimisée tactile en bas de l'écran fournit les touches spéciales dont Claude Code a besoin mais qui manquent aux claviers mobiles :
| Bouton | Fonction |
|---|---|
| Esc | Annuler l'opération en cours ou revenir en arrière |
| Tab | Accepter les suggestions et l'autocomplétion |
| Intro | Confirmer l'entrée (touche Entrée) |
| Ctrl | Modificateur sticky — appuie une fois, puis appuie sur une lettre pour les combos comme Ctrl+C (interrupt) |
| ↑ ↓ ← → | Naviguer dans l'historique des commandes et les menus |
La barre d'outils utilise les événements pointerdown pour une réponse instantanée sur les écrans tactiles et empêche le vol de focus pour que le terminal reste actif. Le viewport s'adapte au chrome du navigateur mobile en utilisant les unités de viewport dynamiques (dvh), garantissant que la barre d'outils est toujours visible sans scroller.
Sessions nommées
Chaque connexion peut spécifier un nom de session (par ex. « backend-refactor », « devops », « testing »). Les sessions persistent pendant la durée de vie du serveur, donc tu peux te déconnecter et te reconnecter plus tard à la même instance Claude Code.
- Sessions multi-clients. Plusieurs navigateurs peuvent rejoindre la même session simultanément — tout le monde voit la même sortie de terminal et peut taper dans la même console.
- Historique des sessions. Le navigateur mémorise tes 10 sessions les plus récentes dans localStorage, avec un menu déroulant pour te reconnecter rapidement.
- Indicateur de session. Le nom de la session active est affiché dans la barre d'en-tête après authentification.
Authentification et sécurité
sgcClaudeCodeRemote inclut plusieurs couches de protection prêtes à l'emploi :
|
Authentification par mot de passe Un seul mot de passe partagé protège l'accès. Aucun nom d'utilisateur n'est requis — juste le mot de passe. Le formulaire de connexion désactive l'autocomplétion des identifiants par le navigateur pour éviter un stockage accidentel. |
Protection contre le brute-force Après 5 tentatives échouées depuis la même IP, cette adresse est bloquée pendant 5 minutes. Les IPs bloquées sont rejetées au niveau de la connexion avant tout traitement ultérieur. |
|
Timeout d'authentification Les clients doivent s'authentifier dans une fenêtre configurable (par défaut 15 secondes). Les connexions inactives qui n'envoient pas d'identifiants sont déconnectées automatiquement. |
Chiffrement TLS 1.3 Pour les déploiements exposés sur Internet, active TLS avec un fichier de certificat et de clé. Tout le trafic entre le navigateur et le serveur est chiffré de bout en bout. |
Sauter les prompts de permission. Une case à cocher sur l'écran de connexion (cochée par défaut) lance Claude Code avec le drapeau --dangerously-skip-permissions. C'est essentiel pour les sessions distantes où tu ne peux pas interagir avec les dialogues de permission sur la console du serveur.
sgcClaudeCodeRemote vs Claude Code en console
Comparaison côte à côte entre l'exécution locale de Claude Code et via sgcClaudeCodeRemote.
| Fonctionnalité | Console | sgcClaudeCodeRemote |
|---|---|---|
| Accès depuis n'importe quel appareil | Non | Oui |
| Prise en charge mobile / tablette | No | Oui (barre d'outils tactile) |
| Plusieurs utilisateurs sur la même session | No | Yes |
| Sessions nommées persistantes | No | Yes |
| Protection par mot de passe | No | Oui (blocage brute-force) |
| Chiffrement TLS | N/A | TLS 1.3 |
| Logiciel client requis | Node.js + CLI | Juste un navigateur |
| Pair programming | Outils externes | Intégré |
| Affichage de la latence en temps réel | No | Yes |
| Plateformes client | Même machine uniquement | Windows, macOS, Linux, Android, iOS |
Premiers pas
Télécharge sgcClaudeCodeRemote et exécute-le depuis la ligne de commande avec un mot de passe :
sgcClaudeCodeRemote.exe --password MySecretPasswordPuis ouvre ton navigateur et va sur http://your-server-ip:8765/. Saisis le mot de passe, choisis un nom de session et tu es connecté.
Exemples
Port personnalisé avec une limite de connexions plus élevée :
sgcClaudeCodeRemote.exe --port 9000 --password MyPass --max-conn 20Avec chiffrement TLS pour un accès sécurisé sur Internet :
sgcClaudeCodeRemote.exe --tls --tls-cert cert.pem --tls-key key.pem --password MyPassOptions de ligne de commande
| Option | Description | Défaut |
|---|---|---|
--port |
Port d'écoute du serveur | 8765 |
--password |
Mot de passe d'accès (requis quand l'authentification est activée) | — |
--command |
Commande à exécuter dans le terminal | claude |
--cols / --rows |
Dimensions initiales du terminal | 120 × 40 |
--max-conn |
Connexions concurrentes maximum | 10 |
--timeout |
Timeout d'authentification en secondes | 15 |
--no-auth |
Désactiver entièrement l'authentification | — |
--tls |
Activer le chiffrement TLS 1.3 | — |
--tls-cert / --tls-key |
Fichiers PEM du certificat et de la clé privée | — |
--tls-password |
Mot de passe de la clé privée (si chiffrée) | — |
--tls-port |
Port d'écoute TLS | Identique à --port |
Cas d'usage
- Travaille depuis ton téléphone. Revue de code, pose des questions à Claude ou exécute des commandes depuis n'importe où — le canapé, le train ou un café.
- Collaboration d'équipe. Plusieurs développeurs se connectent à la même session et interagissent avec Claude en temps réel. Pas besoin de partage d'écran.
- Serveurs de build headless. Exécute Claude Code sur une machine distante puissante et accède-y depuis un client léger ou un environnement sans terminal.
- Démos et présentations. Partage une URL de session avec ton audience. Tout le monde voit le même terminal en direct et suit.
- Accès distant sécurisé. Active TLS, définis un mot de passe fort et utilise Claude Code en toute sécurité sur Internet depuis n'importe où.
Comment ça fonctionne
sgcClaudeCodeRemote est une application console Delphi construite sur trois technologies de base :
|
Windows ConPTY L'API pseudo-console Windows 10 crée une vraie session terminal avec la prise en charge complète des séquences VT100/ANSI. Claude Code tourne dans cette console exactement comme il le ferait dans une fenêtre de terminal normale. |
sgcWebSockets La bibliothèque sgcWebSockets gère toute la communication WebSocket, le service HTTP et le chiffrement TLS optionnel. Les trames binaires transportent la sortie du terminal ; les trames texte JSON gèrent l'authentification et les messages de contrôle. |
xterm.js Le navigateur rend le terminal avec xterm.js, en utilisant l'addon fit (redimensionnement auto à la fenêtre) et l'addon web-links (URLs cliquables). Le thème sombre correspond à l'esthétique de Claude Code. |
Configuration système requise. Le serveur nécessite Windows 10 version 1809 ou ultérieure (pour la prise en charge ConPTY) et Claude Code installé sur la machine hôte. Les clients n'ont besoin que d'un navigateur web moderne.
Fonctionnalités de l'interface web
L'UI web mono-page est intégrée directement dans l'exécutable — pas de fichiers externes à déployer. Elle inclut :
- Indicateur de statut. Badge codé par couleur (vert = connecté, rouge = déconnecté, bleu = login requis, ambre = connexion en cours) avec une animation pulse.
- Latence en temps réel. Affiche la latence aller-retour en millisecondes, mise à jour à chaque trame.
- Dimensions du terminal. Affiche les colonnes × lignes actuelles et se met à jour dynamiquement au redimensionnement.
- Bouton Fit. Redimensionne instantanément le terminal pour remplir la fenêtre du navigateur.
- Copier-coller. Prise en charge complète du presse-papiers — Ctrl+C copie le texte sélectionné, Ctrl+V colle dans le terminal.
- Reconnexion automatique. Si la connexion tombe, le client tente automatiquement de se reconnecter après 3 secondes.
- Scrollback de 10 000 lignes. Défile vers le haut pour revoir la sortie précédente de Claude Code sans perdre d'historique.
sgcClaudeCodeRemote est construit avec sgcWebSockets — des composants WebSocket haute performance pour Delphi et .NET.