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

ローカルデバイスでOpenCodeとオープンLLMを接続するためのガイド。

このガイドでは、接続する手順を説明します OpenCode Desktop 〜へ Unsloth オープンLLMを実行するための 完全にローカルで。 OpenCodeは オープンソースのAIコーディングエージェント で、接続されたモデルを使ってプロジェクト全体のコードを読み取り、変更し、実行します。 これは、Unslothの ローカルモデル を介して公開された OpenAI互換APIを含む任意のモデルで動作します。DeepSeek、Qwen、Gemma などです。OpenCodeはクライアントとして動作し、UnslothはローカルAPI経由でモデルを読み込み、提供します。

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

OpenCodeのセットアップクイックスタート

このチュートリアルでは、 unsloth/Qwen3.6-27B-GGUF をUnslothで読み込み、OpenCode内から直接アクセスします。別のモデルを使いたいですか？Unslothで別のモデルを読み込めば、任意のモデルに差し替えられます。

OpenCode Desktopのインストール

Windows

MacOS

Linux/WSL

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はハッシュのみを保存するため、再度表示することはできません。

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

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

🖇️ UnslothをOpenCode Desktopに接続する

OpenCode はOpenAI互換の任意のプロバイダーをサポートしているため、Unslothを カスタム プロバイダーとして接続できます。設定はopencodeの プロバイダーを接続 ダイアログ内で一度だけ行う手順です。

1. プロバイダー選択画面を開きます。 opencodeで /model と入力するか、入力欄下部のモデルセレクターをクリックします。

次に プロバイダーを接続 モデル選択ダイアログの右上にある

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

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をカスタムヘッダーが必要な認証レイヤー経由でプロキシしていない限り、空のままにします。

4. Submitをクリックします。 次の 「Unsloth Studioに接続しました。Unslothモデルを使用できるようになりました」 トーストが表示されるはずです。

プロバイダーを追加した後、opencodeを再起動します。 新しいプロバイダーは再起動後にのみ選択可能になります。

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

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

オプション：サーバーアクセスを設定

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

# APIをポート8888で実行
unsloth run \\
  --model unsloth/gemma-4-26B-A4-B-it-GGUF \\
  -p 8888

を -p でサーバーの実行ポートを変更します。

# ネットワーク上の他のデバイスから接続できるようにする
unsloth run \\
  --model unsloth/gemma-4-26B-A4-B-it-GGUF \\
  -H 0.0.0.0 \\
  -p 8888

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

より高度なランタイム設定については、メインの APIチューニング セクションを参照してください。