レシピ集

このページは、設定ファイルを直接編集する上級者向けです。 アプリの画面だけで使いたい方には必要ありません。

ai-sdk-catalog.json のコピペ用スターターです。 ファイルはアプリ設定ディレクトリに置きます。編集は次のトリガーから反映されます。

1 プロバイダー・1 モデル

設定 UI が書くのと同じ形。ほとんどの人はこれで全部です:

{
  "$schema": "https://cdn.jsdelivr.net/npm/ai-sdk-catalog/schema.json",
  "providers": [
    {
      "id": "openai",
      "vendor": { "apiKey": "sk-…" },
      "models": [{ "id": "gpt-5.6-luna" }]
    }
  ],
  "roles": {
    "default": "openai:gpt-5.6-luna"
  }
}

$schema の行は省略できます。JSON Schema を理解するエディタなら、この行があると入力中に検証と補完が効きます。

ローカル Ollama（何も端末の外に出ない）

{
  "providers": [
    {
      "id": "ollama",
      "vendor": { "id": "openai-compatible", "baseURL": "http://localhost:11434/v1" },
      "models": [{ "id": "gemma4:e4b" }]
    }
  ],
  "roles": {
    "default": "ollama:gemma4:e4b"
  }
}

OpenAI 互換エンドポイントなら何でも同じ書き方です。LM Studio、llama.cpp、企業内ゲートウェイのいずれも vendor の baseURL を変えるだけです（必要なら隣に apiKey を足します）。 role の "provider:model" は最初の : で分割されるので、モデル ID にコロンを含む "ollama:gemma4:e4b" もそのまま書けます。

role を 2 つ: 普段は速く、要所は賢く

role はアクションとモデルを疎結合にします。 アクションは role 名だけを持ち（フロントマターに role: smart）、それがどのモデルを意味するかはここで決めます。アクションに触れずにいつでも差し替えられます。

{
  "providers": [
    {
      "id": "google",
      "vendor": { "apiKey": "AIza…" },
      "models": [{ "id": "gemini-3.1-flash-lite" }]
    },
    {
      "id": "anthropic",
      "vendor": { "apiKey": "sk-ant-…" },
      "models": [{ "id": "claude-opus-4-8" }]
    }
  ],
  "roles": {
    "default": "google:gemini-3.1-flash-lite",
    "smart": "anthropic:claude-opus-4-8"
  }
}

ZenCopy 固有の設定はここまでです。 ファイル形式の本家は ai-sdk-catalog です。ゲートウェイやモデル別設定などはそちらに説明があり、examples/ には 3 サイズの設定例が揃っています。