ドキュメント

ドキュメント

Zed

Zedではsettings.jsonでOpenAI互換プロバイダーを宣言し、キーはAgent Panelから別途入力します。models配列は任意の補助情報ではなく、Zedが認識するモデル一覧そのものです。

settings.jsonのlanguage_models.openai_compatibleブロックでエンドポイントとモデルを宣言します。キーはAgent Panel UIに入力し、ファイルには記載しません。

~/.config/zed/settings.json
{
  "language_models": {
    "openai_compatible": {
      "kunavo": {
        "api_url": "https://api.kunavo.com/v1",
        "available_models": [
          {
            "name": "claude-sonnet-5",
            "display_name": "Claude Sonnet 5",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": { "tools": true, "images": true }
          },
          {
            "name": "claude-haiku-4-5",
            "display_name": "Claude Haiku 4.5",
            "max_tokens": 200000
          }
        ]
      }
    }
  }
}
APIキーはこのファイルに保存しません。Zedのドキュメントには、Agent Panelのプロバイダー設定に入力するか、プロバイダー名からZedが生成する環境変数を設定するよう明記されています。settings.jsonは同期・共有されるため、キーを記載するとファイルと一緒に共有されます。
Zedにとってavailable_modelsがカタログ全体です。OpenAI互換プロバイダーではモデル一覧を取得するAPI呼び出しがないため、リストにないモデルは選択肢に表示されません。使用するIDごとにエントリーを追加し、max_tokensにはそのモデルの実際のコンテキストウィンドウを設定してください。
まだキーをお持ちですか?Kunavoアカウントを作成し、キーを作成します(sk-kn-で始まります)。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Zed設定が表示されます。

手順

  1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
  2. コマンドパレットからzed: open settingsを実行してsettings.jsonを開き、上記のブロックを追加します。
  3. Agent Panelの設定を開き、キーとして使用した名前(ここではkunavo)のプロバイダーを探して、そこにAPIキーを貼り付けます。
  4. Agent Panelのモデル選択メニューでモデルを選びます。表示されるのはdisplay_nameで、送信されるのはnameです。
  5. Zedのデフォルトと異なるcapabilitiesのみを上書きしてください。デフォルトではtools: trueで、画像と並列ツール呼び出しはオフです。

ZedのAPIアクセスに関するドキュメントで2026年9月6日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

クライアントをデバッグする前に確認すること

1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーがZedで機能します。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

フィールドに入力するモデルID

すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。

モデル IDKunavo 入力 / 出力Zedでの位置付け
claude-sonnet-5$1.40 / $7.00エージェントのデフォルト — ツールと画像が有効
claude-opus-5$3.50 / $17.50計画が処理速度より重要な、大規模なリファクタリング
claude-haiku-4-5$0.70 / $3.50インライン補助とすばやい編集
gpt-5-6-terra$0.70 / $4.20同じプロバイダーエントリー内に追加する2つ目のファミリー
請求は月額料金なしの前払い残高からトークン単位で行われます — 請求を参照してください。繰り返し送られるコンテキスト(エディターやチャットクライアントが送る内容の大半)では、プロンプトキャッシュのほうがモデル選択より請求額を大きく左右します。

よくある質問

ZedにOpenAI互換プロバイダーを追加するにはどうすればよいですか?

settings.jsonにlanguage_models.openai_compatibleブロックを追加します。キーにはプロバイダー名を指定し、api_urlにはエンドポイントの /v1 ルートを指定します。available_models配列には、使いたい各モデルIDを列挙してください。その後、Agent Panelのプロバイダー設定を開き、そこにAPIキーを入力します。Zedのドキュメントには、キーをsettings.jsonに保存しないよう明記されています。

Zedのモデル選択メニューにモデルが表示されないのはなぜですか?

available_modelsに含まれていないためです。ZedはOpenAI互換エンドポイントにモデルカタログを問い合わせないため、settings.jsonの配列がそのプロバイダーで利用できるモデルの完全な一覧です。モデルのIDをnameに、選択メニューに表示する名前をdisplay_nameに指定したエントリーを追加し、max_tokensには実際のコンテキストウィンドウを設定してください。

ZedはカスタムプロバイダーのAPIキーをどこに保存しますか?

Agent Panelのプロバイダー設定UI、またはプロバイダー名からZedが生成する環境変数に保存します。settings.jsonには保存しません。設定ファイルは持ち運びや共有を前提としている一方、キーはそうではないため、Zedは意図的に認証情報をファイルの外部で管理します。

Zedはカスタムエンドポイント経由でClaudeモデルを利用できますか?

はい。openai_compatibleプロバイダーはモデル名をそのままapi_urlに渡すため、Claude IDの解決はZedではなくエンドポイントが行います。ツール呼び出しに対応するモデルではcapabilities.toolsをtrueに設定してください。これはこのプロバイダータイプのZedにおけるデフォルト値であり、ファーストパーティプロバイダーと同じようにエージェントを利用できます。