ドキュメント
Zed
Zedではsettings.jsonでOpenAI互換プロバイダーを宣言し、キーはAgent Panelから別途入力します。models配列は任意の補助情報ではなく、Zedが認識するモデル一覧そのものです。
settings.jsonのlanguage_models.openai_compatibleブロックでエンドポイントとモデルを宣言します。キーはAgent Panel UIに入力し、ファイルには記載しません。
{
"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
}
]
}
}
}
}settings.jsonは同期・共有されるため、キーを記載するとファイルと一緒に共有されます。available_modelsがカタログ全体です。OpenAI互換プロバイダーではモデル一覧を取得するAPI呼び出しがないため、リストにないモデルは選択肢に表示されません。使用するIDごとにエントリーを追加し、max_tokensにはそのモデルの実際のコンテキストウィンドウを設定してください。sk-kn-で始まります)。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Zed設定が表示されます。手順
/app/keysでキーを作成してコピーします。キーは一度だけ表示されます。- コマンドパレットからzed: open settingsを実行して
settings.jsonを開き、上記のブロックを追加します。 - Agent Panelの設定を開き、キーとして使用した名前(ここでは
kunavo)のプロバイダーを探して、そこにAPIキーを貼り付けます。 - Agent Panelのモデル選択メニューでモデルを選びます。表示されるのは
display_nameで、送信されるのはnameです。 - 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で、入力 / 出力の順です。
| モデル ID | Kunavo 入力 / 出力 | 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におけるデフォルト値であり、ファーストパーティプロバイダーと同じようにエージェントを利用できます。