Google Colab n'est pas qu'un simple notebook. Avec la CLI officielle de Google, google-colab-cli, vous pouvez ouvrir un terminal SSH sur une machine Colab, avec ou sans GPU, directement depuis votre terminal, VS Code ou tout éditeur compatible SSH.
Dans cet article : installer la CLI, configurer ~/.ssh/config, effectuer la première connexion, et se connecter/déconnecter sans gaspiller d'unités de calcul.
Ce dont vous avez besoin
- Un compte Google avec accès à Colab (abonnement Google AI - Plus, Pro ou Ultra)
- Python 3 avec uv ou pip
- OpenSSH, préinstallé sur Linux, macOS et Windows 10/11
- Une clé SSH ed25519
1. Installer la CLI Colab
Le package officiel s'appelle google-colab-cli et installe la commande colab.
1uv tool install google-colab-cli2# ou : pip install google-colab-cli3colab version

2. Avoir une clé SSH
Lors de la connexion, colab envoie votre clé publique à la machine. Par défaut, il cherche ~/.ssh/id_ed25519.pub ou id_ecdsa.pub. Vous n'en avez pas encore ?
1ssh-keygen -t ed25519
Vous utilisez une clé portant un nom différent ? Aucun problème : vous la pointerez à l'étape suivante avec -i.
3. Ajouter l'hôte dans ~/.ssh/config
Ouvrez (ou créez) le fichier ~/.ssh/config et collez ce bloc :
1Host colab2 User root3 ProxyCommand colab ssh --proxy-mode -s colab -i ~/.ssh/id_ed25519.pub4 StrictHostKeyChecking no5 UserKnownHostsFile /dev/null

Voici le rôle de chaque ligne :
- Host colab : Le surnom. Ensuite, il suffit de taper
ssh colab. - ProxyCommand : Au lieu d'ouvrir une connexion vers une IP, SSH s'adresse à
colab ssh --proxy-mode, qui sert de pont vers la machine Colab. L'option-s colabest le nom de la session : si elle n'existe pas, la CLI la crée. - StrictHostKeyChecking no et UserKnownHostsFile /dev/null : Chaque session est une nouvelle machine avec une nouvelle clé d'hôte. Sans cela, SSH se plaint à chaque connexion.
Deux pièges qui m'ont fait perdre du temps :
- Si votre configuration contient un bloc Host \, placez colab avant celui-ci. En SSH, c'est la première valeur trouvée qui compte : un `StrictHostKeyChecking no` placé sous `Host ` plus haut écrasera celui de colab.
- Sous Windows, utilisez le chemin absolu de la clé dans
-i(C:/Users/vous/.ssh/id_ed25519.pub). Le~à l'intérieur de ProxyCommand n'est pas développé.
4. Effectuer la première connexion dans un vrai terminal
La première fois, la CLI demande l'autorisation de votre compte Google : elle affiche un lien, vous l'approuvez dans le navigateur, puis vous collez le code affiché par Google.
1colab new -s colab

Attention : Faites cette première connexion dans un terminal interactif (PowerShell, Terminal, iTerm). Si le premier ssh colab provient d'un outil sans clavier, comme un agent IA, un script ou une commande déclenchée depuis un chat, la CLI n'a aucun endroit où lire le code et la connexion échoue avec « Malformed auth code ». Une fois la connexion enregistrée, tout fonctionne partout.
Vous voulez un GPU ? Créez directement la session avec : colab new -s colab --gpu T4. Les modèles L4, A100 et H100 sont aussi acceptés, ainsi que --high-mem pour plus de RAM.
5. Se connecter
1ssh colab

Vous arrivez en tant que root dans /content, sous Ubuntu 24.04. La session sans GPU de la capture d'écran dispose de 2 vCPU, 12 Go de RAM et environ 226 Go de disque.
Vous pouvez aussi exécuter une seule commande sans ouvrir le shell :
1ssh colab "nvidia-smi"
Et comme il s'agit de SSH standard, VS Code (Remote - SSH), scp, rsync et tout éditeur prenant en charge les machines distantes voient l'hôte colab sans configuration supplémentaire.
6. Éteindre une fois terminé
La session consomme des unités de calcul tant qu'elle est allumée, même au repos. Vous avez fini ? Arrêtez-la et vérifiez :
1colab stop -s colab2colab sessions3colab usage

Pour ne pas avoir à y penser, la CLI propose --rm, qui arrête la session lorsque SSH se ferme. Ajoutez-le simplement au ProxyCommand :
1ProxyCommand colab ssh --proxy-mode -s colab --rm -i ~/.ssh/id_ed25519.pub
Durée et coût
- Chaque type de machine consomme des unités à son propre rythme. Sans GPU, c'est presque rien ; le T4 tourne autour de 1,8 par heure, le L4 à 4,8 et l'A100 entre 11 et 13. Ces valeurs changent : vérifiez avec
colab usagependant que la session est active. - Les sessions ont une durée maximale (jusqu'à environ 24 h sur Pro) et se coupent en cas d'inactivité.
- Le disque est éphémère. Quand la session se termine, tout disparaît. Faites un git push ou copiez vos fichiers avant (scp, rsync ou
colab download), ou montez Google Drive aveccolab drivemount.
Les commandes CLI à mémoriser
- colab sessions : Liste les sessions actives
- colab status : État de la session
- colab usage : Solde et taux de consommation
- colab upload / colab download : Envoyer et récupérer des fichiers
- colab drivemount : Monte Google Drive sur la machine
- colab stop -s <nom> : Arrête la session
C'est fait : Colab devient un hôte comme un autre dans votre ~/.ssh/config. Un simple ssh colab et vous voilà sur une machine Linux avec GPU, en ne payant que le temps où elle reste allumée.





