メインコンテンツへスキップ
Zed は settings.json 内の二つの独立したプロバイダースロット language_models.openai_compatible と language_models.anthropic_compatible を通じてカスタムモデルを呼び出せます。どちらともカスタム api_url を受け付けるため、Zed は Tokios の両面、つまり https://api.tokios.com/v1 の OpenAI 互換エンドポイントと https://api.tokios.com の Anthropic 互換エンドポイントを紹介するのに最適な場所です。どちらか一方を選ぶか、両方を設定してアシスタントごとに切り替えられます。

Prerequisites

  • ローカルモデルとペアリング済みの Tokios コネクタ — 詳細は Connector install
  • 登録済みのモデルデプロイメント名 — 詳細は Register a model
  • Tokios API キー(sk-tok-…) — 詳細は API Keys
  • Zed がインストール済みであること

Option A: OpenAI-compatible provider

1

Open Zed's settings.json

コマンドパレットを開いて zed: open settings を実行するか、settings.json を直接編集します。
2

Add an openai_compatible entry

Tokios のベース URL、デプロイメント名、API キーを含む language_models.openai_compatible ブロックを追加します。
settings.json
ここでは gemma-tunnel を公開デプロイメント名に置き換えてください。この名前はModelsタブで登録したものです — Ollama/llama.cpp/vLLM/LM Studio のローカルモデル ID ではありません。キーは意図的にここに含まれていません。次のステップを参照してください。
3

Set your API key outside settings.json

Zed は settings.json から API キーを読み取りません。sk-tok-… キーは以下のいずれかで指定します。
  • Through the UI — コマンドパレットから agent: open settings を実行し、LLM Providers の下にある Tokios を見つけてキーを貼り付けます。Zed はシステムキーチェーンに保存します。
  • Through an environment variable — Zed は settings.json のプロバイダー ID から変数名を派生させます。大文字のスネークケースで _API_KEY が付加されます。上記の ID Tokios は TOKIOS_API_KEY になります。
空でない環境変数はキーチェーンの値より優先されます。後で UI フローに切り替える場合は unset してください。
4

Select the model in the assistant panel

Zed のアシスタントパネルを開き、モデルピッカーから Tokios: gemma-tunnel(または設定した display_name)を選択します。

Option B: Anthropic-compatible provider

1

Add an anthropic_compatible entry

同じ settings.json に language_models.anthropic_compatible ブロックを追加し、Tokios Anthropic 互換エンドポイントを指します。このベース URL にはno /v1 です。
settings.json
ここでは gemma-tunnel を公開デプロイメント名に置き換えてください。この名前はModelsタブで登録したものです — Ollama/llama.cpp/vLLM/LM Studio のローカルモデル ID ではありません。
2

Set your API key outside settings.json

Option A と同じ方法で sk-tok-… キーを指定します。
  • Through the UI — コマンドパレットから agent: open settings を実行し、Anthropic 互換セクションの LLM Providers の下にある Tokios を見つけてキーを貼り付けます。Zed はシステムキーチェーンに保存します。
  • Through an environment variable — Option A と同じ TOKIOS_API_KEY 変数が両方のプロバイダースロットをカバーします。どちらの場合もプロバイダー ID は Tokios だからです。
3

Select the model in the assistant panel

Zed のアシスタントパネルを開き、モデルピッカーから Tokios (Anthropic): gemma-tunnel(または設定した display_name)を、OpenAI 互換のものと併せて、または代わりに選択します。
ここでは gemma-tunnel を登録したデプロイメント名に置き換え、sk-tok-YOUR_KEY を自分のキーに置き換えてください。どちらも共有またはバージョン管理された settings.json にコミットしないでください。
両方のプロバイダーを同時に設定し、別のエントリとして保持できます。一方は https://api.tokios.com/v1(OpenAI 互換)を、もう一方は https://api.tokios.com(Anthropic 互換)を指し、モデルピッカーから切り替えて同じ基盤デプロイメントに対する動作を比較できます。

Why this works without a tunnel

どちらの Zed プロバイダースロットも、Zed のモデルリクエストの発信元から到達可能な URL を必要とします。Tokios のコネクタはアウトバウンド専用です。モデルの隣から外向きに接続し、インバウンドポートを開かないため、https://api.tokios.com(または /v1)は一度設定すれば安定する認証済み URL です。ngrok プロセスを稼働し続ける必要も、LAN に未認証ポートを開いておく必要もありません。

Troubleshooting

Zed が送信した API キーが見つからない、形式が不正、または無効化されています。sk-tok-… キー全体が余分な空白なしで設定されていることを確認し、Keys タブでステータスを確認してください。
該当の name 値は available_models 内で登録済みデプロイメントと一致しません。Models タブの公開名と完全に一致することを確認してください。
そのデプロイメントのコネクタがオフラインか、同時実行数の上限に達しています。Connectors タブを確認してください。Online と表示されている必要があります。

Next steps

Quickstart

コネクタをペアリングし、最初のデプロイメントをゼロから登録します。

Compatible clients

他の OpenAI 互換および Anthropic 互換クライアントのベース URL とキー設定を確認できます。