# OpenCodeでローカルAIモデルを実行する方法

このガイドでは、接続方法を順を追って説明します **OpenCode Desktop** を [Unsloth](https://github.com/unslothai/unsloth) に接続してオープンなLLMを実行し、 **完全にローカルで動作させます。** OpenCodeは、 **オープンソースのAIコーディングエージェント** であり、接続されたモデルを使ってプロジェクト全体のコードを読み取り、変更し、実行します。\
\
これは、あらゆる **ローカルモデル** に対応しており、Unslothの **OpenAI互換API**を通じて公開されているものなら利用できます。これには DeepSeek、Qwen、Gemma などが含まれます。OpenCode がクライアントとして動作し、Unsloth はローカルAPI経由でモデルを読み込み、提供します。

セットアップ後、OpenCode は Unsloth に接続し、そこで読み込まれたモデルを選択して、 **コーディングエージェント**.

<a href="https://sites.gitbook.com/preview/site_mXXTe/~/revisions/S6OVzFPYN3gcF4rziUb5/integrations/opencode?theme=light#installing-opencode-desktop" class="button primary">OpenCode セットアップ</a><a href="/pages/3864bcb37ba6a47277fdce43a7f1d4bc977d7edb#quickstart" class="button primary">クイックスタート</a>

{% hint style="info" %}
このチュートリアルでは、 `unsloth/Qwen3.6-27B-GGUF` を Unsloth に読み込み、OpenCode 内から直接アクセスします。別のモデルを使いたいですか？ Unsloth に読み込むことで、他のどのモデルにも置き換えられます。
{% endhint %}

### OpenCode Desktop のインストール

{% tabs %}
{% tab title="Windows" %}

{% endtab %}

{% tab title="MacOS" %}
**ステップ1: Mac 用 OpenCode インストーラーをダウンロードする**

開く `opencode.ai/download` をお好みのブラウザで開きます。下へスクロールして **OpenCode Desktop (Beta) 、** を見つけ、 `ダウンロード` ボタンを、Mac のアーキテクチャ（Apple Silicon または Intel）に対応する macOS イメージ名の横でクリックします。

<figure><img src="/files/79168cfee64fef68b382a3f58ca3cb8f4749334d" alt=""><figcaption></figcaption></figure>

ポップアップが表示され、OpenCode インストーラーをどこに保存するか尋ねられます。デフォルト設定のままで問題ありません。 **保存。** これにより、 **OpenCode** インストーラーがあなたの `ダウンロード` フォルダーに保存されます。

<figure><img src="/files/2a44f60971f7bae05aa53d173b59b4038d755cd8" alt=""><figcaption></figcaption></figure>

#### ステップ2: OpenCode をインストールする

ダウンロードフォルダー内の `OpenCode Desktop.dmg` インストーラーファイルを見つけてダブルクリックします。

<figure><img src="/files/48763818b4aa273297da4533063dd35ac643c0e8" alt=""><figcaption></figcaption></figure>

インストーラーウィンドウが開きます。マウスを使って、 **OpenCode** アプリアイコンを **アプリケーション** アイコンの上に、表示のとおりドラッグします。

<figure><img src="/files/8aa857a91023f2bb55c341c4c503b39ee536d0b9" alt=""><figcaption></figcaption></figure>

#### ステップ3: OpenCode を起動する

ダウンロードフォルダー内の **OpenCode** アイコンを **アプリケーション** フォルダーに保存されます。

<figure><img src="/files/ff60c0d0931a954535e4df6fbc1ea83812691e41" alt=""><figcaption></figcaption></figure>

その **OpenCode** デスクトップアプリが開き、次の操作を行う準備が整います。

<figure><img src="/files/f9bb4f3eef10281460c019c427bb6880ed1af78c" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Linux/WSL" %}

{% endtab %}
{% endtabs %}

## Unsloth のインストール

### ⚡ クイックスタート

OpenCode をインストールした後、OpenCode がローカルモデルを提供して推論を実行できるようにするため、Unsloth Studio をインストールする必要があります。

1. **Unsloth Studio をインストールまたは更新します。** 以前のバージョンでは外部 API が公開されません。インストールを参照してください。
2. **Unsloth を起動します。** 起動時のポート番号を確認してください。通常は `8000` または `8888`です。これはターミナル出力とブラウザの URL（`http://localhost:PORT`).
3. **モデルを読み込みます。** クリック **新しいチャット**し、モデル（GGUF）を選ぶか検索して、読み込みが完了するまで待ちます。
4. **API キーを作成します。** Unsloth で、あなたの **Unsloth** 左下のアバター → **設定** → **API** → キー名を入力 → **作成**をクリックします。表示された `sk-unsloth-…` の値をコピーします。Unsloth では一度しか表示されません。
5. **クライアントを Unsloth に向けます。** 使用 `http://localhost:PORT` をベース URL とし、あなたの `sk-unsloth-…` キーを認証に使います。以下のツール別レシピに進んでください。

