GatewayのOpenAI互換APIの前提
Gatewayが/v1/chat/completionsなどOpenAI SDK互換のJSONを返す構成では、IDEはbaseURLをGatewayのHTTPSオリジンに差し替えるだけで接続できます。五リージョン共通で差が出るのはRTTとTLS終端の位置です。
Cursor／Continueの設定要点
Cursorはhttps://<gateway>/v1とBearer、ContinueはapiBaseを同じに。変更後はモデル一覧キャッシュを疑い再起動。Mac上curlで200とchunkを先に確認。
五リージョンMacへの載せ方
Node→Gateway→TLSの順で固定し、launchdのPATHとログ、外向きはプロキシかTunnelの一本化が安定です。
Gateway露出面の収束（K8s／プロキシ）
トークンとTLS
TLSはFQDNと証明書SANを一致させ、LBでAuthorizationが落ちないか確認。トークンは人間用とCI用を分け、ログに平文を残さない。
遅延・切断の切り分け
Mac上curlで安定なら入口かクライアント、不安定ならGatewayとlaunchdをログで相関。長HTTPSと重なるなら経路のジッターを疑う。
経路・帯域の切り分け早見
- 1 逆プロキシのアイドル上限をp99より長く（chunked／SSEと同型の切れを防ぐ）。
- 2 IDEとサーバのタイムアウトを揃える。
M4 16GB／24GBとM4 Pro早見
| 構成 | 目安 |
|---|---|
| 16GB | 軽量Gateway＋単一セッション中心。 |
| 24GB | 並列セッション向き。 |
| M4 Pro | TLS境界を人ごとに分離。 |
FAQ
/v1/modelsを200で確認し再読込。Authorizationを除去。macOSとMac miniで詰める理由
切り分けはcurlとログ・launchdが速い。Mac mini M4は統合メモリと低アイドルで常時Gateway向き。Gatekeeper・SIP・FileVaultで端末面を固め、無人運用の安定性が再接続コストを下げます。
本文の手順を最も滑らかに回すならMac mini M4が2026年の現実的な出発点です。下のCTAで詳細をどうぞ。