OpenAI 互換プロトコルがメカニズムであり、モデル数ではない

OfoxAI の Zed エディタ設定ガイドは、OpenAI 互換プロトコルを介して Zed にカスタム LLM プロバイダーを追加する手順を説明する：1 つの api_url、1 つの available_models 配列、システムキーチェーンに保存された鍵。（OfoxAI、「Zed Editor: Configure Custom LLM Providers & External Agents」、OfoxAI、公開 2026-03-30、取得 2026-08-23、https://ofox.ai/blog/zed-editor-ai-configuration-guide-2026/）。Honest Architect はこのガイドを一般的メカニズムの実働例として読む：プロパティ（プロバイダー柔軟性——エディタを再コンパイルせずに1つのモデルバックエンドを別のものと交換する）はメカニズム（標準化されたプロトコルサーフェス——OpenAI 互換 API、さらにエディタが起動時に解析する設定スキーマ）によって保証され、「100+ モデルをサポート」という主張によってではない。100 のモデルを標準化プロトコルなしでリストするエディタは脆弱なカタログである；1 つのプロトコルを暴露し、設定配列を編集してプロバイダーを追加させるエディタは柔軟なサーフェスである。Honest Architect は「プロトコルはメカニズムである」形式を Production ✅ とラベル付けし、OfoxAI 固有の商業的主張（価格、モデル名、「0% プラットフォーム手数料」）を Partial ⚠️ とラベル付けする（ベンダー自己宣伝、Everythink によって独立に検証されていない）。

ガイドは設定のウォークスルーであり、調査でも証明でもない。Honest Architect はウォークスルーが示すメカニズム形式を抽出する——OpenAI 互換プロトコルとしてのプロバイダー柔軟性メカニズム、システムキーチェーンとしての鍵主権メカニズム、外部エージェントルーティングとしての「空間はルータ」形式——そして各形式を、形式が実在し再現可能な場合は Production ✅、形式がベンダー固有の商業的主張である場合は Partial ⚠️ とラベル付けする。

主要な結論

• OpenAI 互換プロトコルがプロバイダー柔軟性のメカニズムである。Theorem 3：プロパティ（再コンパイルせずに1つの LLM バックエンドを別のものと交換する）はメカニズム（標準化された API サーフェス + エディタが起動時に解析する設定スキーマ）によって保証され、「100+ モデルをサポート」という主張によってではない。Honest Architect は「プロトコルはメカニズムである」形式を Production ✅ とラベル付けする。
• システムキーチェーンが鍵主権のメカニズムである。ガイド：「API Key はシステムキーチェーン（macOS Keychain / Linux Secret Service）に安全に保存され、設定ファイルに平文で書き込まれることはない。」プロパティ（鍵が平文設定にない）はメカニズム（OS キーチェーンに保存、JSON にはない）によって保証され、「あなたの鍵を保護する」という主張によってではない。Honest Architect は「キーチェーン非平文」形式を Production ✅ とラベル付けする。
• ケイパビリティフィールドがランタイム解析スキーマである。各モデルエントリは capabilities: { tools: true, images: false } を持つ。Zed はケイパビリティを読み、それに応じてルーティングする——tools が false のモデルに関数呼び出しを試みない。プロパティ（ツールサポートのないモデルでの失敗したツール呼び出しなし）はメカニズム（エディタがルーティング前にケイパビリティフラグを読む）によって保証され、「モデル互換性を確認した」という主張によってではない。Honest Architect は「ケイパビリティはスキーマである」形式を Production ✅ とラベル付けする。
• 外部エージェントが「空間はルータ」形式である。Zed のエージェントパネルには Zed Agent（組み込み、設定された LLM プロバイダーを使用）と外部エージェント（Claude Code、Codex CLI、Gemini CLI——「独立して実行され、独自の資格情報、モデルアクセス、課金を持つ——設定された LLM プロバイダーから分離」）がある。エディタはどのエージェントへルーティングする；エージェントは独自に実行する。Honest Architect は「エディタがルーティングしエージェントが実行する」形式を Production ✅ とラベル付けする。
• クロスドメインの並行：Eye Key（永続化前 HMAC = 別のドメインでのキーチェーン非平文）、World Monitor（geohash タイルごとに1つのキャッシュ = プロバイダーサーフェスごとに1つのプロトコル）、Oracle 正規化（一箇所で正規化 = OpenAI 互換プロトコルが唯一の正規化ポイント）、Zod ランタイム境界（ケイパビリティフィールドは起動時に解析される、スキーマがネットワーク境界で解析されるように）。すべて Partial ⚠️：同じ形式、分離したドメイン。
• 範囲：民事/防御的。コードエディタの設定ガイドは武器ではない。攻撃的範囲なし。トークン、ウォレット、コミュニティクレジットの結果は約束されない；これらは Roadmap 🔵、Howey 審査待ち。Everythink は予測プラットフォームであり、LLM プロバイダーアグリゲータではない；クロスドメインの並行はメカニズム形式の Partial ⚠️ の図示であり、OfoxAI を製品として是認するものではない。

