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 は 空でない環境変数はキーチェーンの値より優先されます。後で UI フローに切り替える場合は unset してください。
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が付加されます。上記の IDTokiosはTOKIOS_API_KEYになります。
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 にコミットしないでください。Why this works without a tunnel
どちらの Zed プロバイダースロットも、Zed のモデルリクエストの発信元から到達可能な URL を必要とします。Tokios のコネクタはアウトバウンド専用です。モデルの隣から外向きに接続し、インバウンドポートを開かないため、https://api.tokios.com(または /v1)は一度設定すれば安定する認証済み URL です。ngrok プロセスを稼働し続ける必要も、LAN に未認証ポートを開いておく必要もありません。
Troubleshooting
401 error
401 error
Zed が送信した API キーが見つからない、形式が不正、または無効化されています。
sk-tok-… キー全体が余分な空白なしで設定されていることを確認し、Keys タブでステータスを確認してください。404 error
404 error
該当の
name 値は available_models 内で登録済みデプロイメントと一致しません。Models タブの公開名と完全に一致することを確認してください。503 error
503 error
そのデプロイメントのコネクタがオフラインか、同時実行数の上限に達しています。Connectors タブを確認してください。Online と表示されている必要があります。
Next steps
Quickstart
コネクタをペアリングし、最初のデプロイメントをゼロから登録します。
Compatible clients
他の OpenAI 互換および Anthropic 互換クライアントのベース URL とキー設定を確認できます。