Teapot Router をクライアントに接続する

次の 3 点を用意してください

API キーはパスワードと同様に扱ってください。チャット、スクリーンショット、文書、公開リポジトリに貼らず、信頼できるクライアントだけに入力してください。

Codex CLI：最初の呼び出し

既存の Codex 設定を変更せず、このターミナルだけで Teapot Router を試します。Responses 対応の有効なチャネルとモデル、残高が必要です。

1. 実際のアカウント残高を確認し、有効な API キーを用意します。
2. 管理者に Responses 対応のチャネルとモデルを有効にしてもらいます。
3. 下でキーとモデルを選び、完成したコマンドを新しいターミナルにコピーします。プレビューではキーを隠しますが、コピーしたコマンドには含まれます。
4. Codex に OK と返すよう頼み、Teapot Router の利用履歴で確認します。

(
  printf 'OpenAI Base URL (ends in /v1): '
  IFS= read -r RELAY_BASE
  printf 'Responses model ID: '
  IFS= read -r RELAY_MODEL
  printf 'Teapot Router API Key: '
  IFS= read -r -s RELAY_KEY_FOR_CODEX
  printf '\n'
  export RELAY_KEY_FOR_CODEX
  codex -m "$RELAY_MODEL" \
    -c 'model_provider="relay"' \
    -c "model_providers.relay={name=\"Teapot Router\",base_url=\"$RELAY_BASE\",env_key=\"RELAY_KEY_FOR_CODEX\",wire_api=\"responses\",requires_openai_auth=false}"
)

このコマンドは今回のセッションだけに適用されます。キーがクリップボードや履歴に残る場合があるため、テスト後に消去してください。モデルやチャネルのエラーは NEW-API を確認します。

Claude Code

以下は現在のターミナルだけに適用される設定です。既存のクライアント設定ファイルは上書きしません。

1. Claude Code が未インストールなら、公式の手順に従ってインストールし、claude コマンドが起動することを確認します。
2. Teapot Router の「クライアントを設定」→「Claude Code」を開き、/v1 の付かない URL とキーを確認します。使用可能な Claude モデル ID も確認してください。
3. ターミナルを開き、下の <TEAPOT_API_BASE_URL> と <CLAUDE_MODEL_ID> を実際の値に置き換えます。コマンドを実行し、表示された入力欄にキーを貼って Enter を押します。キーの文字が表示されないのは正常です。
4. Claude Code で「OK と返答してください」など短いメッセージを送ります。その後 Teapot Router の利用履歴で該当するリクエストを確認します。

macOS / Linux（bash、zsh）

export ANTHROPIC_BASE_URL="<TEAPOT_API_BASE_URL>"
printf 'Teapot Router API Key: '
read -rs ANTHROPIC_AUTH_TOKEN
printf '
'
export ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_MODEL="<CLAUDE_MODEL_ID>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "<TEAPOT_API_BASE_URL>"
$secret = Read-Host "Teapot Router API Key" -AsSecureString
$env:ANTHROPIC_AUTH_TOKEN = [System.Net.NetworkCredential]::new("", $secret).Password
$env:ANTHROPIC_MODEL = "<CLAUDE_MODEL_ID>"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = $env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = $env:ANTHROPIC_MODEL
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = $env:ANTHROPIC_MODEL
claude

この環境変数は現在のターミナルを閉じると消えます。常時利用する場合は Claude Code の対応する設定方法を使い、既存の設定を先にバックアップしてください。

OpenAI 互換クライアント

独自の OpenAI 接続先を設定できるチャットアプリ、または OpenAI SDK を使うアプリ向けです。メニュー名はアプリごとに異なりますが、入力する 3 つの値は同じです。

1. クライアントのプロバイダー設定または API 設定を開き、「OpenAI compatible」「Custom OpenAI」などのカスタム接続先を選びます。
2. Teapot Router の OpenAI 互換タブにある /v1 で終わるアドレスを Base URL に入力します。表示した実際のキーを API Key に入力します。
3. キーで利用できるモデルの完全な ID を入力します。保存して短いメッセージを送り、Teapot Router の利用履歴で確認します。

# First run: python3 -m pip install openai
from getpass import getpass
from openai import OpenAI

base_url = input("Teapot Router Base URL (ends in /v1): ").strip()
model = input("Model ID: ").strip()
client = OpenAI(base_url=base_url, api_key=getpass("Teapot Router API Key: "))
result = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Reply with OK."}],
)
print(result.choices[0].message.content)

接続を確認する

値のコピーや「設定済み」ボタンだけでは接続成功とは言えません。実際のリクエストを確認してください。

1. クライアントに「保存完了」だけでなく、モデルからの返答が表示されます。
2. Teapot Router の利用履歴に、時刻・モデル・キーが一致するリクエストがあります。
3. 概要画面で「呼び出しを確認」を押します。そのアカウントの初回リクエストなら 3 番目のステップが更新されます。更新されなければ再読み込みし、アカウントを確認します。

トラブルシューティング

解決しない場合は、クライアント名、エラー全文、発生時刻をサポートに伝えてください。API キー全文は送らないでください。