用途：通过 colab CLI 操作 Google Colab 环境，包括申请 GPU/TPU 会话、在远程 VM 上执行 Python/shell、同步文件，以及把会话历史导出为 notebook。
安装：uv tool install google-colab-cli 或 pip install google-colab-cli。
主要能力：colab new -s <name> 创建会话（--gpu 支持 T4、L4、G4、H100、A100；--tpu 支持 v5e1、v6e1）；colab exec -s <name> -f script.py 在远程执行本地脚本，也支持管道输入与 .ipynb；colab run 一次性完成创建、执行、销毁；colab install 安装依赖；colab sessions/status/log 查看状态与日志；colab log -o summary.ipynb 导出 notebook；colab url 将网页 UI 接入已有会话。
使用方式：全局认证标志 --auth={adc,oauth2} 需放在子命令前，默认 adc。ADC 需用 gcloud auth application-default login 重新签发，并包含 openid、cloud-platform、userinfo.email、colaboratory 四个 scope。同一会话的 kernel 状态在多次 exec/repl 间保持，默认工作目录为 /content。
限制：加速器受账户层级限制，多数账户只能获得 CPU；无法识别的 --gpu 值会静默回退到 A100。colab repl、console、auth、drivemount 需要 TTY，不适合由智能体交互式运行。colab auth 是向 VM 注入 GCP 凭据，与 CLI 自身认证无关。用完应执行 colab stop，避免空闲 VM 消耗计算单元。