プロトコルはメカニズムである

ガイドのコア設定は JSON オブジェクトである：language_models.openai_compatible.OfoxAI と api_url および available_models 配列。openai_compatible キーがメカニズムである——Zed に「このエンドポイントに OpenAI 互換プロトコルで話しかけ、ここがそれが提供するモデルだ」と伝える。プロパティ（Zed がコード変更なしに新しいプロバイダーと話せる）はメカニズム（OpenAI 互換プロトコルサーフェス + 設定スキーマ）によって保証され、「Zed は OfoxAI をサポートする」という主張によってではない。Honest Architect は「プロトコルはメカニズムである」形式を Production ✅ とラベル付けする、なぜなら形式は実在し再現可能だからである：openai_compatible 設定スロットを暴露するいかなるエディタも OpenAI 互換プロトコルを話すいかなるエンドポイントと話せ、プロバイダーは JSON 編集で追加され、再コンパイルではない。

形式はガイド全体に一般化する。ガイドは2つの方法を提供する：エージェントパネル GUI と settings.json ファイル。両者は同じ設定オブジェクトを生成する。GUI は便利さ；JSON が真理源である。Honest Architect は「JSON は真理源である」形式を Production ✅ とラベル付けする（GUI は JSON を編集し、JSON は Zed が起動時に読むものであり、GUI は JSON 上のビューであり、分離した状態ではない）。ガイドの「Pro Tip」——ドキュメント URL と /v1/models エンドポイントを AI に送り設定を自動生成させる——は「プロトコルはメカニズムである」形式のメタループ内である：モデルリストエンドポイントは OpenAI 互換プロトコルの一部であり、AI はそれを読み設定を生成できる。Honest Architect はメタ形式を Partial ⚠️ とラベル付けする（ベンダー提案のワークフロー、独立に検証されていない）。

トラブルシューティングセクションはメカニズムの障害モードの測定である。「settings.json の形式が正しいことを確認し、Zed を再起動する」——設定は起動時に解析される；不正な JSON は解析を壊す。「language model: reset credentials を検索し、API Key を再入力する」——鍵はキーチェーンにある；リセットはそれを再保存する。「そのモデルの capabilities.tools を false に設定する。関数呼び出しをサポートしないモデルについて true のままにすると、リクエストが失敗する可能性がある」——ケイパビリティフィールドはランタイム解析スキーマである；間違ったフラグは間違ったルートを生成する。「API URL が正確に https://api.ofox.ai/v1 であることを確認する——末尾のスラッシュなし、欠落した /v1 接尾辞なし」——プロトコルサーフェスは URL 形状である；間違った URL はプロトコルを壊す。各ステップはメカニズムがどこで壊れるかの測定である：JSON 解析、鍵ストア、ケイパビリティルート、URL。Honest Architect は「トラブルシューティングとしての測定」形式を Production ✅ とラベル付けする（実在の、再現可能な障害モードマッピング）。

キーチェーンが鍵主権メカニズムである

ガイドは述べる：「API Key はシステムキーチェーン（macOS Keychain / Linux Secret Service）に安全に保存され、設定ファイルに平文で書き込まれることはない。」プロパティ（鍵が平文設定にない）はメカニズム（OS キーチェーンに保存、JSON にはない）によって保証され、「あなたの鍵を保護する」という主張によってではない。Honest Architect は「キーチェーン非平文」形式を Production ✅ とラベル付けする。形式は Everythink の Eye Key のエディタドメイン類似である：プロパティ（Eye Key 平文は決してディスクに触れない）はメカニズム（永続化前 HMAC、指紋のみ Postgres に行く）によって保証され、「あなたの鍵を保護する」という主張によってではない。同じ形式、分離したドメイン。Honest Architect はクロスドメイン並行を Partial ⚠️ とラベル付けする。

「キーチェーン非平文」形式は一般化する：平文設定に現れてはならないいかなる秘密（API 鍵、データベースパスワード、OAuth クライアントシークレット）は帯域外シークレットストア（OS キーチェーン、シークレットマネージャ、ランタイムで注入された環境変数）に保存され、設定はストアを参照し、秘密ではない。「平文で秘密を保存しない」という主張は非メカニズムである：それは主権を生み出さない。メカニズム（キーチェーンに保存、設定から参照）は主権を直接生み出す。Honest Architect は「秘密を平文の外に保存する」形式を Production ✅ とラベル付けする。

