よく使うツールとの連携

Claude Code、Codex など、カスタムのモデルサービスアドレスに対応したツールは、OneGateway を経由してモデルを呼び出せます。まず API Keys でキーを作成して API URL をコピーし、次に利用可能なモデルから対象のモデル ID をコピーします。使用量の確認や制限の調整がしやすいよう、ツールごとに別々のキーを作成することをおすすめします。

連携前の準備

キーが有効で期限切れでなく、クォータが十分にあり、利用可能なモデルの範囲に対象モデルが含まれていることを確認してください。ツールが必要とするインターフェースやモデルの機能も、プロバイダーがサポートしている必要があります。

ツール	使用するインターフェース	アドレスの例
Claude Code	Anthropic Messages	https://your-api-endpoint（クライアントが /v1/messages を付加）
Codex	OpenAI Responses	https://your-api-endpoint/v1（クライアントが /responses を付加）
OpenAI 形式に対応したチャットツール	通常は Chat Completions（ツールの要件に従う）	https://your-api-endpoint/v1

例中の your-api-endpoint、sk-xxxxxxxx、モデル ID はすべて置き換える必要があります。実際のアドレスはコンソールに表示される API URL に従ってください。サブパスにデプロイされている場合はそのパスを残し、/v1 を重複して付けないでください。

Claude Code

まず Claude Code 公式ドキュメントに従ってクライアントをインストールします。以下の設定はターミナル版の Claude Code を対象としています。

アドレスとキーの設定

Claude Code を起動するターミナルで環境変数を設定します。ANTHROPIC_BASE_URL にはゲートウェイのベースアドレス、ANTHROPIC_AUTH_TOKEN には OneGateway が発行したキーを指定します。クライアントはこのキーを Bearer 認証で送信します。設定方法は Claude Code のゲートウェイ連携ドキュメントを参照してください。

macOS / Linux

export ANTHROPIC_BASE_URL='https://your-api-endpoint'
export ANTHROPIC_AUTH_TOKEN='sk-xxxxxxxx'
claude --model 'your-claude-model-id'

Windows PowerShell

$env:ANTHROPIC_BASE_URL = 'https://your-api-endpoint'
$env:ANTHROPIC_AUTH_TOKEN = 'sk-xxxxxxxx'
claude --model 'your-claude-model-id'

your-claude-model-id は利用可能なモデルの ID に置き換え、Anthropic Messages とツール呼び出しに対応したモデルを選択してください。既に ANTHROPIC_API_KEY やほかのゲートウェイ設定がある場合は、今回の設定と競合しないか先に確認してください。

環境変数は現在のターミナルと、そこから起動したプログラムにのみ有効です。継続的に使用する場合は、個人の ~/.claude/settings.json の env に設定をマージできます。既存の設定は残してください。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://your-api-endpoint",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx"
  }
}

実際のキーを含む設定は個人ディレクトリに置き、プロジェクトのリポジトリにコミットしないようにしてください。

呼び出しの確認

クライアントで /status を実行して Anthropic base URL と認証情報の取得元を確認し、「現在のディレクトリの構成を説明して」などの簡単なリクエストを送信します。OneGateway のリクエストログで、キー、モデル、プロバイダー、使用量を確認してください。

接続に失敗した場合は、まずベースアドレスに /v1 が重複して含まれていないかを確認し、次にキーとモデル ID を確認してください。Web 画面でモデルが表示されているだけでは、そのモデルが Claude Code のツール呼び出し要件を満たしていることの証明にはなりません。

Codex

まず Codex 公式クイックスタートに従ってクライアントをインストールします。以下では、カスタムのモデルプロバイダー設定を使って OneGateway に接続します。設定フィールドは OpenAI 公式のゲートウェイ連携ドキュメントに基づいています。

モデルプロバイダーの設定

以下の内容を個人の ~/.codex/config.toml にマージします。Windows では %USERPROFILE%\.codex\config.toml が対応します。トップレベルの model と model_provider は、TOML でテーブル内のフィールドとして解釈されないよう、最初のテーブルヘッダーより前に置いてください。

model = "your-codex-model-id"
model_provider = "onegateway"

[model_providers.onegateway]
name = "OneGateway"
base_url = "https://your-api-endpoint/v1"
wire_api = "responses"
env_key = "ONEGATEWAY_API_KEY"
supports_websockets = false

your-codex-model-id は、ゲートウェイで利用可能なモデルのうち Responses とツール呼び出しに対応したモデル ID に置き換えてください。supports_websockets = false を指定すると HTTP のストリーミング接続を使用します。フィールドの詳細は Codex 設定リファレンスを参照してください。

Codex を起動するターミナルでキーを設定します。

macOS / Linux

export ONEGATEWAY_API_KEY='sk-xxxxxxxx'
codex

Windows PowerShell

$env:ONEGATEWAY_API_KEY = 'sk-xxxxxxxx'
codex

キーは env_key で指定した環境変数から読み取られます。このカスタムプロバイダー設定を使用する場合は、Codex を起動するターミナルでその変数が設定されていることを確認してください。

呼び出しの確認

起動後に使用中のモデルとプロバイダーを確認し、簡単なリクエストを送信します。OneGateway のリクエストログで、リクエストがゲートウェイを経由し、想定どおりの API Key とモデルが使われていることを確認してください。

インターフェースが存在しないというエラーが返された場合は、アドレスと、ゲートウェイの /v1/responses への対応状況を確認してください。モデルが存在しない、または権限がないというメッセージが表示された場合は、モデル ID、キーの制限、プロバイダーのグループ料金を確認してください。

その他のチャットツール

ツールのモデルサービス設定で、カスタムアドレスに対応した OpenAI または Anthropic のインターフェースを選択し、OneGateway の API URL とキーを入力して、利用可能なモデル ID を手動で追加または選択します。OpenAI Chat Completions の場合、Base URL は通常 https://your-api-endpoint/v1 です。

まず短い質問を 1 つ送信し、リクエストログで結果を確認します。アドレス、キー、モデルが使用できることを確認してから、画像入力やツール呼び出しなどの機能を有効にしてください。機能の対応状況は、選択したモデルとインターフェースによって異なります。

連携時のよくある問題

症状	確認ポイント
404 またはパスが存在しない	Base URL、クライアントが自動的に付加するパス、/v1 を重複して付けていないか
401 またはキーが無効	認証情報が完全か、環境変数が起動プロセスに渡されているか、キーが有効か
モデルが存在しない、または権限がない	モデル ID、キーの利用可能なモデルの範囲、プロバイダーの状態とグループ料金
ツール起動後も元のサービスに接続している	個人設定がほかの設定で上書きされていないか、環境変数を設定したターミナルからクライアントを起動したか
通常のチャットは使えるが、ツール呼び出しが失敗する	モデルと上流インターフェースが、ツール呼び出しとツールが要求するプロトコルに対応しているか

その他の確認方法はよくある質問を参照してください。