클라이언트에 Teapot Router 연결하기

다음 세 가지를 준비하세요

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이 없는 주소와 키를 확인하세요. 사용 가능한 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 앱에 적용할 수 있습니다. 메뉴 이름은 달라도 입력할 세 값은 같습니다.

1. 클라이언트의 제공자 또는 API 설정에서 OpenAI compatible, Custom OpenAI 또는 사용자 지정 주소를 선택하세요.
2. Base URL에는 Teapot Router의 OpenAI 호환 탭에 나온 /v1로 끝나는 주소를, 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. 워크스페이스 개요에서 '호출 확인'을 누릅니다. 해당 계정의 첫 요청이면 세 번째 단계가 갱신됩니다. 아니면 새로고침하고 계정을 확인하세요.

문제 해결

계속 문제가 있으면 클라이언트 이름, 오류 원문, 발생 시간을 지원팀에 알려주세요. 전체 API 키는 보내지 마세요.