> 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 にオープン LLM を接続するためのガイド。

このガイドでは、接続する手順を順に説明します **OpenCode** から [Unsloth](https://github.com/unslothai/unsloth) オープンLLMを実行するために **完全にローカルで。** OpenCodeは **オープンソースのAIコーディングエージェントです** 接続されたモデルを使って、プロジェクト全体のコードを読み取り、変更し、実行します。これは、任意の **ローカルモデル** を、Unslothの **OpenAI互換API**経由で公開されているもので、DeepSeek、Qwen、Gemma などを含みます。

OpenCodeはクライアントとして機能し、UnslothはローカルAPI経由でモデルを読み込み、提供します。セットアップ後、OpenCodeはUnslothに接続し、そこで読み込まれたモデルを選んで **コーディングエージェントとして使用できます**.

このガイドでは、両方のセットアップ方法を扱います：

* **OpenCode Desktop:** Unsloth Studioを、カスタムのOpenAI互換プロバイダーとして手動で追加します。
* **OpenCode CLI:** 次のコマンドで起動します `unsloth start opencode` すると、ローカルモデルに自動で接続します。

<a href="https://unsloth.ai/docs/integrations/opencode#installing-opencode-desktop" class="button primary">OpenCodeのセットアップ</a><a href="/docs/jp/tong-he/opencode.md#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 (Beta) を見つけ、** そして `ダウンロード` Macのアーキテクチャ（Apple SiliconまたはIntel）に対応するmacOSイメージ名の横にあるボタンをクリックします。

#### 手順2: OpenCodeをインストールする

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

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

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

見つけてダブルクリックします **OpenCode** 〜の下にあるアイコン **アプリケーション** フォルダー。

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

<div data-with-frame="true"><figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FZNP4G1c2hmHyBzNbGH5x%2Fopencode_interface.png?alt=media&amp;token=5af679cb-504d-4299-a40e-0d8310289a90" alt="" width="563"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Windows" %}

#### **手順1: Windows用のOpenCodeインストーラーをダウンロードする**

開く `opencode.ai/download` をブラウザーで開きます。までスクロールして **OpenCode Desktop (Beta)**&#x3092;見つけ、 **ダウンロード** Windows (x64) インストーラーの横にあるボタンをクリックします。

#### **手順2: OpenCodeをインストールする**

見つけて `OpenCode Desktop Installer.exe` を Downloads フォルダーで見つけてダブルクリックします。その後、インストーラーウィンドウの指示に従ってインストールを完了してください。

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

Windowsのスタートメニューを開き、次を検索します **OpenCode**.\
\
OpenCodeアプリのアイコンをクリックして起動します。OpenCodeデスクトップアプリが開き、次の操作の準備が整います

<div data-with-frame="true"><figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FLECAvpw6DMNCcuFclzoy%2Fimage.png?alt=media&amp;token=7a628b56-3e0c-4d00-8054-ab8b9317e4f9" alt="" width="563"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Linux" %}

#### **手順1: Linux用のOpenCodeインストーラーをダウンロードする**

次へ移動し、 `opencode.ai/download` お好みのウェブブラウザーを使用してください。次を見つけます **OpenCode Desktop (Beta)** セクションで、お使いのシステムに合ったLinuxのダウンロードオプションを選択します。

#### **手順2: OpenCodeをインストールする**

Downloadsフォルダーを開き、次を見つけます **OpenCode** 先ほどダウンロードしたインストーラーを。

AppImageをダウンロードした場合は、ファイルを右クリックして **プロパティ**を開き、ファイルをプログラムとして実行できるようにするオプションを有効にします。その後、AppImageをダブルクリックして起動します **OpenCode**.

あるいは、ターミナルを使う場合は、次を実行します：

```
chmod +x OpenCode*.AppImage
./OpenCode*.AppImage
```

もし `.deb` ファイルをダウンロードした場合は、次でインストールします：

```
sudo apt install ./OpenCode*.deb
```

もし `.rpm` ファイルをダウンロードした場合は、次でインストールします：