Honest Architect は摩擦に正直に注意する。キーチェーンは OS 固有である（macOS Keychain、Linux Secret Service；ガイドは Windows Credential Manager に言及しない）。キーチェーンは実行中のデスクトップセッションを必要とする（ヘッドレスサーバーにはキーチェーンがない）。キーチェーンはユーザーごとである（共有設定ファイルは鍵を共有できない）。これらはメカニズムの欠陥ではない；それらはメカニズムの範囲である。Honest Architect は範囲の正直さを Partial ⚠️ とラベル付けする（ガイドはこれらの限界を明示的に述べない；それらはメカニズムの形式から推論される）。

ケイパビリティフィールドがランタイム解析スキーマである

available_models 配列の各モデルエントリは capabilities オブジェクトを持つ：{ tools: true, images: false }。Zed は起動時にケイパビリティを読み、それに応じてルーティングする——tools が false のモデルに関数呼び出しを試みず、images が false のモデルに画像を送らない。プロパティ（ツールサポートのないモデルでの失敗したツール呼び出しなし、画像サポートのないモデルでの失敗した画像送信なし）はメカニズム（エディタがルーティング前にケイパビリティフラグを読む）によって保証され、「モデル互換性を確認した」という主張によってではない。Honest Architect は「ケイパビリティはスキーマである」形式を Production ✅ とラベル付けする。

形式は Everythink の Zod ランタイム境界のエディタドメイン類似である：プロパティ（悪いペイロードが型付けされた ApiError として現れ、決してクラッシュしない）はメカニズム（ネットワーク境界で解析される Zod スキーマ）によって保証され、「我々の API は型付けされている」という主張によってではない。TypeScript 型はランタイムで消去される；capabilities フィールドは起動時に読まれる。両者はランタイム解析スキーマであり、解析された値に基づいてリクエストをルーティングする。Honest Architect はクロスドメイン並行を Partial ⚠️ とラベル付けする（同じ形式——ランタイム解析スキーマがメカニズム——分離したドメイン——エディタケイパビリティルーティング vs ネットワーク境界型安全性）。

ガイドのトラブルシューティングはメカニズムを確認する：「そのモデルの capabilities.tools を false に設定する。関数呼び出しをサポートしないモデルについて true のままにすると、リクエストが失敗する可能性がある。」間違ったケイパビリティフラグは間違ったルートを生成する。メカニズムは間違ったフラグを暗黙に修正しない；フラグに基づいてルーティングし、フラグが嘘をつく場合ルートは失敗する。Honest Architect は「メカニズムは真実ではなくフラグに基づいてルーティングする」形式を Production ✅ とラベル付けする（ルータは設定を信頼し、設定は正直でなければならない）。

外部エージェントが「空間はルータ」形式である

Zed のエージェントパネルには2つのモードがある：Zed Agent（組み込み、設定された LLM プロバイダーを使用）と外部エージェント（Claude Code、Codex CLI、Gemini CLI——「独立して実行され、独自の資格情報、モデルアクセス、課金を持つ——設定された LLM プロバイダーから分離」）。エディタはユーザーが選択したどのエージェントへもルーティングする；エージェントは独自に実行し、独自の資格情報、独自のモデルアクセス、独自の課金を持つ。Honest Architect は「エディタがルーティングしエージェントが実行する」形式を Production ✅ とラベル付けする。形式は Everythink の「空間はルータ」のエディタドメイン類似である：network→community→room トポロジーは何かが応答する前にルーティングし、ルーティングされたエンティティは独自に実行する。Honest Architect はクロスドメイン並行を Partial ⚠️ とラベル付けする。

外部エージェント形式は一般化する：エディタはルータであり、ランタイムではない。組み込みの Zed Agent は設定された LLM プロバイダーを使用する；外部エージェントは独自のものを使用する。エディタは外部エージェントの資格情報、モデルアクセス、課金を吸収しない——エージェントを起動し、エージェントに実行させる。プロパティ（ユーザーがエディタがその認証を吸収せずにいかなるエージェントも使用できる）はメカニズム（エディタがルーティングし、エージェントが独立して実行する）によって保証され、「多くのエージェントをサポートする」という主張によってではない。Honest Architect は「エディタはルーティングし吸収しない」形式を Production ✅ とラベル付けする。

Honest Architect がベンダー設定ガイドで読むもの

