Cursor / Claude Code / Cherry Studio をカスタムAIゲートウェイに接続するガイド
主要な AI ツールはカスタム API に対応しています——つまり、自分のゲートウェイ(4-4 AI など)に向けて、キーと課金を一本化できます。本記事では最もよく使われる3つのツールの設定方法と、共通のエラー調査の考え方を扱います。
https://www.4-4.vip/v1)を例にしますが、他の OpenAI 互換ゲートウェイも同様です。Cursor
Cursor のチャットモデルはカスタム OpenAI 互換インターフェースを使えます:
Settings → Modelsを開く(またはModels設定ページ)。OpenAI API Keyエリアを展開して設定:ゲートウェイのキー(sk-...)を入力。Override OpenAI Base URLにチェックを入れ、https://www.4-4.vip/v1を入力。- モデルリストにゲートウェイで使えるモデル名を追加する(ゲートウェイのチャネル名と完全に一致させること、大文字小文字を区別)。
- Verify をクリックして検証が通ったら、チャット下部でカスタムモデルに切り替えるだけです。
注意:Cursor 内蔵の Tab 補完や Composer の一部機能は Cursor 自前のサービスを使うため、この設定の影響を受けません。カスタムモデルは主に Chat 対話で使います。
Claude Code
Claude Code は Anthropic プロトコルを使います。ゲートウェイに接続する前提はゲートウェイが Anthropic プロトコルエンドポイント(/v1/messages)をサポートしていることです——new-api エコシステム基盤のゲートウェイ(4-4 AI を含む)はこのプロトコル変換に対応しており、Claude プロトコルのリクエストは変換されて実際のモデルチャネルへルーティングされます。
環境変数で設定します(claude を起動するターミナルで):
export ANTHROPIC_BASE_URL="https://www.4-4.vip"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_GATEWAY_KEY"
# start
claude
Windows PowerShell の場合は:
$env:ANTHROPIC_BASE_URL = "https://www.4-4.vip"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_GATEWAY_KEY"
Cherry Studio
Cherry Studio はカスタム OpenAI 互換プロバイダの対応が最も直接的です:
設定 → モデルサービスで、OpenAI 互換プロバイダを追加・選択。- API アドレスに
https://www.4-4.vip/v1を入力(バージョンによっては /v1 が自動補完されるので重複に注意)。 - API キーにゲートウェイのキーを入力。
- モデル管理で利用可能なモデル名を手動追加し、保存後に対話で選択。
共通の法則:あらゆる OpenAI 互換ツール
世の中の多くのツール(LobeChat、Open WebUI、浸透式翻訳、各種 IDE プラグイン)の設定手順は同じです。3点セットを覚えてください:
| 設定項目 | 値 | よくある落とし穴 |
|---|---|---|
| Base URL | https://www.4-4.vip/v1 | ツールによって /v1 を付ける場合と付けない場合があります——404 エラーが出たらまず /v1 の付け外しを試す |
| API Key | ゲートウェイのキー(sk-...) | 前後の空白、キーの期限切れ、クレジット枯渇 |
| モデル名 | ゲートウェイチャネルでの名称 | ゲートウェイ側と完全に一致させること。ツールのプリセットにない名前は使えない |
エラー調査マニュアル(速見表)
401 Unauthorized
- キーのコピーに空白/改行が混入 → 再コピーする。
- キーが無効化またはクレジット枯渇 → ゲートウェイコンソールのトークンページで確認。
- Authorization ヘッダーの形式が誤り →
Bearer sk-...の形式であること。
404 Not Found
- Base URL のパスが違う → 「/v1 あり」と「/v1 なし」を切り替えてテスト。
- ツールが要求するプロトコルエンドポイントにゲートウェイが非対応 → ゲートウェイがそのプロトコル(OpenAI /v1/chat/completions または Anthropic /v1/messages)に対応しているか確認。
400 Model Not Found / 利用可能なチャネルなし
- モデル名がゲートウェイのチャネルと不一致 → コンソールのモデル/チャネルページで名称を確認。
- チャネルが無効化またはグループに権限なし → トークンのモデル範囲とグループ設定を確認。
ストリーミング出力が中断 / 無応答
- 会社のプロキシが SSE をバッファリング → 直接接続のネットワークでテスト。
- ツールのタイムアウト設定が短すぎる → タイムアウトを延長。長文タスクではまずゲートウェイ側に強制タイムアウトがないか確認。
よくある質問(FAQ)
ゲートウェイを経由するとデータは安全?
リクエストはゲートウェイを経由して上流のモデルチャネルへ転送されます。ゲートウェイ選定時はログとプライバシーポリシーを確認し、機密データについてはゲートウェイ側で対話ログの保存をオフにするか、データを保持しないチャネルを使ってください。
1つのツールで複数のゲートウェイを併用できる?
多くのツールは複数プロバイダ設定といつでもの切替をサポートしています(Cherry Studio、Cursor など)。ツールごとに別のトークンを使えば、使用量の集計や上限設定も分けられます。
ツールごとに各プロバイダへ直結するのではなく、統一ゲートウェイが推奨される理由は?
3つの理由:キーの一元管理(漏洩リスクの縮小)、課金と使用量の一元可視化(複数プラットフォームでの照合が不要)、モデルのいつでも交換(プロバイダ非依存、切替はゲートウェイ設定の変更だけ)。