OpenCodeでローカルAIモデルを実行する方法
ローカルデバイスでOpenCodeとオープンLLMを接続するためのガイド。
このガイドでは、接続する手順を説明します OpenCode Desktop 〜へ Unsloth オープンLLMを実行するための 完全にローカルで。 OpenCodeは オープンソースのAIコーディングエージェント で、接続されたモデルを使ってプロジェクト全体のコードを読み取り、変更し、実行します。 これは、Unslothの ローカルモデル を介して公開された OpenAI互換APIを含む任意のモデルで動作します。DeepSeek、Qwen、Gemma などです。OpenCodeはクライアントとして動作し、UnslothはローカルAPI経由でモデルを読み込み、提供します。
セットアップ後、OpenCodeはUnslothに接続され、読み込まれたモデルを選択して コーディングエージェント.
このチュートリアルでは、 unsloth/Qwen3.6-27B-GGUF をUnslothで読み込み、OpenCode内から直接アクセスします。別のモデルを使いたいですか?Unslothで別のモデルを読み込めば、任意のモデルに差し替えられます。
OpenCode Desktopのインストール
ステップ1:Mac用のOpenCodeインストーラーをダウンロード
開いて opencode.ai/download をお使いのブラウザで開き、下にスクロールして OpenCode Desktop(ベータ) を見つけて ダウンロード ボタンを、お使いのMacのアーキテクチャ(Apple SiliconまたはIntel)に対応するmacOSイメージ名の横でクリックします。

ポップアップが表示され、OpenCodeインストーラーをどこに保存するか尋ねられます。既定値のままで問題ありません。次をクリックしてください 保存。 これにより OpenCode インストーラーが Downloads フォルダに保存されます。

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

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

ステップ3:OpenCodeを起動
ダウンロードフォルダ内の OpenCode の下にあるアイコン Applications フォルダに保存されます。

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

Unslothのインストール
⚡ クイックスタート
OpenCodeをインストールした後、OpenCodeがローカルモデルを提供し、推論を実行できるようにするために、Unsloth Studioをインストールする必要があります。
Unsloth Studioをインストールまたは更新します。 以前のバージョンでは外部APIが公開されません。インストールを参照してください。
Unslothを起動します。 起動時のポート番号は通常
8000または8888です。ターミナル出力とブラウザのURL(http://localhost:PORT).モデルを読み込みます。 クリックして New Chatを押し、モデル(GGUF)を選ぶか検索して、読み込みが完了するのを待ちます。
APIキーを作成します。 Unslothで、左下の Unsloth アバター → 設定 → API → キー名を入力 → 作成をクリックします。表示される
sk-unsloth-…の値をコピーします。Unslothで表示されるのは一度だけです。クライアントをUnslothに向けます。 を
http://localhost:PORTベースURLとして、またあなたのsk-unsloth-…キーを認証に使います。以下のツールの手順へ進んでください。
🔑 APIキーの作成
サイドバーを開き、左下の Unsloth アバターをクリックします。
へ移動して 設定 → API.
わかりやすい名前を入力します(例:
claude-code-macbook).(任意) 有効期限を設定します。
クリックして 作成.
キーをすぐにコピーします。 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に表示される内容です:
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が接続するためのモデルを読み込みます。起動時のサーバー動作もカスタマイズできます。
を -p でサーバーの実行ポートを変更します。
これによりサーバーが 0.0.0.0:8888で起動し、ローカルネットワーク上の他のデバイスが接続できるようになります。
より高度なランタイム設定については、メインの APIチューニング セクションを参照してください。
最終更新
役に立ちましたか?

