> 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** に [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="/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 (Beta) を見つけ、** 次の `ダウンロード` ボタンを、お使いの Mac のアーキテクチャ（Apple Silicon または Intel）に対応する macOS イメージ名の横でクリックします。

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

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

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

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

次を見つけてダブルクリックします **OpenCode** の下にあるアイコンを **Applications** フォルダ内で

この **OpenCode** デスクトップアプリが開き、次の操作を行える状態になります。

<div data-with-frame="true"><figure><img src="/files/f9bb4f3eef10281460c019c427bb6880ed1af78c" alt="" width="563"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Windows" %}

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

開く `opencode.ai/download` ブラウザーで開き、次へスクロールします **OpenCode Desktop (Beta)**、そして次の **ダウンロード** ボタンを Windows (x64) インストーラーの横でクリックします。

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

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

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

Windows のスタートメニューを開き、次を検索します **OpenCode**。\
\
OpenCode のアプリアイコンをクリックして起動します。OpenCode デスクトップアプリが開き、次の操作を行える状態になります

<div data-with-frame="true"><figure><img src="/files/469838916993568abcd7086c36580bd7b3212143" alt="" width="563"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Linux" %}

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

移動します `opencode.ai/download` お好みの Web ブラウザーを使って開き、次を見つけます **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 %}

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

OpenClaw をインストールしたら、次をインストールする必要があります [Unsloth Desktop](/docs/jp/desktop.md) これにより、OpenClaw がローカルモデルを提供し、推論を実行できるようになります。

{% stepper %}
{% step %}

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

始める最も簡単な方法は、Unsloth デスクトップアプリをインストールすることです。対応環境は [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をアプリケーションにドラッグし、Windowsではセットアップを完了してください。
3. アプリを起動し、インストール完了を待ちます
   {% endstep %}

{% step %}

#### モデルを選択

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

<figure><img src="/files/158354856e78d615be54ae9d6435c9ce561b7d4e" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Unslothの準備が整いました

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

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

<figure><img src="/files/e80de67ed3ea23603ff90d3a5750d20c31d2e56d" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

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

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

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

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

<div data-with-frame="true"><figure><img src="/files/64dc1680e765673bbd10b5333da71ae819405b8b" alt="" width="563"><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-…` はそのまま残します）                                                 |

「 **Models** 」セクションでは、公開したいモデルごとに 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="/files/eae09e6a7d3cf864f60b120c9daa15e0461ea066" alt="" width="375"><figcaption></figcaption></figure></div>

**4. 「Submit」をクリックします。** 次の表示が出るはずです *「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 をサポートしています。

### ⚙️ **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 \
    --chat-template-kwargs '{"reasoning_effort":"medium"}'
```

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

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

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

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

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

<div align="center" data-with-frame="true"><figure><img src="/files/abeee508e2e790d9d2e9371860830490f787c6db" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/74fdab8b8c739fb03ec56b67e519a663bf6d6b66" 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 サーバー、高度なオプションに関するリファレンスです。&#x20;

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

`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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.