CodexをApertureで使う
最終検証日:
翻訳: 竹洞 陽一郎
Aperture by Tailscaleは、現在ベータ版です。
Codexを、Aperture by Tailscale経由でリクエストを送信するように設定すると、組織はAPIキーの一元管理、利用状況の追跡、セッションのロギングを得られます。
前提条件
始める前に、次のものが必要です。
- 少なくとも1つのOpenAI互換プロバイダーが設定済みで、お使いのデバイスからアクセスできるApertureインスタンス。まだ設定していない場合は、Apertureを使い始めるを参照してください。
- お使いのデバイスからアクセスできるApertureのホストURL。
https://ではなくhttp://を使用します。 - お使いのデバイスにインストールされたCodex。
予期しないTLSの問題を避けるため、LLMクライアントを設定する際は、ApertureのURLにhttp://を使用してください。
HTTPSを使わない場合でも、すべての接続はWireGuardによって暗号化されたままです。
Apertureは、LLMクライアントではなくモデル名に基づいてリクエストをルーティングします。
Apertureを使うように設定したLLMクライアントであれば、管理者が設定したどのプロバイダーにもアクセスできます。
サポートされるプロバイダーとAPI形式の完全な一覧については、プロバイダー互換性リファレンスを参照してください。
Codexを設定する
CodexをApertureを使うように設定するには、Codexの設定ファイル(~/.codex/config.toml)を作成または編集し、ApertureのURLを base_url として使用し、モデルをCodex対応のモデルに設定します。
model = "gpt-5.3-codex" model_provider = "llm-ai-ts-net" model_reasoning_effort = "high" [model_providers.llm-ai-ts-net] name = "Tailscale AI Gateway" base_url = "http://<aperture-hostname>/v1" # 必須: ApertureのURL # Codexモデルに必須 wire_api = "responses"
wire_api = "responses" 設定は、CodexがOpenAI Responses APIの形式を使うように構成します。
Apertureが認証情報を自動的に注入するため、APIキーを設定する必要はありません。
接続を確認する
- Codexでテストメッセージを送信します。
- Apertureダッシュボード(
http://<aperture-hostname>/ui/)を開き、「ログ(Logs)」ページにそのリクエストが表示されることを確認します。
リクエストが表示されない場合は、Apertureのトラブルシューティングガイドを参照してください。
次のステップ
- ユーザーにモデルへのアクセスを許可する: 各ユーザーまたはグループが、Apertureを通じてどのモデルにアクセスできるかを制御します。
- 利用状況ダッシュボードを表示する: 組織全体のトークン消費、コスト、セッションの活動を監視します。
- ユーザーごとの支出上限を設定する: クォータバケットを設定して、個々のユーザーのコストを制御します。