ドキュメント · ガイド

Alma を任意のモデルで

Alma はデスクトップの AI チャットアプリで、プロバイダーと設定はアプリの中にあり、magpie が編集できるファイルにはありません。magpie は Alma が起動中に提供するローカル API で magpie という名前のプロバイダーを加えて既定モデルにします。これで Alma が DeepSeek、GLM、Kimi、Qwen、Claude、ChatGPT サブスクリプションなど magpie の任意のモデルで動きます。

Alma の設定

  1. magpie にプロバイダーを追加プロバイダー ページで API キーを追加するか、サブスクリプションにサインインします。
  2. Alma を開くmagpie は起動中の Alma を通してだけ設定を変えられます。開いていないときは、Alma を開いてもう一度試すよう magpie が伝えます。
  3. エージェント ページで Alma のモデルを選ぶvia magpie のモデルを選ぶと、Alma の既定モデルになります。
ターミナル
magpie alma deepseek/deepseek-v4-pro

Alma のローカル API で

Alma は起動中に http://localhost:23001 でローカル API を提供し、magpie はそれを使います：

ターミナル
GET  /api/providers              Alma のプロバイダー
POST /api/providers              magpie のプロバイダー
PUT  /api/providers/:id/models   モデル一覧
GET  /api/settings, PUT it back  chat.defaultModel, imageGen.model

magpie のプロバイダーは種類 openai で、ゲートウェイの /v1 を指し、magpie の Alma 専用キーを使います。Alma のリクエストには AI SDK の User-Agent しかないので、ゲートウェイはこのキーで Alma のものと見分けます。既定モデルは chat.defaultModel に providerId:model の形で入ります。Alma は設定を丸ごとしか受け付けないので、magpie は残りの設定をそのまま書き戻します。

モデルと思考レベル

Alma はモデルの能力を models.dev からモデル id で割り出しますが、magpie の id（codex/gpt-5.5）は models.dev にないので、思考なしと表示されてしまいます。そこで magpie は各モデルの能力を Alma に伝えます。推論するモデルには Alma が知る思考レベルを、分かる場合はコンテキストウィンドウ、出力上限、画像対応も付けます。Alma のモデルオプションで自分で設定したもの（ツール呼び出し）はそのまま残ります。magpie でのモデルの追加や削除は、Alma が開いているときに反映されます。

画像生成

magpie に画像モデルがあり、Alma の画像生成モデルが自動のとき、Alma に magpie のモデルを選ぶと magpie の画像モデルが Alma の画像生成モデルにもなります。自分で選んだ画像モデルは変わりません。

元に戻す

元に戻すと、Alma の既定モデルが magpie のものなら空にして Alma に任せ、magpie の画像生成モデルを自動に戻し、magpie のプロバイダーを外します。Alma がアンインストールされていた場合は magpie が覚えておき、Alma が再インストールされて応答したときにプロバイダーを外します。

ターミナル
magpie alma default

よくある質問

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

使えます。Alma を開き、magpie のエージェントページで Alma に via magpie のモデルを選ぶと、magpie プロバイダーが加わり既定モデルになります。

「Alma isn't running」と出ます。

Alma の設定は起動中に提供されるローカル API でしか変えられません。Alma を開いてもう一度試してください。

Alma で magpie のモデルに思考レベルがあるのはなぜですか？

magpie が各モデルの能力、つまり推論するか、思考レベル、コンテキストウィンドウを Alma に伝えるからです。

元に戻すとどうなりますか？

magpie のプロバイダーが外れ、magpie の既定モデルは空になって Alma が選び、画像生成モデルは自動に戻ります。

同じモデルを他のデスクトップアプリでも：Kun を任意のモデルで、magpie で Cherry Studio にすべてのモデルを、OpenHanako を任意のモデルで、OpenPencil を任意のモデルで。エラーが出るときは よくあるエラーの直し方、または Discord で質問してください。