```
sudo dnf install ./OpenCode*.rpm
```

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

Linuxのアプリケーションランチャーを開き、次を検索します **OpenCode**.

OpenCodeアプリのアイコンをクリックして起動します。OpenCodeデスクトップアプリが開き、次の操作の準備が整います。
{% endtab %}
{% endtabs %}

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

OpenCodeをインストールしたら、次に [Unsloth Desktop](/docs/jp/desktop.md) をインストールして、OpenCodeがローカルモデルの提供と推論実行をできるようにします。

{% stepper %}
{% step %}

#### Unslothをダウンロード

最も簡単に始める方法は、Unsloth Desktopアプリをインストールすることです。以下をサポートしています [MacOS](/docs/jp/meru/install/mac.md)、Linux、 [Windows](/docs/jp/meru/install/windows-installation.md), [NVIDIA](/docs/jp/meru/install/pip-install.md), [AMD](/docs/jp/meru/install/amd.md)、IntelおよびCPU構成。

<a href="https://unsloth.ai/download" class="button primary" data-icon="down-to-bracket">Unslothをダウンロード</a>

* <i class="fa-apple">:apple:</i> [macOS用をダウンロード](https://unsloth.ai/download/mac)
* <i class="fa-windows">:windows:</i> [Windows用をダウンロード](https://unsloth.ai/download/windows)
* <i class="fa-linux">:linux:</i> [Linux用をダウンロード](https://unsloth.ai/download/linux)

または、手動インストールを希望する場合：

**MacOS、Linux、WSL：**

```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```

**Windows PowerShell：**

```bash
irm https://unsloth.ai/install.ps1 | iex
```

{% endstep %}

{% step %}

#### インストール

1. Unslothのインストーラーを開き（`.dmg`, `.exe` ファイル）
2. MacではUnslothをApplicationsにドラッグし、Windowsではセットアップを完了します。
3. アプリを起動し、インストールが完了するのを待ちます
   {% endstep %}

{% step %}

#### モデルを選択

上部の「モデルを選択」ドロップダウンまたは「Model hub」タブを開き、デバイスに合うモデルと量子化を選んでからダウンロードします。完了したら、そのままチャットを開始できます。セットアップは不要です。

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FNCEVgKLJI0goPqjgcg9B%2Fmodel%20hub%20models.png?alt=media&amp;token=533b5e3c-a901-4b33-963e-4a703cc9d5a6" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Unsloth の準備ができました

チャットを始めるには、メッセージを入力してEnterキーを押します。

**OpenCodeを接続します。** 実行 `unsloth start opencode`。APIキーを発行し、設定を書き込み、読み込まれたモデルに対してOpenCodeを起動します。

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FpAGvwjGD0iVMZKBoyu7m%2Fgreeennn.png?alt=media&amp;token=d17a5528-8375-444c-9aff-f9e9f7903bcd" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### 🔑 APIキーの作成

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

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FrWnqY5PgvZdbWK8pmlD5%2Fimage.png?alt=media&amp;token=3507e7d7-b552-447f-b503-2418802b8f6e" alt="" width="375"><figcaption></figcaption></figure>

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

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

**OpenCode** はOpenAI互換プロバイダーなら何でもサポートしているので、Unslothを **カスタム** プロバイダーとして接続できます。セットアップはopencodeの **プロバイダーを接続** ダイアログ内で一度だけ行います。

**1. プロバイダー選択画面を開きます。** opencodeで次を入力します `/model` （または入力欄下部のモデルセレクターをクリックします）。

<div data-with-frame="true"><figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fl59D1AVRI57fQBJqgp8t%2Fslash-model.png?alt=media&amp;token=9434f804-6a9e-4b76-ab7e-75cd745fe9c2" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fi9VOd4yRAmLnqZ1D4tBm%2Fconnect%20provider.png?alt=media&amp;token=cb28387a-9cc3-4c5f-928e-82a56edd86df" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FWyltmg0o9YtyydUSLvcn%2Fcustom%20highlighted.png?alt=media&amp;token=5cc89686-dfae-4ebd-8beb-e6dc78088b4b" 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` *（Unslothに表示されるモデル名そのもの）* | `unsloth/Qwen3.6-27B-GGUF` *（opencode内に表示）* |

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

<div data-with-frame="true"><figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FjGU2OaOKRtqCwmO34BuN%2Fopencode_custom_provider_config.png?alt=media&amp;token=6ef67ecf-23e6-4913-bc02-c26701f5aea0" alt="" width="375"><figcaption></figcaption></figure></div>

**4. \[送信] をクリックします。** 次の *「Unsloth Studioに接続しました。Unslothのモデルを使用できるようになりました」* というトースト通知が表示されるはずです。

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FuCOOOJhO8brhEwwIsiUC%2Fopencode_model_available_toast.png?alt=media&amp;token=a463bb0c-724a-4809-9ddb-b7bff094b255" 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="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FFRNofXnF7r7CKlHjLMwv%2Fopencode_unsloth_model_usage.png?alt=media&amp;token=4c882e8f-6ac5-4f9b-8f59-5e86e312851b" alt="" width="375"><figcaption></figcaption></figure></div>

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

### ⚙️ **OpenCode CLI**

OpenCode CLIは、すでにUnsloth Studioで動作しているモデルに接続できます。あるいは、Unslothが起動していない場合に自動でモデルを起動できます。

#### Unsloth Studioがすでに起動している場合

Unsloth Studioでモデルを読み込んだ状態で、プロジェクトフォルダーを開き、次を実行します：

```bash
unsloth start opencode
```

このコマンドを使うと、既存のOpenCode設定を変更せずに、Unslothで現在読み込まれているモデルでOpenCodeを起動します。

#### モデルを自動で起動

Unslothがまだ起動していない場合は、1つのコマンドで一時サーバーを起動し、モデルを読み込めます：

モデルを指定してOpenCodeを直接起動するには、次を実行します：

```bash
unsloth start opencode \\
    --model unsloth/Qwen3.8-27B-GGUF-GGUF:UD-Q4_K_XL
    --temp 1.0 \
    --top-p 0.95 \
    --top-k 20 \
    --min-p 0.0 \
    --reasoning-effort medium
```

Unslothは使用する正しいパラメータを自動で選択しますが、変更することもできます。

<div data-with-frame="true"><figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fom5iWH1f42GZ69utVSyf%2Fimage.png?alt=media&amp;token=815a0458-b252-4c96-a341-e345842bd248" alt="" width="563"><figcaption></figcaption></figure></div>

起動したら **OpenCode** 、次のようなタスクを与えます：

```
ジャンプ、ダッシュ、2つのレベルを備えたFlash風のPython 2Dゲームを作成してください。
```

ローカルモデルを使って、プロジェクトを調査し、ファイルを作成し、コードを編集し、コマンドを実行できます。

<div align="center" data-with-frame="true"><figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FOA6dENYOpJdGa3zwS8Ei%2Fimage.png?alt=media&amp;token=266a85f8-ec80-4a7d-bd58-e82d9ff0b864" alt="" width="563"><figcaption></figcaption></figure></div>

この例では、モデルが2レベルのプラットフォーマーを作成しました。開いて、どのようにできたか見てみましょう。

<div data-with-frame="true"><figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FHqFv9FyPsM0poo5c6WNb%2Fezgif-68bd7a9b463725d0.gif?alt=media&amp;token=abafdfef-6e13-430b-bccb-140f29ee6d13" alt="" width="563"><figcaption></figcaption></figure></div>

#### 作業を再開する

OpenCodeはセッション履歴を自動で保存するため、あなたがする必要はありません `--persist`。Unslothがもう起動していなくても、続きから再開するには次を使います：

```bash
unsloth start opencode \\
  --model unsloth/Qwen3.6-27B-GGUF \
  --continue
```

代わりに特定のセッションを開くには `--session <session-id>`.

完全な [unsloth start](/docs/jp/tong-he/unsloth-start.md) モデルの読み込み、リモートUnslothサーバー、および高度なオプションに関するリファレンスです。

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

`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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
