ドキュメント · ガイド

Lody を任意のモデルで

Lody は Claude Code、Codex、Pi、dsh、Kimi Code、Grok、Bub などのコーディングエージェントを動かすデスクトップアプリです。プロバイダーは自身のインポートリンクから、確認ダイアログを経て追加します。magpie はそのリンクを渡し、magpie を Magpie という 1 つのカスタムプロバイダーとして、プロトコル別の 3 つのエンドポイントで対応するすべてのランタイムに提供します。確認すると、Lody のこれらのエージェントが magpie の任意のモデル（DeepSeek、GLM、Kimi、Qwen、OpenAI や Anthropic のキー、サインインした ChatGPT や Copilot のサブスクリプション）で動きます。

Lody に magpie を追加

Lody を一度開くLody が一度動くとホームフォルダー ~/.lody（OSS 版は ~/.lody-oss）かデータフォルダー（Mac では ~/Library/Application Support/Lody）ができ、magpie のエージェントページに出ます。Lody OSS と Lody Nightly も対象です。
magpie にプロバイダーを追加プロバイダーページで API キーを追加するか、サブスクリプションにサインインします。
「magpie を追加」をクリックLody の行で magpie を追加をクリックすると、magpie がインポートリンクを Lody に渡します。
Lody で確認するLody がローカルプロバイダーの確認ダイアログを出し、確認するまで何も追加されません。その後、Lody で各エージェントに Magpie プロバイダーのモデルを選びます。

ターミナル

magpie lody add      # Lody を開いて magpie を追加し、そこで確認

この行は追加済みと表示しません。Lody には公開の状態 API がなく、magpie はクリックや生成ファイル、Lody の非公開データから推測しません。必要ならもう一度クリックしてください。

リンクの中身

リンクの data は base64url でエンコードした JSON で、解くとこうなります：

ターミナル

lody://provider/import?v=1&data=
{
  "kind": "custom", "id": "magpie", "name": "Magpie",
  "auth": {"method": "apiKey", "apiKey": "…"},
  "endpoints": [
    {"protocol": "anthropic-messages", "baseUrl": "http://127.0.0.1:3425",
     "targets": ["claude-code"], "modelsUrl": "http://127.0.0.1:3425/v1/models"},
    {"protocol": "openai-responses", "baseUrl": "http://127.0.0.1:3425/v1",
     "targets": ["codex"], "modelsUrl": "http://127.0.0.1:3425/v1/models"},
    {"protocol": "openai-chat", "baseUrl": "http://127.0.0.1:3425/v1",
     "targets": ["pi", "dsh", "kimi-code", "grok", "bub"],
     "modelsUrl": "http://127.0.0.1:3425/v1/models"}
  ]
}

Claude Code はゲートウェイそのものに Anthropic Messages で、Codex は OpenAI Responses で、Pi、dsh、Kimi Code、Grok、Bub は OpenAI Chat で、いずれもゲートウェイの /v1 に話します。モデル一覧はどれもゲートウェイの /v1/models から取ります。

ループバックアドレスのみ

Lody はループバックアドレス（127.0.0.1、localhost、::1）上の HTTP と、キーとしては公開の帰属トークンだけを受け付け、LAN のキーやベンダーの認証情報は受け付けません。そのためゲートウェイがループバック上にないとき（magpie のアドレスを LAN のものにしたときなど）、magpie は Lody を開かず理由を伝えます。

Linux の Lody

macOS と Windows では Lody のアプリとインストーラーが自分で lody:// を登録するので、magpie はリンクを開くだけです。Linux では Lody の AppImage が自分のチャンネルのスキームだけを既定にし、lody:// はデスクトップデータベースに任せますが、update-desktop-database を実行しないと誰も作らないため、xdg-open やブラウザーはリンクを断ります（「failed to open uri」）。そこで Linux では、magpie が Lody のデスクトップエントリー（ai.lody.desktop、Nightly 版や OSS 版のもの）のコマンドどおりにリンク付きで Lody を起動します。既に動いている Lody がリンクを受け取り、2 つ目はすぐ終了します。Lody のエントリーがなければシステムに渡します。

使用量とキー

リンクのキーは Lody 専用なので、そのリクエストは magpie の使用量で他のエージェントとは別に Lody として数えられます。

よくある質問

Lody の Claude Code で DeepSeek や GLM を使えますか？

はい。Lody に magpie を追加すると、Claude Code は Magpie プロバイダーの Anthropic エンドポイント経由で DeepSeek や GLM を含む magpie の任意のモデルを使えます。Codex、Pi、Kimi Code なども同じです。

Lody はループバックアドレスのみと出るのはなぜですか？

Lody はループバック上の HTTP プロバイダーしか受け付けません。magpie のゲートウェイアドレスを 127.0.0.1 か localhost に戻してから、もう一度 magpie を追加してください。

Linux で「magpie を追加」が failed to open uri になります。

xdg-open が lody:// の処理プログラムを見つけられていません。magpie はデスクトップエントリーから Lody を直接起動します。それでも駄目なら Lody を一度開いてエントリーを書かせてから、もう一度クリックしてください。

Lody の行が追加済みと表示されないのはなぜですか？

Lody には公開の状態 API がなく、magpie は推測しません。一度確認すれば、Lody のプロバイダー一覧に Magpie があります。

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