Skip to main content
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互換エンドポイントです。どちらか一方を選ぶか、両方を設定してアシスタントごとに切り替えることも可能です。

​
前提条件

  • A running Tokios connector paired with your local model — see Connector Install
  • A registered model deployment name — see Register a Model
  • A Tokios API key (sk-tok-…) — see API Keys
  • Zedがインストール済みであること

​
オプションA：OpenAI互換プロバイダー

1

Zedの settings.json を開く

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

openai_compatibleエントリを追加する

TokiosのベースURL、ご自身のデプロイ名、およびAPIキーを記載した language_models.openai_compatible ブロックを追加する：
settings.json
Replace gemma-tunnel with the public deployment name you registered on the Models tab — not your Ollama/llama.cpp/vLLM/LM Studio local model id. Note that the key is deliberately absent here — see the next step.
3

settings.jsonの外部でAPIキーを設定する

Zedは settings.json からAPIキーを読み込まない。いずれかの方法で sk-tok-… キーを指定する必要がある：
  • UI経由 — コマンドパレットから agent: open settings を実行し、LLMプロバイダー 一覧内の Tokios を選択してキーを貼り付ける。Zedはそのキーをシステムのキーチェーンに保存する。
  • 環境変数経由 — Zedは settings.json 内のプロバイダーIDから名前を生成する。大文字・アンダースコア形式に変換した上で _API_KEY を接尾させる。上記のID Tokios は結局 TOKIOS_API_KEY という名前になる。
値が設定されている環境変数はキーチェーンの値より優先されるため、後からUI経由で設定する場合はその変数を未設定状態に戻すこと。
4

アシスタントパネルでモデルを選択する

Zedのアシスタントパネルを開き、モデル選択欄から Tokios: gemma-tunnel（またはご自身が設定した display_name）を選択する。

​
オプションB：Anthropic互換のプロバイダー

1

anthropic_compatibleエントリを追加する

In the same settings.json, add a language_models.anthropic_compatible block pointing at the Tokios Anthropic-compatible endpoint. Note there is no /v1 on this base URL:
settings.json
Zedがanthropic_compatible.available_models配下で期待しているフィールド名はopenai_compatibleの構造と若干異なる場合があり、リリース版によっても変わるため、ご自身が使用しているバージョンで確認する必要がある。
2

ご自身のAPIキーを設定してください。

オプションAと同様に、sk-tok-… APIキーを入力してください。具体的には custom_headers または Zedのキー入力プロンプトを利用します。また、ZedがAnthropic互換用のスロットに送信するヘッダー名が何であるかも確認する必要があります。Anthropicのクライアントでは通常 x-api-key が使用され、Authorization: Bearer は使われない傾向にあります。
3

アシスタントパネルからモデルを選択します。

Zedのモデル選択画面で、OpenAI互換モデルと並べて、あるいは代わりに設定済みのAnthropic互換モデルを選択できます。
Replace gemma-tunnel with the deployment name you registered, and sk-tok-YOUR_KEY with your own key. Never commit either into a shared or version-controlled settings.json.
両方のプロバイダーを同時に設定し、それぞれ別のエントリとして登録することも可能です。一つは https://api.tokios.com/v1 （OpenAI互換）向け、もう一つは https://api.tokios.com （Anthropic互換）向けとなり、モデル選択画面から切り替えることで同一デプロイ環境下での挙動比較ができます。

​
なぜトンネルなしでも動作するのか

Zedの両プロバイダースロットには、モデルリクエストが発行される場所から到達可能なURLが必要です。Tokiosのコネクターは送信専用であり、モデル近傍から外部へ接続するのみで受信用ポートを開かないため、https://api.tokios.com （または /v1 ）は一度設定すれば安定して認証済みのURLとなります。ngrok プロセスを常時稼働させる必要も、LAN上に認証なしのポートが開放されることもありません。

​
トラブルシューティング

Zedから送信されたAPIキーが見当たらない、形式が不正である、または無効化されている可能性があります。sk-tok-… というキー値に余分な空白が含まれていないか確認し、Keys タブでその状態を確認してください。
The name value in available_models doesn’t match a registered deployment. Confirm it exactly matches the public name on the Models tab.
該当するデプロイ用のコネクターがオフライン状態であるか、同時接続数の上限に達しています。Connectors タブを確認してください。そこには Online と表示される必要があります。

​
次に行うこと

クイックスタート

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

互換性のあるクライアント

その他のOpenAIやAnthropic互換のクライアント向けに、ベースURLやAPIキーの設定方法をご覧ください。