### 🔑 API キーの作成

1. サイドバーを開き、あなたの **Unsloth** 左下のアバターをクリックします。
2. 移動先 **設定** → **API**.
3. わかりやすい名前を入力します（例: `claude-code-macbook`).
4. *（任意）* 有効期限を設定します。
5. クリック **作成**.
6. **キーはすぐにコピーしてください。** Unsloth はハッシュのみを保存するため、後から再表示することはできません。

<div data-with-frame="true"><figure><img src="/files/2552df3313dace7735a365c0b734bbb215081dd4" alt="" width="375"><figcaption></figcaption></figure></div>

すべてのキーは `sk-unsloth-` プレフィックスで始まります。同じページからいつでもキーを失効できます。失効したキーで行われたリクエストは `401 Unauthorized`.

{% hint style="warning" %}
API キーはパスワードのように扱ってください。キーと Unsloth インスタンスへのネットワークアクセスを持つ者は誰でも、読み込まれたモデルにリクエストを送信できます。
{% endhint %}

## 🖇️ Unsloth を OpenCode Desktop に接続する

**Opencode** は OpenAI 互換の任意のプロバイダーをサポートしているため、Unsloth を **カスタム** プロバイダーとして組み込めます。セットアップは opencode の **プロバイダーを接続** ダイアログ内で一度だけ行うフローです。

**1. プロバイダーピッカーを開きます。** opencode で、 `/model` と入力します（または入力欄の下部にあるモデルセレクターをクリックします）。

<div data-with-frame="true"><figure><img src="/files/64dc1680e765673bbd10b5333da71ae819405b8b" alt=""><figcaption></figcaption></figure></div>

次に、 **プロバイダーを接続** モデル選択ダイアログの右上にある をクリックします。

<div data-with-frame="true"><figure><img src="/files/ea04495ff1b7f0aba3c12b9c25624a6d011546d0" alt="" width="375"><figcaption></figcaption></figure></div>

**2. 「Custom」を選択します。** プロバイダー一覧で、 **その他** までスクロールして選びます。 **カスタム**.

<div data-with-frame="true"><figure><img src="/files/b96ecf4b991c2c0c1c3b2e552e70c9b3085ce8ad" alt="" width="375"><figcaption></figcaption></figure></div>

**3. カスタムプロバイダーフォームに入力します:**

| フィールド         | 値                                                                                |
| ------------- | -------------------------------------------------------------------------------- |
| **プロバイダー ID** | `unsloth-studio` *（小文字、ハイフン使用可）*                                                 |
| **表示名**       | `Unsloth Studio`                                                                 |
| **ベース URL**   | `http://localhost:8888/v1/` *（ `8888` をあなたの* Unsloth *ポートに置き換えてください。末尾の `/v1/`)* |
| **API キー**    | あなたの `sk-unsloth-…` キー                                                           |

「 **モデル** 」セクションで、公開したいモデルごとに1行ずつ追加します。左側のフィールドは Unsloth が提供するモデル ID、右側のフィールドは opencode に表示される名前です:

| モデル ID（左）                                             | 表示名（右）                                           |
| ----------------------------------------------------- | ------------------------------------------------ |
| `unsloth/Qwen3.6-27B-GGUF` *（Studio に表示されるモデルの正確な名前）* | `unsloth/Qwen3.6-27B-GGUF` *（opencode 内に表示されます）* |

「 **ヘッダー** 」は、カスタムヘッダーを必要とする認証レイヤー経由で Unsloth をプロキシしている場合を除き、空のままにしてください。

<div data-with-frame="true"><figure><img src="/files/eae09e6a7d3cf864f60b120c9daa15e0461ea066" alt="" width="375"><figcaption></figcaption></figure></div>

**4. Submit をクリックします。** 次のような *「"Unsloth Studio connected. Unsloth models are now available to use"」* トーストが表示されるはずです。

<figure><img src="/files/76b1046f86f21d02062e9412d800191bdc2cd4e1" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
**プロバイダー追加後に opencode を再起動します。** 新しいプロバイダーは再起動後にのみ選択可能になります。
{% endhint %}

**5. Unsloth モデルを選択します。** opencode が再起動したら、 `/model`と入力し、 `unsloth`を検索して、 **Unsloth Studio** グループの下にあるモデルを選びます。次のメッセージから有効になります。

<div data-with-frame="true"><figure><img src="/files/55d552c4ba0889a3dc3ee69f60efe59ba53d5647" alt="" width="375"><figcaption></figcaption></figure></div>

Unsloth は OpenAI と Anthropic の両方の Python SDK をサポートしています。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://unsloth.ai/docs/jp/tong-he/opencode.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.