Google Colab 不只是一本 notebook。透過官方的 Google CLI google-colab-cli,你可以直接從終端機、VS Code 或任何支援 SSH 的編輯器,在 Colab 機器上開啟 SSH 終端機,無論有沒有 GPU 都行。
這篇文章會教你:安裝 CLI、設定 ~/.ssh/config、完成首次登入,以及如何連線與斷線才不會浪費運算單位。
你需要準備什麼
- 一個能使用 Colab 的 Google 帳號(Google AI 訂閱方案: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. 把 Host 加進 ~/.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 身分進入 Ubuntu 24.04 的 /content 目錄。截圖中這個無 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 機器,而且只在開機期間才需要付費。





