> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/jp/tong-he/opencode.md).

# 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="MacOS" %}
**手順 1: Mac 用の OpenCode インストーラーをダウンロードする**

ブラウザで開く `opencode.ai/download` お好みのブラウザで開きます。下にスクロールして **OpenCode Desktop（ベータ）,** を見つけ、 `ダウンロード` 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` ダウンロードフォルダ内のインストーラーファイル。

インストーラーウィンドウが開きます。マウスでドラッグして **OpenCode** アプリアイコンを **アプリケーション** アイコンの上へドラッグします。

#### 手順 3: OpenCode を起動する

以下を見つけてダブルクリックします **OpenCode** の下のアイコン **アプリケーション** フォルダに保存されます。

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

この **OpenCode** デスクトップアプリが開き、次の操作の準備が整いました。

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

## Unslothのインストール

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

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

1. **Unsloth Studio をインストールまたは更新します。** 以前のバージョンでは外部APIが公開されません。「インストール」を参照してください。
2. **Unslothを起動します。** 起動時のポートは通常 `8000` または `8888`です。ターミナル出力とブラウザのURL（`http://localhost:PORT`).
3. **モデルを読み込みます。** クリック **New Chat**、モデル（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にはハッシュのみが保存され、再度表示することはできません。

<figure><img src="/files/56897ad32966d1081797ea8ccf97a7df82f0a550" alt="" width="375"><figcaption></figcaption></figure>

すべてのキーは次のプレフィックスで始まります `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. 「カスタム」を選択します。** プロバイダー一覧で **その他** までスクロールし、 **カスタム**.

<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. 「送信」をクリックします。** 次の *「Unsloth Studio に接続しました。Unsloth モデルが使用可能になりました」* というトースト通知が表示されるはずです。

<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 をサポートしています。

### オプション: サーバーアクセスを設定する

`unsloth run` はローカル API サーバーを起動し、OpenCode が接続するためのモデルを読み込みます。起動時のサーバーの挙動もカスタマイズできます。

```bash
# API をポート 8888 で実行（--disable-tools で OpenCode 自身のツールを透過）
unsloth run \
  --model unsloth/gemma-4-26B-A4B-it-GGUF \
  --disable-tools \
  -p 8888
```

{% hint style="warning" %}
使用します `--disable-tools` OpenCode（または外部のコーディングエージェント）を操作する場合。既定では Unsloth Studio が独自のサーバー側ツールを実行するため、エージェントのツール呼び出しが吸収され、OpenCode は応答してもファイルを編集しません。 `--disable-tools` を透過モードに切り替え、OpenCode 自身のツールが使われるようにします。
{% endhint %}

使用します `-p` サーバーを実行するポートを変更します。

```bash
# ネットワーク上の他のデバイスからの接続を許可する
unsloth run \
  --model unsloth/gemma-4-26B-A4B-it-GGUF \
  -H 0.0.0.0 \
  --disable-tools \
  -p 8888
```

これによりサーバーは `0.0.0.0:8888`で起動し、ローカルネットワーク上の他のデバイスが接続できるようになります。

より高度なランタイム設定については、メインの [API調整](https://unsloth.ai/docs/basics/api#unsloth-run-command) セクションを参照してください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.