ドキュメント · ガイド

Shelley を任意のモデルで

Shelley（boldsoftware/shelley）は exe.dev のコーディングエージェントで、shelley serve が動かす Web アプリです。モデルは自分のデータベースにあり、magpie が編集できるファイルではないので、magpie は Shelley 自身のモデルページとプロファイルページが使う API で伝えます。magpie ゲートウェイのカスタムモデルを加え、既定にします。これで Shelley の新しい会話が DeepSeek、GLM、Kimi、Qwen、GPT、ChatGPT サブスクリプションなど magpie の任意のモデルで動きます。

Shelley の設定

  1. 先に Shelley を起動magpie は動いている Shelley に接続します。動いていなければ magpie が shelley serve を起動してやり直すよう知らせます。
  2. magpie の エージェント ページでモデルを選ぶShelley の行には Shelley 自身が使えるモデルと via magpie のモデルがあります。後者を選びます。
  3. 新しい会話を始める新しい会話は既定プロファイルのモデル、つまり今選んだモデルで始まります。
ターミナル
shelley serve                              # Shelley must be running
magpie shelley deepseek/deepseek-v4-pro

magpie が Shelley に伝える方法

Shelley は CLI 用に Unix ソケットを開きます。$SHELLEY_SOCKET、なければ $XDG_CONFIG_HOME/shelley/shelley.sock（既定は ~/.config/shelley、Mac でも同じ）、2 台目のサーバーが最初を取ったときは shelley-2.sock などです。magpie は Shelley の CLI と同じ順に試し、/api/custom-models と /api/profiles を呼びます：

ターミナル
POST /api/custom-models   (over ~/.config/shelley/shelley.sock)
{
  "display_name": "deepseek/deepseek-v4-pro (magpie)",
  "provider_type": "openai",
  "endpoint": "http://127.0.0.1:3425/v1",
  "api_key": "…",
  "model_name": "deepseek/deepseek-v4-pro",
  "reasoning_support": "yes",
  "image_support": "no",
  "max_tokens": …
}

magpie で選んだモデルはそれぞれ、ゲートウェイの /v1 を指す openai タイプのカスタムモデルになり（/chat/completions は Shelley が足します）、キーは magpie が Shelley 専用に発行したものです。Shelley は普段エンドポイントと名前から models.dev で推論と画像の対応を調べますが、magpie のモデルは載っていないので magpie が伝えます。そのうえで既定プロファイルの model をそのモデルにし、推論しないモデルなら Shelley が拒む thinking_level を空にします。

magpie は自分が作ったモデルの id を控えるので、ゲートウェイに向けて手で作ったモデルは自分のもののままです。ゲートウェイのアドレスが変わると magpie が自分のモデルを更新します。

どの会話が変わるか

新しい会話は新しいモデルを使い、開いている会話はモデルメニューで別のものを選ぶまで元のモデルのままです。切り替え後に magpie がそう知らせます。

元に戻す

既定に戻すと、既定プロファイルのモデルと thinking level を接続前に戻し（そのモデルがもう使えなければサーバーの既定に）、magpie が作ったカスタムモデルをすべて削除します。magpie で Shelley 自身のモデルを選んでも戻せます。Shelley がアンインストールされていれば、magpie は記録しておき、次に Shelley が動いたときに削除します。

ターミナル
magpie shelley default

よくある質問

Shelley で DeepSeek、GLM、ChatGPT サブスクリプションを使うには？

shelley serve を起動し、magpie のエージェントページで Shelley に via magpie のモデルを選びます。magpie が magpie ゲートウェイの openai カスタムモデルを Shelley に加え、既定プロファイルのモデルにします。

Shelley isn't running と出るのはなぜですか？

Shelley のモデルはデータベースにあり、magpie は動いている Shelley のソケット経由でしか変えられません。shelley serve を起動してやり直してください。

開いている会話が古いモデルのままです。

既定プロファイルは新しい会話に適用されます。開いている会話はそのモデルメニューで変えてください。

自分のカスタムモデルは消されますか？

いいえ。magpie が消すのは自分が作った id だけで、ゲートウェイに向けて手で作ったモデルも自分のものとして残ります。

同じモデルを他のエージェントでも：AtomCode を任意のモデルで、Reasonix Studio を任意のモデルで、jcode を任意のモデルで。エラーが出るときは よくあるエラーの直し方、または Discord で質問してください。