---
outline: [2, 3]
head:
  - - meta
    - name: description
      content: OneGateway の API Keys を使って Claude Code、Codex などのよく使うツールと連携し、ゲートウェイのアドレス、キー、モデルを設定して、呼び出し記録を確認します。
---

# よく使うツールとの連携

Claude Code、Codex など、カスタムのモデルサービスアドレスに対応したツールは、OneGateway を経由してモデルを呼び出せます。まず [API Keys](/ja/user/tokens) でキーを作成して **API URL** をコピーし、次に[利用可能なモデル](/ja/user/models)から対象のモデル 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 公式ドキュメント](https://code.claude.com/docs/en/overview)に従ってクライアントをインストールします。以下の設定はターミナル版の Claude Code を対象としています。

### アドレスとキーの設定

Claude Code を起動するターミナルで環境変数を設定します。`ANTHROPIC_BASE_URL` にはゲートウェイのベースアドレス、`ANTHROPIC_AUTH_TOKEN` には OneGateway が発行したキーを指定します。クライアントはこのキーを Bearer 認証で送信します。設定方法は [Claude Code のゲートウェイ連携ドキュメント](https://code.claude.com/docs/en/llm-gateway-connect)を参照してください。

::: code-group

```bash [macOS / Linux]
export ANTHROPIC_BASE_URL='https://your-api-endpoint'
export ANTHROPIC_AUTH_TOKEN='sk-xxxxxxxx'
claude --model 'your-claude-model-id'
```

```powershell [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` に設定をマージできます。既存の設定は残してください。

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

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

### 呼び出しの確認

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

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

## Codex

まず [Codex 公式クイックスタート](https://developers.openai.com/codex/quickstart/)に従ってクライアントをインストールします。以下では、カスタムのモデルプロバイダー設定を使って OneGateway に接続します。設定フィールドは [OpenAI 公式のゲートウェイ連携ドキュメント](https://learn.chatgpt.com/docs/enterprise/connect-to-a-gateway)に基づいています。

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

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

```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 設定リファレンス](https://learn.chatgpt.com/docs/config-file/config-reference)を参照してください。

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

::: code-group

```bash [macOS / Linux]
export ONEGATEWAY_API_KEY='sk-xxxxxxxx'
codex
```

```powershell [Windows PowerShell]
$env:ONEGATEWAY_API_KEY = 'sk-xxxxxxxx'
codex
```

:::

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

### 呼び出しの確認

起動後に使用中のモデルとプロバイダーを確認し、簡単なリクエストを送信します。OneGateway の[リクエストログ](/ja/user/usage)で、リクエストがゲートウェイを経由し、想定どおりの 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、キーの利用可能なモデルの範囲、プロバイダーの状態とグループ料金 |
| ツール起動後も元のサービスに接続している | 個人設定がほかの設定で上書きされていないか、環境変数を設定したターミナルからクライアントを起動したか |
| 通常のチャットは使えるが、ツール呼び出しが失敗する | モデルと上流インターフェースが、ツール呼び出しとツールが要求するプロトコルに対応しているか |

その他の確認方法は[よくある質問](/ja/guide/faq#troubleshooting-order)を参照してください。