Cursor / Claude Code / Cherry Studio をカスタムAIゲートウェイに接続するガイド

チュートリアル · 2026-11-20 · 約7分で読める

主要な AI ツールはカスタム API に対応しています——つまり、自分のゲートウェイ(4-4 AI など)に向けて、キーと課金を一本化できます。本記事では最もよく使われる3つのツールの設定方法と、共通のエラー調査の考え方を扱います。

前提条件:API キーをお持ちであること。まだなら、まず《5分で統一AI APIに接続》で登録とキー作成を済ませてください。本記事は 4-4 AI の Base URL(https://www.4-4.vip/v1)を例にしますが、他の OpenAI 互換ゲートウェイも同様です。

Cursor

Cursor のチャットモデルはカスタム OpenAI 互換インターフェースを使えます:

  1. Settings → Models を開く(または Models 設定ページ)。
  2. OpenAI API Key エリアを展開して設定:ゲートウェイのキー(sk-...)を入力。
  3. Override OpenAI Base URL にチェックを入れ、https://www.4-4.vip/v1 を入力。
  4. モデルリストにゲートウェイで使えるモデル名を追加する(ゲートウェイのチャネル名と完全に一致させること、大文字小文字を区別)。
  5. 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"
2つのポイント:① ANTHROPIC_BASE_URL に /v1 接尾辞を付けない(Anthropic プロトコルのパスはツールが自動で付加);② Claude Code に Claude 系以外のモデルを使わせたい場合は、ゲートウェイのチャネルに対応するモデルマッピングが設定済みか確認し、モデル名はゲートウェイ側の名称を使う。

Cherry Studio

Cherry Studio はカスタム OpenAI 互換プロバイダの対応が最も直接的です:

  1. 設定 → モデルサービスで、OpenAI 互換プロバイダを追加・選択。
  2. API アドレスに https://www.4-4.vip/v1 を入力(バージョンによっては /v1 が自動補完されるので重複に注意)。
  3. API キーにゲートウェイのキーを入力。
  4. モデル管理で利用可能なモデル名を手動追加し、保存後に対話で選択。

共通の法則:あらゆる OpenAI 互換ツール

世の中の多くのツール(LobeChat、Open WebUI、浸透式翻訳、各種 IDE プラグイン)の設定手順は同じです。3点セットを覚えてください:

設定項目値よくある落とし穴
Base URLhttps://www.4-4.vip/v1ツールによって /v1 を付ける場合と付けない場合があります——404 エラーが出たらまず /v1 の付け外しを試す
API Keyゲートウェイのキー(sk-...)前後の空白、キーの期限切れ、クレジット枯渇
モデル名ゲートウェイチャネルでの名称ゲートウェイ側と完全に一致させること。ツールのプリセットにない名前は使えない

エラー調査マニュアル(速見表)

401 Unauthorized

404 Not Found

400 Model Not Found / 利用可能なチャネルなし

ストリーミング出力が中断 / 無応答

よくある質問(FAQ)

ゲートウェイを経由するとデータは安全?

リクエストはゲートウェイを経由して上流のモデルチャネルへ転送されます。ゲートウェイ選定時はログとプライバシーポリシーを確認し、機密データについてはゲートウェイ側で対話ログの保存をオフにするか、データを保持しないチャネルを使ってください。

1つのツールで複数のゲートウェイを併用できる?

多くのツールは複数プロバイダ設定といつでもの切替をサポートしています(Cherry Studio、Cursor など)。ツールごとに別のトークンを使えば、使用量の集計や上限設定も分けられます。

ツールごとに各プロバイダへ直結するのではなく、統一ゲートウェイが推奨される理由は?

3つの理由:キーの一元管理(漏洩リスクの縮小)、課金と使用量の一元可視化(複数プラットフォームでの照合が不要)、モデルのいつでも交換(プロバイダ非依存、切替はゲートウェイ設定の変更だけ)。

関連記事

4-4 AI クイックスタート:5分で統一AI APIに接続 OpenAI 互換インターフェースで、1つのキーで GLM・DeepSeek・Qwen など主要モデルに接続。3言語の実行可能なサンプル付き。 AIアプリのトークンコストを削減する7つのエンジニアリング実践 モデル階層ルーティング、コンテキスト削減、プレフィックスキャッシュ、予算ガードレール——コードに書いて長く効く7つの削減実践を、費用対効果の順で、サンプル付きで。
接続する準備はできましたか?

1つのキーで GLM、DeepSeek、Qwen などの主要モデルに統一接続。課金の統一と使用量の可視化に対応。

モデルと料金を見る 登録して試す