Ollama list、pull、run:コマンド集 essentielles

Ollama の操作の大部分はターミナルから行います。モデルのダウンロードには ollama pull、モデルとの対話には ollama run、インストール済みのものの確認には ollama list を使います。このガイドでは、日常的に使うコマンド(pull、run、list、ps、show、stop、rm、create、cp)を、コマンドごとの例ひとつと、その出力の読み方とともにまとめています。最初の数週間は、ターミナルの横に開いておいてください。
#Ollama のコマンドを覚える理由
Ollama はバックグラウンドで動作し(http://localhost:11434 で待ち受ける「サーバー」)、それに命令を送る小さなコマンドラインプログラム ollama を提供しています。Open WebUI のような GUI も同じサーバーを経由します。GUI ではモデルとのチャットはできますが、GPU メモリを何が占有しているかの確認、モデルのパラメーターの確認、ディスクの整理は必ずしもできるとは限りません。
九つのコマンドで主要な操作はほぼカバーできます。これらは三つのグループに分けられます。モデルの取得と使用(pull、run)、ディスクに保存されたモデルの管理(list、show、rm、cp、create)、メモリに読み込まれたモデルの管理(ps、stop)です。このディスクとメモリの区別を覚えておけば、ほとんどの混乱を避けられます。モデルはダウンロードされていても読み込まれていないことがあり、また読み込まれていても対話中とは限りません。
#前提条件
私たちの経験とガイド付きルートを活かして、ローカルアシスタントを作り、AIを毎日の作業に取り入れましょう。
- 永久に利用できるオンラインスペース
- PDF + ファイル
- 30日間返金対応
- Ollama インストール済み
- Windows、macOS、または Linux 上で。まだの場合は、まずインストールガイド(ページ末尾のリンク)に従ってください。
- ターミナル
- Windows では PowerShell または Windows ターミナル、macOS ではターミナル、Linux では任意のシェルを使用します。コマンドは三つの OS すべてで同じです。
- 起動済みのサーバー
- Windows と macOS では Ollama アプリケーション、Linux では systemd サービスです。これが起動していないと、ほとんどのコマンドが接続エラーを返します。
- ディスク上の空き容量
- Q4_K_M の小さな 3B モデルは約 2 GB、7B は約 5 GB、14B は約 9 GB です。
最初のコマンドはクライアントのバージョンを表示し、サーバーが応答する場合はサーバーのバージョンも表示します。二つ目のコマンドは、お使いの環境で利用可能なすべてのコマンドを一覧表示します。このガイドの例がお使いの環境で動作しない場合は、これを参照してください。
#ステップ1 — ollama pull et ollama run :モデルを取得して実行する
#ollama pull : télécharger
ollama pull は、公式ライブラリ(ollama.com/library)からモデルを起動せずにダウンロードします。名前は モデル:タグ の形式です。タグを省略すると、Ollama は latest を使用します。latest は通常、デフォルトで提供されるサイズと量子化(多くの場合 Q4_K_M)を指しています。
利用可能なタグ(サイズ、q8_0 や fp16 などの量子化)は、ライブラリ内の各モデルのページに掲載されています。ダウンロードが中断された場合は、同じコマンドを再実行すると中断した箇所から再開されます。
#ollama run:モデルと対話する
ollama run はモデルをメモリに読み込み、ターミナルで対話セッションを開始します。モデルがまだディスク上にない場合、run は最初にダウンロードを行います。そのため pull は必須ではありませんが、事前にモデルを準備しておくのに役立ちます。
対話セッションでは、コマンドはスラッシュで始まります。お使いのバージョンでの全一覧は /? と入力すると表示されます。特に便利なものは次のとおりです。
- /bye
- セッションを終了します(Ctrl+D でも終了できます)。モデルは数分間メモリにロードされたままになります。
- /clear
- 終了せずに、現在の会話の履歴を消去します。
- /set parameter num_ctx 8192
- セッション中のパラメーターを変更します。ここではコンテキストサイズを変更しています。Modelfile に記述する前に試すのに便利です。
- /show info
- ロード中のモデルの情報を、ollama show と同様に表示します。
- """
- 複数行のテキストブロックを開始・終了します。長い抜粋を貼り付けるときに便利です。
--verbose を付けると、Ollama は各応答の後に所要時間と速度(トークン/秒単位の eval rate を含む)を表示します。他所で見つけた数値に頼るのではなく、自分のマシンでモデルの速度を測る最も簡単な方法です。
#ステップ2 — ollama list と ollama rm :ディスク上のモデルを管理する
#ollama list : voir ce qui est installé
ollama list(またはエイリアスの ollama ls)は、ディスク上にあるすべてのモデルを表示します。何かを削除する前に実行すべきコマンドであり、他のコマンドに渡すモデルの正確な名前を確認する際にも使用します。
- NAME
- タグを含む完全な名前です。run、show、rm、cp には、この名前をそのまま指定します。
- ID
- マニフェストのダイジェストの先頭部分です。同じ ID を持つ二つの名前は同じモデルを指します。典型的には ollama cp の後にこうなります。
- SIZE
- ディスク上のモデルファイルのサイズです。必要なメモリのおおよその目安になりますが、ロード後に実際に占有されるメモリはこれより大きくなります(コンテキスト、KV キャッシュ)。実際の使用量は ollama ps で確認できます。
- MODIFIED
- 最後にダウンロードまたは作成された日付です。古いモデルが必ずしも時代遅れとは限りません。同じタグでより新しいバージョンがあるかどうかは、pull を再実行して確認してください。
サイズの合計には注意してください。レイヤーを共有するモデル(あるモデルとそのコピー、または別のモデルをもとに作成したカスタムモデル)では、それらのレイヤーは一度しか保存されません。そのため、SIZE 列の合計が、モデルフォルダーで実際に使用されている容量を上回ることがあります。
#ollama rm:モデルを削除する
rm はモデルを一覧から外し、他のどのモデルにも使われなくなったファイルを削除します。ごみ箱も確認もありません。元に戻すには再ダウンロードが必要です。ディスク容量を徹底的に解放する手順や Ollama をアンインストールする手順は、メンテナンスガイドでシステムごとに詳しく説明しています。
#ステップ3 — ollama ps と ollama stop:メモリを管理する
/bye でセッションを終了しても、モデルはすぐにはアンロードされません。次の質問を待ち時間なく開始できるよう、Ollama は一定時間(デフォルトで5分、環境変数 OLLAMA_KEEP_ALIVE で調整可能)モデルをメモリに保持します。現在ロードされているものは ollama ps で確認できます。
- SIZE
- ロードされたモデルが占有しているメモリ(コンテキストを含む)です。ollama list で表示されるディスク上のサイズより大きくなります。
- PROCESSOR
- 最も役に立つ列です。「100% GPU」:すべてが VRAM に収まっており、理想的な状態です。CPU/GPU で分割されている場合は、モデルの一部がシステムメモリにはみ出していることを意味し、生成速度が大幅に低下します。「100% CPU」:GPU はまったく使われていません。
- UNTIL
- リクエストが来なくなった場合に、モデルがアンロードされる時刻です。
- CONTEXT
- バージョンによっては、割り当てられたコンテキストサイズを示す列もあります。お使いの環境でこの列が表示されない場合は、ollama show donne で設定値を確認してください。
カードに収まるはずのモデル(たとえば Q4 の 7B で約 5 GB を、RTX 3060 12 GB で使う場合)で PROCESSOR に CPU/GPU の分割が表示される場合は、まず別のモデルが同時に読み込まれていないか、またはコンテキストサイズが大きすぎないかを確認してください。
#ollama stop:モデルをアンロードする
stop は、このモデルが占有しているメモリを、ディスクから削除することなく直ちに解放します。ゲーム、レンダリングソフト、あるいはより大きな別のモデルを起動する前に便利です。rm と混同しないでください。stop はメモリに、rm はディスクに作用します。
#ステップ 4 — ollama show :モデルを調べる
ollama show は、インストール済みモデルの情報を表示します:アーキテクチャ、パラメータ数、最大コンテキスト長、埋め込み(embedding)サイズ、量子化、機能(モデルに応じてツール、ビジョン、推論)、デフォルトパラメータ、ライセンスです。コンテキストサイズを調整したり Modelfile を作成したりする前に、まず確認すべき項目です。
- --parameters
- モデルの作成者が設定した推論パラメーターです。何も表示されない場合は、Ollama のデフォルト値が適用されます。
- --modelfile
- モデルをカスタマイズする際の理想的な出発点です。出力をファイルにコピーして編集し、ollama create に渡してください。
- --template
- モデルが想定するメッセージ形式です。理由がわかっている場合にのみ変更してください。誤ったテンプレートは応答の質を大きく低下させます。
- --license
- ライセンスの本文です。商用利用の前に必ず読んでください。オープンウェイトモデルのライセンスはすべて同等というわけではありません。
- -v / --verbose
- 最近のバージョンでは、モデルファイルの追加メタデータを表示します。
#ステップ 5 — ollama create et ollama cp:独自のバリアントを作成する
#ollama create : construire un modèle à partir d'un Modelfile
Modelfile は、既存のモデルを出発点として、システムプロンプト、パラメーター、テンプレートを追加する小さなテキストファイルです。ollama create le これを新しいモデルに変換し、そのモデルは ollama list に表示されます。ベースモデルのレイヤーは再利用されるため、バリアントはディスク容量をほとんど消費しません。
ファイル名が正確に Modelfile で、カレントディレクトリにある場合、バージョンによっては -f オプションを省略できます。ollama create sait GGUF 形式の重みをインポートしたり(FROM ./modele.gguf)、--quantize(-q)オプションで FP16 のモデルを量子化したり(例:-q q4_K_M)することもできます。Modelfile のすべての命令は専用ガイドで詳しく説明しています。
#ollama cp:コピーまたは名前の変更
コピーはオリジナルと同じファイルを共有します(ollama list で同じ ID が表示されます)。主に、スクリプトやインターフェースで安定した名前を維持するため、または ollama pull qui によって置き換えられる前にバージョンを固定するために使用します。
#チートシート:Ollama の全コマンドを一覧で
- ollama pull <モデル>
- ライブラリからモデルをダウンロードまたは更新します。
- ollama run <モデル> ["question"]
- 対話形式でチャットするか、単発の質問を送ります。モデルがない場合はダウンロードします。統計情報を表示するには --verbose を指定します。
- ollama list / ollama ls
- ディスク上にあるモデルを一覧表示します:名前、ID、サイズ、日付。
- ollama ps
- メモリに読み込まれているモデル、その使用量、CPU/GPU の配分を一覧表示します。
- ollama show <モデル>
- モデルの詳細情報。--parameters、--modelfile、--template、--system、--license。
- ollama stop <モデル>
- モデルを削除せずに、メモリからアンロードします。
- ollama rm <モデル>
- 確認なしでモデルをディスクから削除します。
- ollama create <名前> -f Modelfile
- カスタムモデルを構築します。-q で量子化します。
- ollama cp <source> <destination>
- モデルを別の名前でコピーします。
- ollama serve
- サーバーをフォアグラウンドで起動します(デバッグに便利です)。
- ollama push <ユーザー>/<モデル>
- ollama.com にモデルを公開します(アカウントが必要です)。
- ollama help [コマンド]
- 全般的なヘルプ、または特定のコマンドのヘルプを表示します。--help と同等です。
最近のバージョンでは、特に ollama.com アカウントやホスト型モデルに関連するその他のコマンドも追加されています。これらはローカル利用に焦点を当てた本チートシートの範囲外です。お使いのバージョンでは ollama help で一覧を確認できます。
#よくあるエラーのトラブルシューティング
- 01「could not connect to ollama app」または「connection refused」サーバーが動作していません。Ollama アプリケーション(Windows、macOS)またはサービス(Linux:sudo systemctl start ollama)を起動してから、もう一度お試しください。最後の手段として、別のターミナルで ollama serve を実行し、エラーメッセージを確認してください。
- 02「model not found」または「file does not exist」その名前はインストール済みのどのモデルにも一致しません。ollama list を実行し、タグを含めた正確な名前をコピーしてください。qwen2.5 は qwen2.5:latest を指し、qwen2.5:14b ではありません。
- 03ollama list est vide alors que des modèles ont été téléchargésクライアントが別のサーバーまたは別のモデルフォルダーを参照している可能性があります。たとえば、OLLAMA_HOST 変数が異なる、OLLAMA_MODELS が変更されている、または Ollama が二重にインストールされている(アプリケーションと Docker コンテナなど)といったケースです。コンテナ内の場合、コマンドはコンテナの内部で実行します:docker exec -it ollama ollama list。
- 04モデルの応答が非常に遅い生成中に ollama ps を実行してください。PROCESSOR 列に CPU の割合が表示されている場合、モデルは VRAM に完全には収まっていません。ollama stop で他のモデルをアンロードするか、num_ctx を減らすか、より小さいサイズまたは量子化を選択してください。
- 05ディスクがいっぱいになるollama list で一通り確認し、使用していないモデルを ollama rm les で削除してください。より厄介なケース(孤立したファイル、移動したフォルダー)については、メンテナンスガイドを参照してください。
#さらに詳しく
このチートシートはコマンドラインを扱います。インストール、メンテナンス、高度なカスタマイズについては、それぞれ専用のガイドがあります。
- Ollama のインストール
- Windows、macOS、Linux へのステップバイステップのインストール:https://quelllm.fr/guide/installer-ollama
- 更新、削除、アンインストール
- OS 別のアップデート、ディスク容量の確保、完全なアンインストール:https://quelllm.fr/guide/maintenance-ollama-update-supprimer
- Modelfile
- ollama create でモデルを作成・カスタマイズするためのすべての命令:https://quelllm.fr/guide/ollama-modelfile-personnalisation
- Ollama を理解する
- Ollama の機能、モデルの読み込み方法、対象ユーザー:https://quelllm.fr/guide/ollama-debutant-c-est-quoi-comment-ca-marche
- 公式ソース
- CLI リファレンス:https://docs.ollama.com/cli、コードとリリースノート:https://github.com/ollama/ollama(2026年11月16日には再確認できていません。ガイド冒頭の注意書きを参照してください)。
ご意見、誤りのご指摘、補足はありますか?ぜひお知らせください。皆さんにとってより良いガイドにするために役立ちます。