Zed

Zed では、サードパーティーの OpenAI 互換サービスを language_models.openai_compatible.<provider> の下に設定します。このガイドではプロバイダー ID に getrouter を使用します。

連携ステータス
  • プロトコル: OpenAI 互換(デフォルトは Chat Completions)
  • 設定確認日: 2026年7月15日
  • 実行時検証: Pending(未検証)

1. API キーを保存する

agent: open settings で Zed の Agent Settings を開き、getrouter という名前の OpenAI 互換プロバイダーを追加または選択して、Zed の認証情報 UI に YOUR_API_KEY を保存します。UI で管理する認証情報は settings.json ではなく、システムのキーチェーンに保存されます。

または、Zed を起動する前に、プロバイダー ID から生成される環境変数を設定します。

export GETROUTER_API_KEY="YOUR_API_KEY"

2. プロバイダーとモデルを設定する

Zed の settings.json を開き、次のテンプレートをマージします。

{
  "language_models": {
    "openai_compatible": {
      "getrouter": {
        "api_url": "https://getrouter.ai/v1",
        "available_models": [
          {
            "name": "MODEL_ID",
            "display_name": "GetRouter Model",
            "max_tokens": MODEL_MAX_TOKENS
          }
        ]
      }
    }
  }
}

MODEL_MAX_TOKENS はテンプレート用のマーカーであり、そのまま使える JSON 値ではありません。保存する前に、選択したモデルの実際のコンテキストウィンドウ上限を表す整数に置き換えてください。別のモデルの上限をコピーしたり推測したりしないでください。

この構造は、Zed 公式の OpenAI 互換エンドポイント設定 に準拠しています。

3. 確認する

Agent Panel を開き、GetRouter Model を選択して、短いプレーンテキストの Prompt を送信します。基本的なチャットが成功したら、選択したモデルが対応している場合に限り、編集機能とツール機能を試してください。このガイドでは、まだ実際の動作確認を行っていません。

トラブルシューティング

  • モデルが表示されない: openai_compatible.getrouter.available_models の階層を確認し、保存前に MODEL_MAX_TOKENS を整数へ置き換えてください。
  • 認証情報が見つからない: プロバイダー ID getrouterGETROUTER_API_KEY に対応します。Zed のプロバイダー UI にキーを保存するか、環境変数を設定した後に Zed を再起動してください。
  • 401 が返る: ローカルの Zed プロセスが対象の認証情報を読み取れることを確認してください。
  • Agent またはツールが失敗する: 選択したモデルの機能を確認し、実際のコンテキストウィンドウ上限を指定してください。