カーソルのカスタム API の互換性

TokenHub に接続する前にカーソル ベース URL オーバーライドを確認し、チャット、エージェント、タブ補完を個別にテストします。

TokenHub API キーを作成

カーソルとは何ですか?

Cursor は、統合チャット、エージェント ワークフロー、コード編集、モデルを活用した開発機能を備えた AI ファーストのコード エディターです。

現在の Cursor ドキュメントでは、一般的なカスタム プロバイダー ルートが確立されていません。このガイドでは、TokenHub を条件付きとして扱います。インストールされているクライアントがカスタムのベース URL オーバーライドを明確に提供する場合にのみ TokenHub を構成し、各機能を個別にテストします。 Cursor は、すべてのバージョン、アカウント、および機能のユニバーサル サードパーティ プロバイダーのパスを文書化するものではありません。カーソル固有の機能は引き続き別のサービスを使用する可能性があるため、TokenHub ルートを表示される API キーとベース URL コントロールの条件付きとして扱い、標準のチャット、エージェント、適用、およびタブ補完を個別にテストします。

Cursor は TokenHub の OpenAI compatible 互換 API ゲートウェイ経由でモデルリクエストを送信できます。公式のインストール手順はそのまま使い、API key、Base URL、モデル ID だけを置き換えます。

Use https://us-api.tokenhub.com/v1 as the OpenAI Base URL override. Depending on the Cursor version and selected model, Cursor may use Chat Completions or Responses-style requests, so do not assume a single endpoint path.

使う場面

小さなリポジトリや検証用プロジェクトから始めます。まずは読み取り、コード説明、計画作成を試し、その後で編集や自動化タスクを有効にします。

インストールまたは起動

まず Cursor 公式ドキュメント に従ってインストールまたは起動します。画面名が違う場合は現在の公式ドキュメントを優先してください。

CLI ツールの場合、TokenHub 認証情報を追加する前に実行ファイルが使えることを確認します：

# open the tool, then open its model or provider settings

TokenHub 認証情報を準備

TokenHub API key を作成し、TokenHub のモデル一覧からこのツールに適したモデルを選びます。

export TOKENHUB_API_KEY="sk-..."

キーはローカル shell、IDE のシークレット保存領域、またはツールの安全な API key 欄に保存します。リポジトリにはコミットしないでください。

TokenHub プロバイダーを設定

Models、Providers、API Keys、OpenAI Compatible などの設定画面で次の値を入力します。

Provider の値

Cursor officially supports BYOK for specific providers and standard chat models. A custom OpenAI-compatible endpoint is currently a limited Base URL override, not a first-class custom provider.

項目値
SettingsCursor Settings → Models → API Keys
API key fieldOpenAI API Key
Base URL optionOverride OpenAI Base URL
Base URLhttps://us-api.tokenhub.com/v1
モデルA TokenHub model compatible with the request format Cursor sends

設定ファイルの場所

項目値
macOS~/Library/Application Support/Cursor/User/settings.json
Windows%APPDATA%\Cursor\User\settings.json
Linux~/.config/Cursor/User/settings.json

拡張機能が独自 schema を持つ場合は、まず設定 UI を使ってください。UI は同じ値をユーザー設定に保存し、バージョンで変わる内部キーを推測せずに済みます。

Custom keys apply only to standard chat models. Tab Completion and Cursor-owned models continue through Cursor. Some current Cursor versions can also send a Responses-shaped body to a Chat Completions path through the override, so verify a read-only chat before relying on Agent mode. If the Base URL override is absent or the request format is rejected, that Cursor version cannot connect to TokenHub reliably.

Do not map Chat, Agent, Composer, Apply, Fast, or Tab as if they were equivalent custom-provider slots. Start with one standard chat model and treat every other feature as unsupported until its requests appear successfully in TokenHub logs.

一時環境変数はデバッグ用

拡張機能が独自 schema を持つ場合は、まず設定 UI を使ってください。UI は同じ値をユーザー設定に保存し、バージョンで変わる内部キーを推測せずに済みます。

一時変数は key、ネットワーク、モデル名の確認にだけ使います。確認後は同じ値を上の永続設定に移してください。

接続を確認

まず読み取り専用のプロンプトで、モデルが文脈を読めること、ファイルを変更しないことを確認します。その後、編集や Agent タスクを試します。

このプロジェクトの README を読み、3 文で要約してください。ファイルは変更しないでください。

プロンプトが成功したら、TokenHub のリクエストログでモデル名、endpoint、token 使用量、課金グループを確認します。

トラブルシューティング

症状対処
401 または認証失敗TOKENHUB_API_KEY が有効で、同じ terminal、IDE、クライアントプロファイルに保存されているか確認します。
404 またはモデルが見つからないTokenHub ワークスペースに存在し、選択したプロトコルに対応するモデル ID を使います。
endpoint が違う上記の Base URL と完全に一致させます。OpenAI 互換ツールは通常 /v1 が必要で、Claude 互換ツールは通常不要です。
リクエストがタイムアウトするhttps://us-api.tokenhub.com へのネットワーク、プロキシ設定、ワークスペースの allowlist を確認します。
別のモデルが使われるchat、edit、apply、fast、autocomplete など全てのモデル欄を再確認します。

モデルの選び方

用途モデルの方向性理由
複雑なタスクツール対応の推論モデル計画、複数手順、長いコンテキストに向いています。
日常的な利用バランス型モデル品質、速度、コストのバランスを取れます。
要約と軽い作業高速・低コストモデル要約や簡単な反復のコストを抑えます。
TokenHub のモデルを見る

カーソルのカスタム API の互換性に関するよくある質問

Cursor に Override OpenAI Base URL 設定がないのはなぜですか?

設定はカーソルのバージョンとアカウントによって異なります。表示されるオーバーライド コントロールがなければ、このページは直接 TokenHub 構成ルートを確立しません。

TokenHub を構成した後もタブ補完でカーソルを使用できるのはなぜですか?

カスタム API キーまたはベース URL オーバーライドは、タブ補完やその他のカーソル固有の機能に必ずしも適用されるわけではありません。

チャットが成功したということは、Cursor Agent にも互換性があるということですか?

いいえ。カーソル機能では、さまざまなリクエスト形式とモデルパスを使用できます。チャット、編集、エージェントを個別にテストし、TokenHub リクエスト ログを確認します。

Cursor カスタムモデル 404 のトラブルシューティングを行うにはどうすればよいですか?

ベース URL が /v1 で終わり、モデル ID が現在の UI で受け入れられることを確認します。 TokenHub がリクエストを受信しない場合、そのカーソル機能はオーバーライドを使用できない可能性があります。

どのカーソル機能を個別にテストする必要がありますか?

標準のチャット、エージェント、適用、タブ補完を個別にテストします。カスタム プロバイダー設定は、一部のリクエスト パスにのみ影響する場合があります。

参考資料

この設定は TokenHub と公式ドキュメントに基づいており、最終確認日は 2026-09-04。

近いツールの設定方法とモデル互換性を比較できます。

ClineOpenAI CompatibleKilo CodeOpenAI CompatibleZed EditorOpenAI / AnthropicRoo CodeOpenAI Compatible