Tailscaleロゴ

OpenAI互換ツールをApertureで使う

OpenAI互換のLLMクライアントをApertureプロキシ経由でルーティングする

最終検証日：
翻訳: 竹洞 陽一郎

Aperture by Tailscaleは、現在ベータ版です。

OpenAI互換のLLMクライアントを、Aperture by Tailscale経由でリクエストを送信するように設定します。
このガイドは、Gemini CLI、Roo Code、Cline、カスタムアプリケーションなど、カスタムのAPIベースURLに対応するあらゆるLLMクライアントを対象とします。

クライアントごとの個別の手順については、Claude Code、Codex、OpenCodeの各ガイドを参照してください。

前提条件

始める前に、次のものが必要です。

予期しないTLSの問題を避けるため、LLMクライアントを設定する際は、ApertureのURLに http:// を使用してください。
HTTPSを使わない場合でも、すべての接続はWireGuardによって暗号化されたままです。

Apertureは、LLMクライアントではなくモデル名に基づいてリクエストをルーティングします。
Apertureを使うように設定したLLMクライアントであれば、管理者が設定したどのプロバイダーにもアクセスできます。
サポートされるプロバイダーとAPI形式の完全な一覧については、プロバイダー互換性リファレンスを参照してください。

クライアントを設定する

LLMクライアントの設定で、APIベースURLをApertureインスタンスに設定し、プレースホルダのAPIキーを指定します。

正確な設定項目名はクライアントによって異なります。
「API Base URL」「Base URL」「API Endpoint」、またはそれに類するラベルのフィールドを探してください。

カスタムアプリケーション

サポートされているプロバイダーのAPI形式を使用していれば、任意のHTTPクライアントをApertureのURLに向けられます。
たとえば、OpenAIのチャット補完（chat completions）APIを使ってリクエストを送信するには、次のようにします。 

curl -s http://<aperture-hostname>/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Apertureは、モデル名に基づいて、リクエストを適切なプロバイダーへルーティングします。

接続を確認する

  1. 設定したツールを使って、テストリクエストを送信します。
  2. Apertureダッシュボード（http://<aperture-hostname>/ui/）を開き、「ログ（Logs）」ページにそのリクエストが表示されることを確認します。

リクエストが表示されない場合は、Apertureのトラブルシューティングガイドを参照してください。

次のステップ