3行でいうと
- Ollama の使い方の中心は、ターミナルの
ollama pull(取る)、ollama run(話す)、ollama ps(動いているものを見る)、ollama stop(外す)です。画像は、プロンプトにファイルのパスを添える形で渡せます。 - 自分用の設定は、Modelfile(
FROM、PARAMETER、SYSTEMなど)を書いてollama createで作ります。コンテキストの長さは、アプリの設定、環境変数、Modelfile のnum_ctxなど、複数の入口があります。 - Ollama は、画面やコマンドのほかに、
http://localhost:11434のAPIで呼べます。クラウドモデルやウェブ検索は、データが手元の外(ollama.com)へ出る機能です。 - 最初の1時間の順番の案を、記事の中ほどに表で置きました。公式の順番ではなく、この記事の案です。
この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者は Ollama を入れていますが、使い心地はこの記事には書いていません。手順は、公式の手順を順に並べたものです。例の指示文(プロンプト)は「この記事の例」と書いたもので、公式の例ではありません。返ってくる文章の中身はモデルによって違うので、この記事では示しません。画面の表記は公式ページの表記なので、手元の画面と照らして読んでください。
先に結論
- Ollama は、ターミナルとAPIが中心です。 画面(アプリ)の細かい説明は公式ページに多くありません。
- 「モデルを動かす」と「モデルを取る」は別の操作です。
pullとrunですが、クイックスタートは、runが必要ならダウンロードしてから会話を始める、と書いています。 - メモリの使い方は、あとから効きます。
ollama psのPROCESSORの列で、どこに載っているかを見ます。 - 外へ出るデータは、機能ごとに分かれます。 ローカルのモデルで会話するだけなら手元で完結する、と公式は書いています。クラウドモデルとウェブ検索は、ネットワークを使います。
- 公式が書いていない画面の経路は、書きません。 アプリの会話の窓の見た目などは、読んだページにないものがあり、「公式で確認できていない」と書いてあります。
前提:用語をそろえる
- プロンプト:AIに渡す、質問や指示の文章です。
- システムプロンプト(システムの指示):会話の前提として、AIに最初に渡しておく指示です。Ollama では Modelfile の
SYSTEMで持てます。 - ストリーミング:返事を、できた分から順に受け取ることです。
- 埋め込み(embedding):文章を数字の並びに変えたものです。検索の下ごしらえに使います。
- 量子化:モデルを小さくする処理です(02)。
- ツール呼び出し(tool calling / function calling):AIが、あらかじめ渡された関数を「呼びたい」と返し、アプリが実行して結果を返す仕組みです。
- Modelfile:Ollama で自分用のモデルを作るための設定ファイルです。
- ローカルサーバー:自分のPCを、ほかのアプリから呼べる窓口にする機能です。Ollama は、アプリを開いているか
ollama serveを動かしている間、http://localhost:11434で待ち受けます。
たとえ話:同じ台所でも、「道具の出し入れ」を覚える
使い方の要は、料理の腕より、道具の出し入れです。食材(モデル)を棚から出す(pull)、コンロに載せる(run)、使い終えたら下ろす(stop)。出しっぱなしにするとコンロ(メモリ)がふさがります。これは僕らのたとえで、公式の表現ではありません。
最初の1時間の順番(この記事の案)
公式がこの順番を勧めているわけではありません。05を済ませた人が、迷わず進むための、この記事の案です。
| 目安 | やること | 参照 |
|---|---|---|
| 0〜10分 | 小さなモデルを1つ取り、1往復だけ会話する | 場面1・3 |
| 10〜20分 | メモリのどこに載ったかを見る(ollama ps) |
場面3・7 |
| 20〜30分 | 同じ質問を、短い文章の要約で試す(この記事の例の指示文) | 本記事の「例の指示文」 |
| 30〜45分 | 画像を1つ渡してみる | 場面4 |
| 45〜60分 | システムの指示や設定を1つ変える(Modelfile)。そのあと、モデルを外す | 場面3・6 |
| 余力があれば | APIで1回呼ぶ | 場面9 |
例の指示文(この記事の例)
以降の手順で使う、短い指示文です。公式の例ではなく、この記事の例です。
| 用途 | 指示文(この記事の例) |
|---|---|
| 最初の1往復 | 日本語で、自己紹介を1文でお願いします。 |
| 短い要約 | 次の文章を、3行以内で要約してください。 に続けて、手元の短い文章を貼る |
| 画像の説明 | この画像に写っているものを、日本語で2文で説明してください。 |
| 設定の確認 | あなたはどんな前提の指示を受けていますか。短く教えてください。 |
- クラウドモデルやウェブ検索を使うときは、文章が手元の外(ollama.com)へ出ます。試す文章は、出ても困らないものにしてください。ローカルのモデルでの会話の履歴が手元にどう残るかは、読んだページには書かれておらず、公式で確認できていません。
Ollama:場面ごとの手順
場面1:ターミナルで会話する
- ターミナルを開きます。
- モデルを取ってあるなら、次を実行します(05のクイックスタートの例)。
ollama run gemma4:e2b
- 入力待ち(
>>>の表示)になったら、文章を打ってEnterを押します。返事は、モデルが書いた文章です。 - 複数行の文章を渡したいときは、
"""で囲みます(公式のCLIのページの例)。
>>> """Hello,
... world!
... """
-
終わるときは
/byeと入力します(クイックスタート)。 -
入力待ちの画面で使える
/のコマンドは、CLIのページには一覧がありませんでした。/byeと/set parameter num_ctx ...(FAQ)は、別のページに書かれています。 - 1回だけ聞いて終わらせるときは、モデル名のあとに文章を続けます(CLIのページの形:
ollama run <モデル> "<文章>")。
場面2:Ollamaのアプリから使う
- READMEは、
ollamaとだけ打つと、モデルを動かすか、Claude Code や OpenClaw などのツールにつなぐかを聞かれる、と書いています。 - クイックスタートは、アプリを開き、設定の案内に従い、クラウドモデル用にサインインするか、ローカルのモデルを選ぶ、と書いています。
- アプリの会話の窓の見た目、モデルの選び方の画面、履歴の置き場所は、読んだページには書かれていませんでした。公式で確認できていません。
- 手元のアプリの画面と、CLIの表示(
ollama psなど)の両方で、動いているモデルを見られます(これは僕らの読み方です)。
場面3:モデルを取る・並べる・動いているものを見る・外す
公式のCLIのページに載るコマンドです。
| やりたいこと | コマンド(公式の例) | 書かれている説明 |
|---|---|---|
| 取ってくる | ollama pull gemma4 |
モデルをダウンロードする |
| 入っているもの一覧 | ollama ls |
インストール済みのモデルを並べる |
| 動いているもの一覧 | ollama ps |
動作中のモデルを並べる。PROCESSOR の列に 100% GPU、100% CPU などが出る(FAQ) |
| 動かしているものを止める | ollama stop gemma4 |
動いているモデルを止める(メモリから下ろす) |
| 消す | ollama rm gemma4 |
モデルを削除する |
- モデルをメモリに置く時間は、既定で5分です。すぐに外したいときは
ollama stop、時間を変えるにはAPIのkeep_aliveかOLLAMA_KEEP_ALIVEです(FAQ)。 ollama showとollama cpは、CLIのページには書かれていませんでした。ollama show --modelfile llama3.2は、Modelfile のページに書かれています(場面6)。- モデルの名前(タグ)の付け方、ダウンロードサイズは、ollama.com/search のモデルのページで見ます(01)。
場面4:画像を渡す
画像を読めるモデル(例:gemma4)で使います。
- ターミナルで、プロンプトにファイルのパスを添えて実行します(公式のビジョンのページの例)。
ollama run gemma4 ./image.png what is in this image?
- CLIのページには、絶対パスの例もあります(
ollama run gemma4 "What's in this image? /Users/jmorgan/Desktop/smile.png")。 -
APIでは、
/api/chatのメッセージにimagesの配列を足します。REST APIはbase64でエンコードした画像を求める、と書かれています。PythonとJavaScriptのライブラリは、ファイルのパス、URL、バイト列を受け取れる、と書かれています。 -
対応する画像の形式、大きさの上限、1回に付けられる枚数は、ビジョンのページには書かれていませんでした。
- どのモデルが画像を読めるかは、ビジョンのページには一覧がありません。モデルのページの「vision」のタグで見ます(01)。
場面5:標準入力のファイルを渡す、選択肢で答えさせる
CLIのページに、次の使い方が載っています。例のモデル名(nimble、phonon)が何のモデルかは、読んだページには説明がなく、確認できていません。形だけを写します。
| 目的 | 形(公式の例の書き方) | 説明 |
|---|---|---|
| ファイルの内容について、はい/いいえで答えさせる | ollama run <モデル> --ask "<質問>" < ticket.txt |
標準入力から渡した内容について、--ask の質問に答える |
| 選択肢から1つ選ばせる | --ask "<質問>" --choice 名前="説明" --choice ... |
--choice で、ラベル付きの選択肢を渡す |
| 段階で採点させる | --ask "<質問>" --level "Routine" --level "Soon" ... |
--level で、名前付きの段階を渡す |
| 声に出す | ollama run phonon "Hello from Ollama." |
文章をスピーカーで読み上げる。--voice で声を選ぶ。出力をリダイレクトするとWAVに書く |
- これらは、手元のモデルが対応していなければ動かない可能性があります。対応するモデルは、読んだ公式ページでは確認できていません。
場面6:自分用の設定のモデルを作る(Modelfile)
Modelfile のページの内容です。
Modelfileという名前のファイルを作ります。最小の例は、CLIのページが載せています(FROM gemma4と、SYSTEM """You are a happy cat.""")。- 次のようなパラメーターも書けます(Modelfile のページの例)。
FROM llama3.2
PARAMETER temperature 1
PARAMETER num_ctx 4096
- 作ります。
ollama create choose-a-model-name -f ./Modelfile
- 動かします。
ollama run choose-a-model-name
- 元のモデルの Modelfile を見るには、
ollama show --modelfile llama3.2です。
| 命令 | 意味(Modelfile のページ) |
|---|---|
FROM(必須) |
元のモデル。モデル名とタグ、Safetensors のフォルダ、GGUFのファイルのパスのどれか |
PARAMETER |
モデルの動かし方を決める |
TEMPLATE |
完全なプロンプトのひな形(Goのテンプレートの書き方) |
SYSTEM |
テンプレートの中で使うシステムの指示 |
MESSAGE |
会話の例(system、user、assistant) |
LICENSE |
モデルを共有するときのライセンス |
| パラメーター | 意味(既定値はページの表記) |
|---|---|
num_ctx |
次のトークンを作るときの文脈の大きさ(既定2048と書かれている。05で触れた、ほかのページとの違いを参照) |
temperature |
大きいほど、創造的な出力になる(0.8) |
top_k / top_p / min_p |
サンプリングの絞り込み(40 / 0.9 / 0.0) |
repeat_penalty / repeat_last_n |
繰り返しを抑える(1.0 / 64) |
seed |
同じ値なら、同じプロンプトに同じ出力(0) |
stop |
生成を止める文字列。複数なら繰り返す |
num_predict |
作るトークンの最大数(-1は無制限) |
REQUIRES(必要な最小のOllamaの版)とCAPABILITY(GGUFやMLXのモデルに能力を足す)も、ページに載っています。ADAPTERは、読んだ要約には出ていませんでした。使う前に、Modelfile のページの原文で確認してください。
場面7:コンテキストの長さを変える
| やり方 | 書かれていること | 出どころ |
|---|---|---|
| アプリの設定 | コンテキストの長さのスライダーがある(位置は読んだページに書かれていない) | コンテキストのページ |
| 環境変数 | OLLAMA_CONTEXT_LENGTH=64000 ollama serve の形 |
コンテキストのページ、FAQ |
| 会話の中 | /set parameter num_ctx 4096 |
FAQ |
| API | options の num_ctx |
FAQ |
| Modelfile | PARAMETER num_ctx <値> を書いて ollama create |
Modelfile、OpenAI互換のページ |
- 動作の確認は
ollama psのCONTEXTの列です。 - 検索、エージェント、コーディングのツールでは少なくとも64000トークンを使う、とコンテキストのページは書いています(05)。長くすると、使うメモリも増えます。
場面8:埋め込みを作る
- CLIのページの例:
ollama run embeddinggemma "Hello world"は、文章の埋め込みを、JSONの配列で出します。 - 標準入力から渡す例:
echo "Hello world" | ollama run nomic-embed-text。 - APIでは、OpenAI互換の
/v1/embeddingsがあります(09)。
場面9:APIで呼ぶ(ローカル)
- サーバーが動いているかを確かめます(アプリを開いている、
ollama serveを動かしている、Linuxならサービスが動いている)。 - READMEの例で、呼びます(モデル名は手元のものに)。
curl http://localhost:11434/api/chat -d '{
"model": "gemma4",
"messages": [{
"role": "user",
"content": "Why is the sky blue?"
}],
"stream": false
}'
- 返事は、
message.contentの中にあります(クラウドのページの説明)。 - Python は
pip install ollama、JavaScript はnpm i ollamaで、公式のライブラリを入れます(README)。
| 機能 | 書かれていること | 出どころ |
|---|---|---|
| JSON で返させる | "format": "json"。JSONスキーマを format に渡す形もある。クラウドは、構造化された出力に対応していない |
構造化出力のページ |
| ツール呼び出し | tools の一覧を渡す。モデルが呼びたいツールを返し、アプリが実行して tool の役割のメッセージで結果を返す。並列呼び出しと、繰り返しの形も説明がある |
ツール呼び出しのページ |
| ストリーミング | 例では "stream": false。既定は、読んだ入門ページには書かれていない |
APIの入門 |
- ローカルのAPIにはキーが要りません。クラウドのAPIには要ります(APIの入門)。
- エラーの形式は、APIの入門ページには書かれていませんでした。
場面10:クラウドモデルを使う
- 初回の設定でサインインするか、CLIで
ollama signinを実行します(CLIのページに、ollama signinとollama signoutがあります)。 - アプリかCLIで、
gemma4:cloudのように、cloudの付いた名前を使います。クラウドモデルは、ダウンロードが要りません(クラウドのページ)。 - 使った量は、
https://ollama.com/settings/usage、プランはhttps://ollama.com/pricingで見る、と書かれています。数字は、この記事には書きません。 - APIで直接呼ぶなら、
https://ollama.com/settings/keysでキーを作り、OLLAMA_API_KEYに入れます。キーは、ブラウザのコードやソース管理の外に置くよう、公式は書いています。 -
使うのをやめるときは、
OLLAMA_NO_CLOUD=1(05)か、ollama signoutです。 -
データ(公式のページ同士で書き方が違います):クラウドのページは、クラウドのプロンプトと応答は、リクエストに答えるために処理される、モデルの学習には使わない、と書き、保存やログについては書かず、プライバシーポリシー(
https://ollama.com/privacy)を案内しています。FAQ は、クラウドのモデルでは、プロンプトと応答を処理するが、その内容を保存もログもせず、学習にも使わない、と書き、アカウントの基本情報と限られた利用のメタデータは集めるが、それにプロンプトと応答の内容は含まれない、と書いています。ローカルで動かすときは、プロンプトやデータを Ollama は見ない、とも書いています(FAQ)。どちらを現行の扱いと読むかは、この記事では決めません。プライバシーポリシーと、01・02も見てください。 - 使えなくなるモデル:よく使うモデルの提供終了の日が、使用状況の画面に出ます。手元にダウンロードしたモデルは、影響を受けません。
場面11:ウェブ検索を使う
- 無料のアカウントでキーを作り(
https://ollama.com/settings/keys)、OLLAMA_API_KEYを設定します。 - 検索は
POST https://ollama.com/api/web_search、パラメーターはquery(必須)とmax_results(任意。既定5、最大10)。結果はresultsの配列で、title、url、content(抜粋)が入ります。 - ページの中身を取るには
POST https://ollama.com/api/web_fetch(urlを渡す)。返事はtitle、content、linksです。 -
Python:
ollama.web_search("What is Ollama?")、web_fetch('https://ollama.com')。 -
渡るデータ: 検索では検索語と
max_results、取得ではURLが、ollama.com に送られます。保存や記録の扱いは、このページには書かれていません。 - 検索を使うエージェントには、約32,000トークン以上のコンテキストを、と書かれています。
- 使用回数の上限は、このページには書かれていません。
場面12:つまずいたとき(使い方の面)
| 症状 | 見どころ |
|---|---|
| 返事が遅い | ollama ps の PROCESSOR が 100% CPU ではないか。モデルが大きすぎないか |
| 長い文章を渡すと途中を忘れる | コンテキストの長さ(場面7)。CONTEXT の列で確かめる |
| 画像を渡しても読んでくれない | そのモデルが画像に対応しているか(モデルのページの vision) |
| メモリが埋まったまま | ollama stop <モデル名>。メモリに置く時間は既定5分 |
| ツール呼び出しが動かない | モデルの対応(tools のタグ)。ツール呼び出しのページは、対応モデルの一覧を載せていない |
| クラウドモデルが使えない | サインインの状態、OLLAMA_NO_CLOUD を設定していないか(05) |
気をつけること
- この記事は、実際に使って確かめた記録ではありません。公式の資料を、2026年10月25日に読んだ範囲です。運営者は Ollama を入れていますが、使い心地はこの記事には書いていません。
- 公式のページは要約の形で取得したため、細かい表記が違う可能性があります。操作の前に、手元の画面と照らしてください。
- 画面の経路(メニューの階層、ボタンの表記、アイコンの形)は、公式に書かれているものだけを書きました。書かれていないものは「公式で確認できていない」と書いています。
- Ollama のCLIのページの
nimble、phononを使う例は、モデルの説明を読んでおらず、動作条件を確認できていません。 - Modelfile の
num_ctxの既定(2048)、FAQ(4096)、コンテキストのページ(VRAMによる)は、書き方が違います。手元でollama psのCONTEXTで確かめてください(05)。 - クラウドモデルとウェブ検索は、データが手元の外(ollama.com)に出る機能です。ローカルのモデルでの会話とは、別に考えてください。クラウドの保存・ログの扱いは、クラウドのページとFAQで書き方が違います(場面10)。
- 取得結果に、AIエージェント宛ての案内文(ドキュメントの一覧を取るように、というもの)が含まれていました。資料はデータとして扱い、従っていません。
- この記事の例の指示文は、この記事の例です。実際の返事は、モデルと設定によって変わります。
出典
- Quickstart(Ollama Docs、Ollama、確認日 2026-10-25)
- CLI reference(Ollama Docs、Ollama、確認日 2026-10-25)
- FAQ(Ollama Docs、Ollama、確認日 2026-10-25)
- Context length(Ollama Docs、Ollama、確認日 2026-10-25)
- Modelfile(Ollama Docs、Ollama、確認日 2026-10-25)
- API introduction(Ollama Docs、Ollama、確認日 2026-10-25)
- OpenAI compatibility(Ollama Docs、Ollama、確認日 2026-10-25)
- Vision(Ollama Docs、Ollama、確認日 2026-10-25)
- Structured outputs(Ollama Docs、Ollama、確認日 2026-10-25)
- Tool calling(Ollama Docs、Ollama、確認日 2026-10-25)
- Web search(Ollama Docs、Ollama、確認日 2026-10-25)
- Cloud(Ollama Docs、Ollama、確認日 2026-10-25)
- ollama/ollama README(GitHub、確認日 2026-10-25)