ドキュメント · ガイド

Kun を任意のモデルで

Kun(KunAgent)はローカルファーストの AI ワークベンチです。デスクトップアプリ(Code、Work、チャット、エージェント)と kun TUI は、どちらも一つのランタイム kun serve のクライアントです。モデルはランタイムのモデル接続から来ます。magpie が自分の接続を加えて既定にすると、Kun が DeepSeek、GLM、Kimi、Qwen、Claude、ChatGPT サブスクリプションなど magpie の任意のモデルで動き、デスクトップアプリでも TUI でも同じです。

Kun の設定

  1. magpie にプロバイダーを追加プロバイダー ページで API キーを追加するか、サブスクリプションにサインインします。
  2. Kun を開くmagpie は起動中の Kun を通して接続を加えます。下で説明します。
  3. エージェント ページで Kun のモデルを選ぶvia magpie のモデルを選ぶと、Kun の既定モデルになります。
ターミナル
magpie kun deepseek/deepseek-v4-pro

Kun 自身の API で

Kun は接続をデータフォルダー($KUN_DATA_DIR、なければ ~/.kun/data)の model-connections.v2.json に、接続のキーを保護された資格情報ストアに置くので、ファイルに手で書くことはできません。magpie は Kun 自身の 設定 › プロバイダー や kun provider コマンドと同じく、ランタイムの管理 API で接続を加え、外します:

ターミナル
GET    /v1/model-connections              接続の一覧とリビジョン
POST   /v1/model-connections/connect      magpie の接続
PATCH  /v1/model-connections/magpie       モデル一覧
POST   /v1/model-connections/select       Kun の既定モデル
DELETE /v1/model-connections/magpie       元に戻す

アドレスとトークンはデータフォルダーの runtime.json から取ります。magpie の接続 magpie はゲートウェイの /v1 への HTTP 接続で、Chat Completions で話し、magpie の Kun 専用キーを使います。magpie は接続の id を覚えているので、Kun で magpie-2 に名前を変えても magpie のものと分かります。

モデル一覧

接続のモデルは、magpie のエージェントページで Kun に選んだモデルで、最大 500 個です。そこでの追加や削除、ゲートウェイのポート変更も接続に反映されます。

Kun を起動しておく

Kun は起動中にだけモデルプロバイダーを加えたり変えたりできます。起動していないときは、Kun を開いてもう一度試すよう magpie が伝えます。

元に戻す

magpie は最初に入るとき Kun の元の既定モデルを控えます。元に戻すとその既定を選び直してから、magpie の接続を外します。戻る先になる自分のプロバイダーが Kun にないときは、Kun の 設定 › プロバイダー で追加するよう案内します。

ターミナル
magpie kun default

よくある質問

Kun で DeepSeek、GLM、ChatGPT サブスクリプションを使えますか?

使えます。Kun を開き、magpie のエージェントページで Kun に via magpie のモデルを選ぶと、magpie のモデル接続が加わり既定になります。

「open Kun, then try again」と出ます。

Kun は起動中にだけプロバイダーの変更を受け付けます。Kun のデスクトップアプリか kun serve を起動して、もう一度試してください。

kun TUI でも使えますか?

使えます。デスクトップアプリと kun TUI はどちらも kun serve のクライアントで、同じモデル接続を使います。

元に戻すと既定モデルも戻りますか?

戻ります。magpie が控えた元の既定を選び直してから、接続を外します。

同じモデルを他のデスクトップアプリでも:OpenHanako を任意のモデルで、DS Bot を任意のモデルで、Tuanjie Cowork を任意のモデルで、Alma を任意のモデルで。エラーが出るときは よくあるエラーの直し方、または Discord で質問してください。