---
title: "Colab CLIの使い方｜インストール・GPU指定・colab runとWindows対応状況【v0.7.4】"
url: "https://www.issoh.co.jp/tech/details/12438/"
published: 2026-06-10
updated: 2026-10-19
categories: ["AI"]
publisher: "株式会社一創"
---

# Colab CLIの使い方｜インストール・GPU指定・colab runとWindows対応状況【v0.7.4】

Colab CLIは、Google Colabのランタイム（クラウド上のVM）をブラウザを開かずにターミナルから確保・実行・解放するための公式ツールです。Googleは2026年6月5日に[Developers Blog](https://developers.googleblog.com/introducing-the-google-colab-cli/)で公開を告知し、2026年10月19日時点の最新版は[PyPIの0.7.4](https://pypi.org/project/google-colab-cli/)（2026年9月26日公開）です。公開後には、SSH接続の`colab ssh`、残高確認の`colab usage`が加わり、対話的なリモート開発や利用残高の確認にも対応しました。この記事では、macOS（x86\_64）・Python 3.12に0.7.4を導入し、`--help`、認証開始画面、実行前チェック、ソースコードを確認した範囲で、導入と認証、GPU・TPUの指定、実行コマンドの使い分け、実行履歴の扱い、Windowsで動かない理由までを順に説明します。GPU・TPUの確保と課金の挙動は実測しておらず、公式資料に基づきます。

## まとめ：Colab CLIの要点（v0.7.4時点）

- 提供元はGoogle Colabチーム（GitHubの`googlecolab/google-colab-cli`）で、ライセンスはApache-2.0。PyPIのパッケージ名は`google-colab-cli`、コマンド名は`colab`です。
- 導入は`uv tool install google-colab-cli`（推奨）か`pip install google-colab-cli`。Python 3.12以上が必要です。
- 公式の対応OSはLinuxとmacOSだけです。Windowsでは0.7.4の時点で`colab --help`すら起動せず、修正はGitHubのmainに入ったものの未リリースです。
- 基本の流れは`colab new`（確保）→`colab exec`（実行）→`colab stop`（解放）。1回きりの処理なら`colab run`がこの3つを1コマンドで行い、既定では終了時にVMの解放を試みます。ただし、通信障害などによる解放失敗はあり得ます。
- GPUは`--gpu`でT4・L4・G4・H100・A100、TPUは`--tpu`でv5e1・v6e1を指定します。使えるかどうかはColabの契約プラン次第です。
- 認証の既定値は0.7.4の実装では`oauth2`（URLを開いて認可コードを貼る方式）です。READMEは`adc`と書いており、記述と実装がずれています。
- 実行したコードは手元の`~/.config/colab-cli/history/`に記録され、`colab log -s 名前 -o log.ipynb`でノートブックに書き出せます。`-s`を省くと書き出されません。`--env`で渡したトークンも平文で残ります。
- AIエージェントから使う前提で、使い方を説明するスキルファイルが同梱されています（`colab skill`で出力）。

## Colab CLIの提供元と、ノートブックUIとの役割の違い

[GitHubのリポジトリ](https://github.com/googlecolab/google-colab-cli)の作成日は2026年4月17日、PyPIへの初回公開は5月22日の0.5.4で、Googleは6月5日にDevelopers Blogで公式に告知しました。告知記事の著者はGoogle ColabのプロダクトマネージャーSpencer Shumway氏とエンジニア2名で、開発者だけでなく「ターミナルを操作できるAIエージェント」に計算資源を渡すことを目的に掲げています。記事中のデモでは、AntigravityのエージェントがT4 GPUを確保し、Gemma 3 1BをQLoRAでファインチューニングし、アダプタを回収してVMを止めるまでをCLIだけで実行しています。Claude CodeやCodexからも同じように使えると明記されています。

ノートブックUIとの違いは、コードの置き場所です。ノートブックではセルにコードを書いてブラウザ上で実行しますが、CLIではローカルのエディタで書いた`.py`や`.ipynb`をそのままVMのカーネルへ送ります。`colab exec -f train.py`はファイルをローカルで読んで中身を送信するので、事前のアップロードは不要です。手元の編集がそのまま次の実行に反映され、Gitの管理下にあるコードをColabのGPUで動かす使い方に向いています。グラフを見ながら試行錯誤する探索的な作業はノートブックUIのほうが速く、`colab url --open`で確保済みのセッションをブラウザのColabに接続して切り替えられます。

### 同名の非公式colab-cliとcolab-xtermとの違い

「colab-cli」で検索すると、公式とは別の[MurphyLo/colab-cli](https://github.com/MurphyLo/colab-cli)も見つかります。2026年3月19日に作られた個人のリポジトリで、TypeScriptで書かれ、Node.js 22以上が必要です。npmには公開されておらず、ソースを取得して`npm link`で入れます。サブコマンドは`colab runtime`・`colab shell`・`colab port-forward`などで、公式とは体系が違います。コマンド名はどちらも`colab`なので、両方を入れるとPATHの先にある方だけが動きます。2026年10月19日時点でLICENSEファイルが無く、業務で使うなら公式の`google-colab-cli`を選んでください。公式の旧リポジトリ名`googlecolab/colab-cli`は現在404です。

`colab-xterm`は、InfuseAIの非公式拡張で、ノートブックの中にターミナル画面を開くものです（PyPIの最終版は2023年7月の0.2.0）。ローカルからColabを操作するColab CLIとは向きが逆です。

## Colab CLIのインストールと初回認証の手順

### uvまたはpipでの導入とPython 3.12以上の要件

パッケージは`pyproject.toml`で`requires-python = ">=3.12"`と指定されており、3.11以前のPythonでは入りません。公式READMEはuvでのインストールを推奨しています。uvの`tool install`は専用の仮想環境に入れて`colab`コマンドだけをPATHに出すので、プロジェクトの依存と混ざりません。uvそのものの開発元の動向は[OpenAIのAstral買収とuvの現状](/tech/details/11465/)で整理しています。

```
# uvで導入（推奨）
uv tool install google-colab-cli

# pipで導入する場合
pip install google-colab-cli

# 導入した版を確認
colab version
# Version: 0.7.4
```

更新は`colab update`で新しい版の有無を確認し、`colab update --install`でその場で上げられます。uvで入れた場合は`uv tool upgrade google-colab-cli`でも構いません。

### oauth2とADCの2つの認証方式と既定値のずれ

認証情報が未保存の場合、最初にColabのAPIへ接続するコマンドを実行すると、Googleアカウントでの認可を求められます。認証方式はグローバルオプション`--auth`で選び、選択肢は`oauth2`と`adc`（Application Default Credentials）の2つです。

注意したいのは既定値です。READMEと同梱のSKILL.mdは「既定は`adc`」と書いていますが、0.7.4の`colab --help`は`[default: oauth2]`と表示し、ソースの`cli.py`も`AuthProvider.OAUTH2`を既定にしています。GitHubのmainブランチでも同じです。オプションを付けずに実行すると、次のように認可用URLが表示され、ブラウザで承認したあとに出る認可コードを貼り付ける流れになります。

```
$ colab sessions
To authorize colab-cli, visit this URL in any browser:

  https://accounts.google.com/o/oauth2/auth?response_type=code&...

After approving, Google will display an authorization code.
Enter the authorization code:
```

この方式は0.6.0（2026年6月16日）で、ローカルにコールバック用サーバーを立てる方式から切り替わりました。URLを別の端末のブラウザで開けばよいので、SSH先のLinuxサーバーやコンテナの中でも認証できます。取得したトークンは`~/.config/colab-cli/token.json`に保存され、2回目以降は聞かれません。

AIエージェントやCIで対話を避けるには、人が事前に認可して用意したADCを使う方法があります。ADCはColabのバックエンドが要求するスコープを含めて発行する必要があり、同梱のSKILL.mdは次の4スコープを指定しています。この`gcloud`コマンド自体はブラウザでの認可を伴うので、人が1回実行しておく準備手順です。発行後は`colab --auth=adc new`のように、サブコマンドの前に`--auth`を置きます。

```
gcloud auth application-default login \
  --scopes=openid,https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/colaboratory

colab --auth=adc sessions
```

なお`colab auth`というサブコマンドは、CLIのログインとは別物です。VM上のPythonコードがBigQueryやCloud Storageを呼べるように、VM側へGCPの認証情報を渡すためのものです。CLIが401や403で止まったときに`colab auth`を打っても直りません。

### 設定ファイルとセッション情報の保存場所

CLIはローカルに次のファイルを作ります。確保中のVMへ接続するためのトークンを含むので、共有フォルダやリポジトリに置かないでください。

| パス                                  | 中身                   |
| ----------------------------------- | -------------------- |
| `~/.config/colab-cli/token.json`    | oauth2で取得したトークン      |
| `~/.config/colab-cli/sessions.json` | セッション名と接続用トークン       |
| `~/.config/colab-cli/settings.json` | CLI全体の設定             |
| `~/.colab-cli-oauth-config.json`    | 独自のOAuthクライアント設定（任意） |

セッション情報の置き場所はグローバルオプション`--config`で変えられます。案件ごとにセッション情報を分ける場合は、`--config`で別ファイルを指定します。ただし、Googleアカウントの認証情報はこの指定では分離されません。

## WindowsでColab CLIが起動しない原因と回避策

READMEは「現時点で対応しているのはLinuxとmacOSのみ」と明記しています。実際、Windowsに0.7.4を入れるとインストール自体は通りますが、`colab --help`を含むすべてのコマンドが`ModuleNotFoundError: No module named 'termios'`で落ちます。原因は、対話コンソール用の`console.py`がUnix専用の`termios`モジュールを無条件に読み込んでおり、起動時の読み込み経路にこのファイルが入っていることです。2026年7月13日に0.6.0での同じ現象が[Issue #78](https://github.com/googlecolab/google-colab-cli/issues/78)として報告され、10月19日時点でもopenのままです。

修正は2026年10月6日（UTC）に[PR #135](https://github.com/googlecolab/google-colab-cli/pull/135)としてmainブランチに取り込まれました。`termios`が無い環境では行単位の入力に切り替え、`colab drivemount`の認可入力も`/dev/tty`が無ければ標準入力から読むようにする内容です。続いて10月13日には[PR #158](https://github.com/googlecolab/google-colab-cli/pull/158)が入りました。Windowsでは`select()`がソケットにしか使えず、`colab ssh --proxy-mode`が標準入力を読めないままsshが固まる不具合を直すものです。PR本文には、Windows 11とPython 3.12でsshのテストが通ったと書かれています。ただし2026年10月19日時点のPyPIの最新版は0.7.4のままで、どちらの修正も含まれていません。READMEの「Windows非対応」の記載も変わっていません。

Windowsで今すぐ使うなら、WSL2のLinux（Ubuntu等）の中にuvとColab CLIを入れるのが現実的です。公式ドキュメントにWSLへの言及は無いものの、CLIから見ればLinux環境です。oauth2の認可URLはWindows側のブラウザで開いて、コードをWSLのターミナルに貼れば通ります。Windowsネイティブ環境で修正版を待つ場合は、PyPIのリリース履歴を確認してください。0.7.4では起動時にエラーになるため、`colab update`も実行できません。

## colab newでのGPU・TPUの指定と使えるランタイム

### –gpuと–tpuに指定できる値とプランの関係

`colab new`は、オプションを付けなければCPUのランタイムを確保します。アクセラレータは`--gpu`か`--tpu`で指定し、`-s`でセッション名を付けます。0.7.4の`--help`に載っている値は次のとおりです。

| 指定      | 値                          | –high-mem |
| ------- | -------------------------- | --------- |
| 省略      | CPU                        | 使える       |
| `--gpu` | T4 / L4 / G4 / H100 / A100 | L4以外で使える  |
| `--tpu` | v5e1 / v6e1                | 無視される     |

`--help`には「利用可否はColabの契約プランによる」と書かれています。同梱のSKILL.mdはさらに踏み込んで「多くのアカウントはCPUしか確保できない。GPUやTPUが割り当たる前提で組まない」と注意しています。割り当てに失敗するとHTTP 412が返り、0.7.0以降はトレースバックではなく読める形のエラーメッセージになりました。確保の応答が遅いと、バックエンド側ではVMができているのにCLIが読み取りタイムアウトで失敗することがあり、10月14日にmainへ入った[PR #172](https://github.com/googlecolab/google-colab-cli/pull/172)で環境変数`COLAB_CLI_REQUEST_TIMEOUT`（HTTPのタイムアウト）と`COLAB_CLI_ASSIGN_RETRIES`（再試行回数・既定3）が加わりました。0.7.4には含まれないため、PyPIから入れた版ではこの変数は効きません。設計文書にはTPU v2-8の値も載っていますが、0.7.4の`--tpu`が受け付けるのはv5e1とv6e1だけです。TPUの世代ごとの違いは[TPUとは？GPU・CPUとの違いと世代別の性能](/tech/details/10447/)で解説しています。

```
# CPU
colab new -s cpu1

# GPU（T4）
colab new -s trainer --gpu T4

# TPU v6e1
colab new -s tpu1 --tpu v6e1

# A100をハイメモリ構成で（Pro・Pro+が必要）
colab new -s big --gpu A100 --high-mem
```

### 対応外の–gpuの値がA100扱いになる落とし穴

0.7.4のソース（`commands/session.py`）は、`--gpu`の値を小文字にして対応表から引き、見つからなければA100を既定値として使います。`--gpu t4`のような大文字小文字の違いは吸収されますが、`--gpu V100`や`--gpu 4090`のように対応外の値を渡すと、エラーにならずにA100を要求します。無料枠ではA100は割り当たらないので、次の段階で412エラーになり、原因が綴りだと気付きにくくなります。`--tpu`も同じで、`v5e1`以外の値はすべてv6e1として扱われます。スクリプトに書く値は上の表のものに限ってください。

### セッションの確認・切り替え・停止

確保したセッションは`colab sessions`で一覧し、`colab status`でハードウェアやマシン構成を確認します。セッションが1つしか無ければ、以降のコマンドで`-s`を省略できます。複数持つと省略できなくなるため、SKILL.mdは「常に`-s`で名前を付ける」ことを勧めています。

```
colab sessions           # 確保中のセッション一覧
colab status -s trainer  # GPU種別やマシン構成
colab restart-kernel -s trainer
colab stop -s trainer    # VMを解放
```

0.7.4では、CLIが裏でVMの生存確認を送り続ける仕組みは廃止されています。2026年9月25日の変更で、VMの生存はColab側がカーネルの稼働状況から判断するようになりました。「CLIが60秒ごとに通信して最大24時間維持する」という公開当初の解説は現行版には当てはまりません。

## colab execによるコード実行とファイル転送

### 標準入力・.py・.ipynbの3通りの実行とカーネル状態の保持

`colab exec`は、標準入力・`.py`ファイル・`.ipynb`ファイルの3通りでコードを受け取ります。ノートブックを渡した場合は各コードセルを順に実行し、結果を入力と同じ場所の`<ファイル名>_output.ipynb`に書き出します。実行時の作業ディレクトリはVMの`/content`です。

```
# 標準入力から
echo "import torch; print(torch.cuda.is_available())" | colab exec -s trainer

# ローカルの.pyを送って実行（アップロード不要）
colab exec -s trainer -f train.py --env WANDB_MODE=offline

# ノートブックを実行し、結果をreport_output.ipynbに保存
colab exec -s trainer -f report.ipynb
```

同じセッションに対する`colab exec`は、毎回同じカーネルに接続し直します。1回目で`import`した変数や読み込んだデータは2回目の実行でも残っています。重いモデルの読み込みを1回目に済ませ、2回目以降は推論だけを送る使い方ができます。ただし、`colab stop`や`colab restart-kernel`の実行時だけでなく、ランタイムの回収やカーネルの異常終了時にも状態は失われます。

実行には`--timeout`（既定30秒）があります。公式の設計文書は、モデルのコンパイルやデータのダウンロードのように出力が長く途切れる処理で途中終了しないよう、この値を延ばす用途を挙げています。出力が出ない時間が長い処理では`--timeout 3600`のように大きめに指定してください。環境変数は`--env KEY=VALUE`を繰り返して渡します（0.7.0で追加）。

### upload・download・ls・rm・editによるファイル操作

ファイル操作はVM上の`/content`を起点に、絶対パスで指定するのが確実です。`colab edit`は、手元の`$EDITOR`でVM上のファイルを開いて保存すると書き戻します。

```
colab upload -s trainer data.csv /content/data.csv
colab ls -s trainer /content
colab download -s trainer /content/checkpoints/model.bin ./model.bin
colab rm -s trainer /content/data.csv
colab edit -s trainer /content/config.yaml
```

Googleドライブは`colab drivemount`で`/content/drive`にマウントできます。ブラウザでの承認が要るため、人が端末の前にいる必要があります。パッケージは`colab install torch transformers`や`colab install -r requirements.txt`で入れ、VM側ではuvを優先して使い、無ければpipに切り替わります。

### colab repl・colab console・colab sshの使い分け

VMに入って対話的に作業する手段は3つあります。用途で選び分けます。ただし、Colab FAQは、コンピューティングユニットの残高が無い無料ランタイムでのSSHシェルなどのリモート操作を禁止しており、予告なく停止されることがあると明記しています。`colab console`や`colab ssh`を利用する場合は、有料プランの購入に加えて、正のコンピューティングユニット残高を維持する必要があります。

| コマンド            | 入る先         | 向く用途                  |
| --------------- | ----------- | --------------------- |
| `colab repl`    | Pythonの対話環境 | 変数の確認・少量の試行           |
| `colab console` | tmux上のbash  | nvidia-smi・apt等のシェル作業 |
| `colab ssh`     | SSH接続のシェル   | VS Code等のリモート開発       |

`repl`と`console`はローカルにTTYが必要で、スクリプトから使うときは`echo "print(1)" | colab repl`のように標準入力をパイプで渡すと非対話モードで動きます。`console`はtmux越しのため、パイプ経由でも出力に端末制御文字が混じります。

`colab ssh`は0.7.0（2026年9月3日）で追加された機能で、WebSocketの上にSSHを通します。`--proxy-mode`を付けるとOpenSSHの`ProxyCommand`として動くため、`~/.ssh/config`に書いておけばVS CodeのRemote-SSHからColabのVMを開けます。受け付ける鍵はed25519とECDSAだけで、RSA鍵はサーバー側で拒否されます。0.7.0はビルドの不具合でPyPIに上がらなかったため、PyPIから入れて`colab ssh`を使えるのは0.7.1以降です。

```
Host colab-t4
  ProxyCommand /Users/you/.local/bin/colab ssh --proxy-mode -s t4dev --gpu T4 --rm
  User root
  StrictHostKeyChecking no
  UserKnownHostsFile /dev/null
```

`ProxyCommand`はログインシェルを経由しないため、`colab`は絶対パスで書きます。`-s`の名前のセッションが無ければ初回接続時に作られ、`--rm`を付けると切断時にVMを解放します。

## colab runで確保から解放までを1コマンドにする方法

`colab run`は、`new`→`exec`→`stop`を1回で行うコマンドです。新しいVMを確保し、ローカルのスクリプトを引数付きで実行して、既定では終了時にVMの解放を試みます。解放処理は`try/finally`で書かれており、スクリプトが例外で落ちた場合も、`--keep`未指定ならVMの解放を試みます。`colab stop`の打ち忘れによる消費を仕組みで減らせる点が`exec`との最大の違いです。ただし、0.7.4の解放処理は失敗しても例外を握りつぶすため、解放APIの失敗やCLIプロセスの強制終了時にはVMが残る可能性があります。学習結果を残す場合は、スクリプト内で外部ストレージへ保存するか、`--keep`でVMを残して成果物をダウンロードしてから停止してください。

```
# T4で学習スクリプトを実行し、終了後にVMを解放
colab run --gpu T4 train.py --epochs 3 --lr 2e-4

# 終了後もVMを残す（あとでcolab exec -s jobで続きを実行）
colab run --gpu L4 --keep -s job train.py
```

スクリプトの中では`sys.argv`が`['train.py', '--epochs', '3', ...]`に、`__name__`が`"__main__"`に設定されるので、`if __name__ == "__main__":`で書いた普通のスクリプトがそのまま動きます。`sys.exit(N)`の終了コードもローカルに返るため、シェルスクリプトやCIで成否を判定できます。存在しないファイル名を渡した場合は、VMを確保する前に`[colab] Script not found: ...`で止まり、無駄な課金は発生しません（0.7.4で確認）。

シバン行に`colab run`を書けば、ファイル単体を実行するだけでGPU上で動きます。

```
#!/usr/bin/env -S colab run --gpu L4
import torch

print("GPU:", torch.cuda.get_device_name(0))
```

`chmod +x`したうえで`./script.py`と実行します。`env`の`-S`は、`colab run --gpu L4`のように複数の語を渡すために必要です。

使い分けは「同じVMで何度も実行するか」で決まります。データの読み込みやモデルのロードを使い回すなら`new`と`exec`、1回の学習やバッチ処理で終わるなら`run`です。`run`は毎回VMを新しく確保するので、パッケージの導入やデータの取得も毎回走ります。

## colab logで実行履歴を書き出す方法と履歴ファイルの注意点

### Gemma 3 1BのQLoRA学習例と実行履歴の書き出し

公式の告知記事は、`google/gemma-3-1b-it`をSQL生成向けにQLoRAで調整する例を、次の5つのコマンドで示しています。最後に`colab download`でアダプタとトークナイザーの設定を回収し、手元で読み込みます。QLoRAそのものの仕組みと必要なVRAMの目安は[QLoRAとは？4bit量子化＋LoRAの仕組み・VRAM目安](/tech/details/15944/)で扱っています。

```
colab new --gpu T4
colab install transformers datasets peft trl bitsandbytes accelerate
colab exec -f finetune_run.py
colab log --output gemma_finetune_log.ipynb
colab stop
```

この4行目は、0.7.4では何も書き出しません。`colab log`は他のコマンドと違い、`-s`を省くと「履歴のあるセッションの一覧」を表示して終わり、`--output`は無視されます（ソースの`commands/utility.py`と実行で確認）。ファイルが作られないまま次の`colab stop`に進むため、実行記録が残っていないことに後から気付きます。セッション名を付けて確保し、`colab log`にも同じ名前を渡してください。

```
# finetune_run.pyをローカルに用意してから実行
colab new -s gemma --gpu T4
colab install -s gemma transformers datasets peft trl bitsandbytes accelerate
colab exec -s gemma -f finetune_run.py
colab log -s gemma -o gemma_finetune_log.ipynb
# [colab] Exported history to 'gemma_finetune_log.ipynb'.
# 保存先はfinetune_run.pyの書き方次第
colab download -s gemma /content/adapter/adapter_model.safetensors ./adapter_model.safetensors
colab stop -s gemma
```

書き出し形式は拡張子で決まり、`.ipynb`・`.md`・`.txt`・`.jsonl`の4つです。`.ipynb`は実行したコードをセルとして並べたノートブックになり、ブラウザのColabで開き直して同じ手順を再実行できます。`-t execution`で実行だけに絞る、`-n 20`で直近20件に絞ることもできます。履歴はローカルのファイルなので、`colab stop`でVMを解放したあとでも書き出せます。

### –envの値も平文で残る履歴ファイルの扱い

履歴の実体は`~/.config/colab-cli/history/<セッション名>.jsonl`です。0.7.4の`colab exec`・`colab run`・`colab repl`は、VMへ送ったコードと出力を実行のたびにこのファイルへ追記します。`colab upload`や`colab download`は、ファイルの中身ではなくパスだけを記録します。

問題は`--env`です。`--env HF_TOKEN=…`はVM側の環境変数を直接設定するのではなく、`os.environ['HF_TOKEN'] = '…'`というPythonの行をコードの先頭に足して送る実装です。そのため、トークンの値がコードの一部として履歴に残ります。0.7.4の同じ関数で組み立てたコードを記録し、セッション名を指定した`colab log -s 名前 -o 出力.ipynb`で書き出したところ、トークンの行は`.ipynb`のセルにもそのまま入っていました。権限はCLIが指定せずumaskに従うため、macOSの既定（umask 022）で作られたファイルは644でした。親フォルダの権限次第では、同じMacの他のユーザーからも読めます。

```
{"timestamp": "2026-10-19T01:50:02+00:00", "event_type": "execution",
 "code": "import os\nos.environ['HF_TOKEN'] = 'hf_dummy123'\nprint(1)", "outputs": []}
```

書き出したノートブックをGitHubやチャットで共有すると、トークンも一緒に渡ります。Hugging FaceやW&Bのトークンは`--env`で渡さず、トークンを書いたファイルを`colab upload`でVMに送り、スクリプトの中で読む構成にすると、履歴にはファイルのパスしか残りません。`--env`を使った場合は、共有前に書き出したファイルを`grep`で確かめ、不要になった履歴は`history`フォルダから消します。0.7.4には履歴を消すコマンドも、記録を止めるオプションもありません。

## AIエージェントから使う場合のスキルファイルとColab MCP Serverの選び方

Colab CLIには、エージェント向けの説明書（スキルファイル）が同梱されています。`colab skill`で中身を表示でき、Claude Codeなどの[Agent Skills](/tech/details/17685/)の形式（`name`と`description`を持つSKILL.md）で書かれています。内容はセッションの考え方、認証、実行、ファイル操作の注意点で、エージェントが詰まりやすい箇所が具体的に書かれています。

- `colab repl`・`colab console`・`colab auth`・`colab drivemount`をエージェントが対話的に起動しない（TTY待ちで止まる）
- ブラウザ操作が要るoauth2より、ADCで認証しておく
- `colab new`には必ず`-s`で名前を付ける
- CLIの401・403は`colab auth`ではなくスコープの問題として扱う

同じGoogle Colabチームは、MCPサーバーの[Colab MCP Server](https://github.com/googlecolab/colab-mcp)も公開しています。こちらはブラウザで開いているColabのノートブックにローカルのエージェントをつなぐもので、エージェントがノートブックのセルを書き換えながら作業します。READMEは、対応クライアントとしてGemini CLI・Claude Code・Windsurfを挙げています。

人がノートブックを見ながらエージェントと一緒に分析するならMCP Server、エージェントにGPUジョブを任せて結果だけ受け取るならCLIです。CLIのREADMEも、ノートブック内での対話的な作業ならMCP Serverを使うよう案内しています。CLIとMCP Serverの二択なら、認証を済ませた無人ジョブにはCLIが向いています。ただし、Colabの資源割り当てや実行時間は保証されないため、開始時刻や完走を保証する必要がある本番バッチには採用すべきではありません。エージェントに計算資源を持たせる設計を業務システムに組み込む場合は、権限と課金の上限を先に決めておく必要があります。設計から相談する場合は[AIエージェント開発の支援](/service/ai/agent/)も用意しています。

GPUを数時間単位で借りる手段としては、Colab以外のGPUクラウドも候補になります。長時間の学習や大容量のディスクが必要な場合の比較は[Runpodとは？料金・使い方とGPUクラウドの選び方](/tech/details/9628/)を参照してください。

## Colab CLIの料金とコンピューティングユニットの管理

CLI自体は無料ですが、確保したランタイムはブラウザのColabと同じ契約・同じ残高で動きます。Colabの公式案内によると、無料版でもNVIDIA T4 GPUを使えますが、クォータと空き状況の制限を受けます。無料版のノートブックの実行は最長12時間で、アイドル時のタイムアウト時間は公表されていません（[Colab FAQ](https://research.google.com/colaboratory/faq.html)）。2026年10月15日にはREADMEへ、CLIの利用にもColabの[利用規約](https://research.google.com/colaboratory/tos%5Fv6.html)とGoogleのプライバシーポリシーが適用されると追記されました。CLIから使う場合も、ブラウザ版と同じ規約が適用されます。有料プランの価格は、Google Workspace for Education向け管理者ヘルプのフレキシブルプランではColab Proが月額9.99米ドル・月100コンピューティングユニット、Colab Pro+が月額49.99米ドルと案内されています。個人向けの価格と付与量は購入ページの表示が正です。

消費ユニットは割り当てられたランタイム構成によって異なります。GPU名だけで固定的に比較せず、実際の消費ペースを確認してください。`--gpu`の選択肢にあるG4は、NVIDIA RTX PRO 6000 Blackwell Server Editionを載せたマシンで、Colabのリリースノートでは2026年3月25日に追加されています。

残高と消費ペースは`colab usage`で確認でき、残高（compute units）と1時間あたりの消費量が表示されます。`colab pay`はプランの購入ページをブラウザで開きます。GPUを確保している間は処理をしていなくても消費が続くので、`colab exec`で使ったセッションは作業の区切りで`colab stop`し、`colab sessions`で残っていないことを確かめてください。

0.5系から0.7系までの間に、認証方式や生存確認の仕組みが変更されています。業務の自動化に組み込むなら、`uv tool install google-colab-cli==0.7.4`のように版を固定し、上げる前にGitHubのCHANGELOGで変更点を確かめてください。

## よくある質問

### Colab CLIは無料で使えますか？

CLI自体は無料のオープンソースです。Colabの公式案内では無料版でもT4 GPUを使えるものの、クォータと空き状況次第で割り当たらないことがあり、同梱のSKILL.mdも「多くのアカウントはCPUしか確保できない」と注意しています。`--high-mem`はPro・Pro+が前提です。

### WindowsでColab CLIを使う方法はありますか？

0.7.4はWindowsでは起動時に`termios`が見つからず落ちます。起動時の修正は2026年10月6日（UTC）、`colab ssh --proxy-mode`の修正は10月13日にmainへ入りましたが、10月19日時点のPyPI最新版0.7.4にはどちらも含まれていません。当面はWSL2のLinuxに入れて使うのが現実的です。

### colab execとcolab runはどちらを使えばよいですか？

同じVMで繰り返し実行するなら`colab new`と`colab exec`、1回で終わる処理なら`colab run`です。`run`は既定で終了時にVMの解放を試みるため、停止忘れを減らせます。通信障害などが起きた場合は、セッションが残っていないか確認してください。

### ColabのGPU上でターミナル（シェル）を使えますか？

使えます。`colab console`でtmux上のbashに入るか、`colab ssh`でSSH接続します。SSHならVS CodeのRemote-SSHからVMを開いて編集することもできます。ただしColab FAQは、残高の無い無料ランタイムでのSSHシェル等を禁止しています。

### Colab CLIをClaude CodeやCodexから使えますか？

使えます。告知記事はAntigravityでの例を示したうえで、Claude CodeやCodexでも使えると明記しています。`colab skill`で出力されるスキルファイルをエージェントに読ませ、認証はADCで済ませておくと止まりにくくなります。

## 関連記事

- [TPUとは？GPU・CPUとの違い、世代別の性能と料金、TorchTPUでのPyTorch対応](/tech/details/10447/)
- [QLoRAとは？4bit量子化＋LoRAの仕組み・VRAM目安・実装手順と採用判断を解説【2026年版】](/tech/details/15944/)
- [Agent Skillsとは？SKILL.md仕様と46製品で動かす移植性の実装手順](/tech/details/17685/)
- [Runpodとは？料金・使い方・支払い方法とGPUクラウドの選び方【2026年10月】](/tech/details/9628/)
- [Jupyter Notebookのインストール手順｜7.6系をpip・uv・condaで入れる方法](/tech/details/17961/)

---

出典: [Colab CLIの使い方｜インストール・GPU指定・colab runとWindows対応状況【v0.7.4】](<https://www.issoh.co.jp/tech/details/12438/>)（株式会社一創）