OfoxAI の Zed ガイドはベンダー設定のウォークスルーである。Honest Architect はメカニズム形式（OpenAI 互換プロトコルとしてのプロバイダー柔軟性メカニズム；システムキーチェーンとしての鍵主権メカニズム；ケイパビリティフィールドとしてのランタイム解析スキーマ；外部エージェントとしての「空間はルータ」形式）を OfoxAI を製品として是認せずに抽出する。メカニズム形式は Production ✅ である：実在する、実装可能、ガイド自身の設定スキーマの説明とトラブルシューティング障害モードによって検証される。OfoxAI 固有の商業的主張——「100+ の主流 LLM モデル」、「0% プラットフォーム手数料」、「公式 DeepSeek レート、マークアップなし」、特定のモデル名と価格——は Partial ⚠️ である（ベンダー自己宣伝、Everythink によって独立に検証されていない）。Honest Architect は OfoxAI、DeepSeek、もしくは特定のモデルを推奨しない。Everythink は予測プラットフォームであり、LLM プロバイダーアグリゲータでもコードエディタでもない。クロスドメインの並行はメカニズム形式の Partial ⚠️ の図示であり、ガイドが販売する製品の是認ではない。範囲は民事/防御的である：コードエディタの設定ガイドは武器ではない。トークン、ウォレット、コミュニティクレジットの結果は約束されない；これらは Roadmap 🔵、Howey 審査待ち。

よくある質問

OpenAI 互換プロトコルは主張かメカニズムか？

メカニズム。Theorem 3：プロパティ（再コンパイルせずに1つの LLM バックエンドを別のものと交換する）はメカニズム（標準化された API サーフェス + エディタが起動時に解析する設定スキーマ）によって保証され、「100+ モデルをサポート」という主張によってではない。Honest Architect は「プロトコルはメカニズムである」形式を Production とラベル付けする。

キーチェーンはどのように Eye Key に並行するか？

ガイド：「API Key はシステムキーチェーンに安全に保存され、設定ファイルに平文で書き込まれることはない。」プロパティ（鍵が平文設定にない）はメカニズム（OS キーチェーンに保存、JSON にはない）によって保証される。Eye Key：プロパティ（平文が決してディスクに触れない）はメカニズム（永続化前 HMAC、指紋のみ Postgres に行く）によって保証される。同じ形式——秘密を平文の外に保存する——分離したドメイン。Honest Architect は「キーチェーン非平文」を Production と、クロスドメイン並行を Partial とラベル付けする。

ケイパビリティフィールドはどのように Zod 境界に並行するか？

各モデルエントリは capabilities: { tools: true, images: false } を持つ。Zed は起動時にケイパビリティを読み、それに応じてルーティングする。Zod スキーマはネットワーク境界で解析され、解析された値に基づいてリクエストをルーティングする。両者はランタイム解析スキーマである。Honest Architect は「ケイパビリティはスキーマである」を Production と、クロスドメイン並行を Partial とラベル付けする。

外部エージェントはどのように「空間はルータ」に並行するか？

Zed の外部エージェント（Claude Code、Codex CLI、Gemini CLI）は「独立して実行され、独自の資格情報、モデルアクセス、課金を持つ——設定された LLM プロバイダーから分離」。エディタがルーティングする；エージェントが独自に実行する。Everythink の network→community→room トポロジーは何かが応答する前にルーティングする；ルーティングされたエンティティは独自に実行する。同じ形式——エディタがルーティングしエージェントが実行する——分離したドメイン。Honest Architect は形式を Production と、クロスドメイン並行を Partial とラベル付けする。

Everythink は OfoxAI や Zed を是認するか？

いいえ。Everythink は予測プラットフォームであり、LLM プロバイダーアグリゲータでもコードエディタでもない。OfoxAI の Zed ガイドはベンダー設定のウォークスルーである。Honest Architect はメカニズム形式を製品を是認せずに抽出する。OfoxAI 固有の商業的主張は Partial である（ベンダー自己宣伝、独立に検証されていない）。トークン、ウォレット、コミュニティクレジットの結果は約束されない；これらは Roadmap、Howey 審査待ち。

出典

• OfoxAI、「Zed Editor: Configure Custom LLM Providers & External Agents」、OfoxAI、公開 2026-03-30、取得 2026-08-23、https://ofox.ai/blog/zed-editor-ai-configuration-guide-2026/

もしあなたのチームがプロパティを主張する代わりにメカニズムを ship する準備ができているなら、あなたの network を構築——Sisters が起草し、Oracle が正規化し、プロトコルがルーティングする。