Google Colab 不只是一个 notebook。借助官方 CLI 工具 google-colab-cli,你可以直接在终端、VS Code 或任何支持 SSH 的编辑器中,打开一台 Colab 机器的 SSH 终端——带不带 GPU 都行。
本文将带你完成:安装 CLI、配置 ~/.ssh/config、首次登录,以及如何连接和断开而不浪费算力单元。
你需要准备什么
- 一个能访问 Colab 的 Google 账号(Google AI Subscription - Plus、Pro 或 Ultra)
- Python 3 以及 uv 或 pip
- OpenSSH(Linux、macOS 和 Windows 10/11 已预装)
- 一把 ed25519 SSH 密钥
1. 安装 Colab CLI
官方包名为 google-colab-cli,安装后会提供 colab 命令。
1uv tool install google-colab-cli2# 或者:pip install google-colab-cli3colab version

2. 准备一把 SSH 密钥
连接时,colab 会把你的公钥发送到机器上。默认情况下,它会查找 ~/.ssh/id_ed25519.pub 或 id_ecdsa.pub。还没有密钥?
1ssh-keygen -t ed25519
用的是其他名字的密钥?没问题:在下一步用 -i 指定路径即可。
3. 把主机添加到 ~/.ssh/config
打开(或创建)~/.ssh/config 文件,粘贴下面这段内容:
1Host colab2 User root3 ProxyCommand colab ssh --proxy-mode -s colab -i ~/.ssh/id_ed25519.pub4 StrictHostKeyChecking no5 UserKnownHostsFile /dev/null

每一行的作用:
- Host colab:别名。配好之后,直接输入
ssh colab就行。 - ProxyCommand:SSH 不再去连某个 IP,而是调用
colab ssh --proxy-mode,由它桥接到 Colab 机器。-s colab是会话名:如果不存在,CLI 会自动创建。 - StrictHostKeyChecking no 和 UserKnownHostsFile /dev/null:每次会话都是一台新机器、一个新主机密钥。不加这两行,SSH 每次连接都会报错。
两个让我踩过坑的地方:
- 如果你的 config 里有 Host \ 这一段,请把 colab 放在它前面。SSH 的规则是“先匹配先生效”:如果 `Host
在上面且包含StrictHostKeyChecking no`,就会覆盖掉 colab 的配置。 - 在 Windows 上,
-i里的密钥要用绝对路径(C:/Users/you/.ssh/id_ed25519.pub)。ProxyCommand 里的~不会被展开。
4. 在真实终端里完成首次登录
第一次使用时,CLI 会请求你的 Google 账号授权:它会显示一个链接,你在浏览器里批准,然后把 Google 显示的代码粘贴回来。
1colab new -s colab

注意: 首次登录一定要在交互式终端里做(PowerShell、Terminal、iTerm)。如果第一次 ssh colab 来自没有键盘的环境,比如 AI Agent、脚本,或者聊天窗口里触发的命令,CLI 就没地方读取验证码,登录会失败并提示 “Malformed auth code”。只要登录信息保存下来,之后在哪连都行。
想要 GPU?创建会话时直接带上:colab new -s colab --gpu T4。也支持 L4、A100 和 H100,还可以加 --high-mem 要更多内存。
5. 连接
1ssh colab

你会以 root 身份进入 /content 目录,系统是 Ubuntu 24.04。截图里这个无 GPU 的会话有 2 个 vCPU、12 GB 内存和大约 226 GB 磁盘。
你也可以不打开 shell,直接执行单条命令:
1ssh colab "nvidia-smi"
而且因为走的是标准 SSH,VS Code(Remote - SSH)、scp、rsync,以及任何支持远程机器的编辑器,都能直接识别 colab 这个主机,无需额外配置。
6. 用完记得关机
只要机器开着,会话就会消耗算力单元,哪怕你什么都没干。用完了?停掉它,然后检查一下:
1colab stop -s colab2colab sessions3colab usage

怕自己忘了关?CLI 提供了 --rm,SSH 断开时会自动停止会话。把它加到 ProxyCommand 里就行:
1ProxyCommand colab ssh --proxy-mode -s colab --rm -i ~/.ssh/id_ed25519.pub
时长与费用
- 不同机型消耗算力单元的速率不同。无 GPU 几乎不耗;T4 大约每小时 1.8,L4 是 4.8,A100 在 11 到 13 之间。数值会变:开机时用
colab usage查一下。 - 会话有时间上限(Pro 最长约 24 小时),空闲太久也会被断开。
- 磁盘是一次性的。 会话结束,所有东西都会消失。提前 git push 或把文件拷出来(scp、rsync 或
colab download),或者用colab drivemount挂载 Google Drive。
值得记住的 CLI 命令
- colab sessions:列出活跃会话
- colab status:查看会话状态
- colab usage:查看余额和消耗速率
- colab upload / colab download:上传和下载文件
- colab drivemount:把 Google Drive 挂载到机器上
- colab stop -s <name>:停止会话
搞定:Colab 现在只是你 ~/.ssh/config 里的又一个主机。一句 ssh colab,你就能登上一台带 GPU 的 Linux 机器,只为开机时间付费。





