> 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/lian-xie/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/lian-xie/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)、** そして `「Download」をクリックします` 。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="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)**、そして **「Download」をクリックします** 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` お好みのWebブラウザを使って。次の **OpenCode Desktop (Beta)** セクションを見つけ、システムに合ったLinuxのダウンロードオプションを選択します。

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

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

AppImageをダウンロードした場合は、ファイルを右クリックして **「Properties」**&#x3092;開き、ファイルをプログラムとして実行できるようにするオプションを有効にします。その後、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 %}

#### モデルを選択

「Select model」ドロップダウンまたは「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. 次へ移動します： **設定** → **API**.
3. わかりやすい名前を入力します（例： `claude-code-macbook`).
4. *（任意）* 有効期限を設定します。
5. クリック **作成**.
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」を選択します。** プロバイダー一覧で次までスクロールし： **Other** を選びます： **カスタム**.

<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-…` キー                                                           |

次の **Models** セクションで、公開したいモデルごとに1行ずつ追加します。左の欄はUnslothが提供するモデルID、右の欄はopencodeに表示される名前です：

| モデルID（左）                                             | 表示名（右）                                      |
| ---------------------------------------------------- | ------------------------------------------- |
| `unsloth/Qwen3.6-27B-GGUF` *（Unslothに表示されるモデル名そのもの）* | `unsloth/Qwen3.6-27B-GGUF` *（opencode内に表示）* |

次は空欄のままにします： **Headers** 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. 「Submit」をクリックします。** 次の表示が出るはずです： *「Unsloth Studio connected. Unsloth models are now available to use」* というトースト通知。

<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がまだ起動していない場合は、一つのコマンドで一時サーバーを起動し、モデルを読み込めます：

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/lian-xie/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 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/lian-xie/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.
