# AI のセットアップ

API プロバイダ、ローカルモデル、インストール済みの CLI エージェントのいずれかに接続します。

作業のしかたを選びます。Oleafly は、内蔵アシスタントをモデル API につないで動かす、ローカルモデルに接続する、インストール済みの CLI エージェントを使う、のいずれかに対応しています。

| すでにお持ちのもの | 選ぶもの |
| --- | --- |
| モデルの API キー | **プロバイダとキー** |
| ローカルのモデルサーバー | **Ollama** か、OpenAI 互換のカスタムプロバイダ |
| インストール済みのコーディングエージェント | **[CLI エージェント](/docs/cli-agents/)** |
| 外部の MCP クライアント | **[MCP](/docs/mcp/)** |

**設定 → AI アシスタント**を開いて、使いたい方法を設定します。複数のプロバイダを接続したままにして、チャットでモデルを切り替えられます。

API キーがない場合は、サインイン済みの CLI エージェントで代わりにできます。ツール用のモデルとして選ぶと、ツールや Oleafly のほかの AI 機能がそのエージェントを使います。[API キーの代わりにエージェントを使う](/docs/cli-agents/#use-an-agent-instead-of-an-api-key)を参照してください。

![設定 → AI アシスタント → プロバイダとキー。プロバイダを展開して設定します。Ollama は一覧の下のほうにあります。](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-providers-dark-window-v2.png#view=519,89,883,902)

![アシスタントの設定にあるプロバイダのキー、コマンドラインのエージェント、スキル。](https://cdn.oleafly.com/images/gifs/desktop/settings-ai-agents.gif?v=2)

## プロバイダに接続する

1. **プロバイダとキー**を開き、プロバイダを展開します。
2. API キーを入力して保存します。
3. Oleafly が接続を確認し、モデルの一覧を更新します。
4. アシスタントでモデルを選ぶか、 **指示**で既定のモデルを設定します。

OpenAI

Anthropic

Google Gemini

Perplexity

Z.AI

Groq

OpenRouter

DeepSeek

Mistral

xAI

Ollama

設定の各プロバイダのカードには、キーの設定へのリンクがあります。Ollama はローカルのモデルサーバーに接続します。

## モデルを選ぶ

モデルの行には、わかっている範囲で機能の情報が表示されます。コンテキストのサイズ、画像対応、ツール、推論です。プロジェクトの作業にはツールに対応したモデルを、画像の確認には画像に対応したモデルを使います。

**検証済み**は、ツール呼び出しのチェックに成功したことを示します。 **未検証**は、アシスタントがそのモデルをまだ検証していないことを示します。 **利用不可**には、選べない理由が添えられます。これらのバッジが示すのはツールとの互換性です。モデルの調査や文章の質を評価するものではありません。

ツールを呼び出せないモデルでも、通常のチャットには使えます。そのモデルを選んでいる間は、入力欄に「チャットのみ。このモデルはツールを使えません」と表示されます。

プロバイダのカードで利用できるモデルが変わったときは、 **更新**を選びます。更新できるのは、各プロバイダにつき 30 秒に 1 回です。ボタンにポインタを合わせると、残り時間が表示されます。モデルは識別子を指定して追加することもできます。

**すべて有効にする**と**すべて無効にする**は、プロバイダの一覧にあるすべてのモデルを、まとめてオンまたはオフにします。長い一覧をワンクリックでオフにしてから、使うモデルだけをオンに戻せます。

## ローカルモデルに接続する

[Ollama](https://ollama.com/) をインストールして起動し、Ollama でモデルをダウンロードします。Oleafly で Ollama のカードを開き、 **Ollama を確認**を選びます。サーバーが見つかったら、インストール済みのモデルを選びます。

ローカルモデルを使うと、モデルへのリクエストは自分のコンピュータの中にとどまります。オンラインの調査ツールは、使うときには引き続き提供元のサービスに接続します。

## カスタムエンドポイントを追加する

OpenAI 互換のサービス、ローカルサーバー、ゲートウェイには、 **カスタムプロバイダを追加**を選びます。名前、ベース URL、必要なキーがあればそれを入力します。保存してモデルを選びます。

OpenCode Zen と OpenCode Go は、カスタムプロバイダとして使えます。この 2 つはセッション ID のないリクエストを拒否するため、Oleafly は各チャットの ID を送ります。ほかのプロバイダには送りません。ローカルの Lemonade サーバーもここで使えます。回答の前に思考するモデルについては、[思考のステップを省く](/docs/ollama/#skip-the-thinking-step)を参照してください。

保存済みのプロバイダは、編集してアドレスを変更できます。保存済みのキーは、そのプロバイダを使うときに新しいアドレスへ送られるため、保存する前に送信先を確認してください。

## 文章の好みを設定する

**指示**には、常設の好みと既定のチャットモデルを設定します。具体的な指示を書いてください。

> イギリス式の綴りを使ってください。引用キーは変えないでください。数式を変更するときは、適用する前に説明してください。

**ペルソナ**には、名前を付けた指示のプリセットを保存します。 **スキル**は、繰り返す調査作業の手順を提供します。[スキルを見る →](/docs/skills/)

## キーと費用

プロバイダのキーは、ローカルのアプリ保存領域に暗号化して保存され、プロジェクトのソースファイルには含まれません。ホスト型のリクエストは、渡したコンテキストとともに選択したプロバイダに送られます。モデル API の料金や CLI のサブスクリプションは、それぞれのプロバイダから請求されます。

[使用状況と予算を確認する →](/docs/ai-usage/)
