Cursor のインストールと API 設定
Cursor をインストールし、BetterToken の Base URL と API Key、互換プロバイダーのモデルを設定して、よくあるエラーを解決します。
Cursor を BetterToken に接続するには、API Key を用意し、次の Base URL とモデル一覧にある現在の Model ID を入力します。
主要設定
| フィールド | 値 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | モデル一覧にある現在の Model ID |
前提条件
アカウントをお持ちの方は、ログインして残高をチャージし、コンソールでキーを作成してください。
追加要件
- Cursor をインストールします（Cursor をダウンロード）
インストール
Cursor のウェブサイトから現在のバージョンをダウンロードしてインストールします。カスタムモデルを利用できる Cursor アカウントでサインインし、次の手順に進んでください。
Cursor の BYOK ルールでは、OpenAI BYOK は推論を行わない標準的なチャットモデルに限られます。Tab 補完には引き続き Cursor 内蔵のモデルが使われます。プロンプトの構築には Cursor のバックエンドを経由します。API Key はリクエストごとに送信され、完了後は保持されません。BYOK のデータ処理には、Cursor の Zero Data Retention ポリシーではなく、選択したプロバイダーのポリシーが適用されます。
Teams と Enterprise プランでは、対象の BYOK リクエストも Cursor Token Rate に従って Cursor の使用量に算入され、モデルの利用料金はモデルプロバイダーから別途請求されます。チームのクレジット、従量課金の使用量、支出上限を確認してください。利用枠を使い切ると、リクエストが停止する場合があります。個人向けプランには別の利用ルールがあるため、プランの詳細を参照してください。
手動設定
Cursor の設定画面で次の操作を行います。設定ファイルを編集する必要はありません。
| Cursor のフィールド | 値 |
|---|---|
| Override OpenAI Base URL | 有効 |
| Base URL | https://bettertoken.ai/v1 |
| OpenAI API Key | 使用する BetterToken API Key |
| モデル広場から正確な Model ID をコピーしてください。 |
設定手順
モデル設定を開く
Cursor の左下にある Settings をクリックし、Models を開きます。API Keys までスクロールしてください。
Base URL と API Key を入力する
API Keys で、次の順序でフィールドを設定します。
- Override OpenAI Base URL を有効にします
- Base URL フィールドに
https://bettertoken.ai/v1を入力します - OpenAI API Key に BetterToken API Key を貼り付けます
- URL と Key を入力した後、OpenAI API Key のトグルを有効にします
トグルを有効にする前に Key を入力してください。Cursor に認証確認ダイアログが表示されます。
OpenAI API Key を有効にする
確認ダイアログで Enable OpenAI API Key をクリックします。
モデル一覧を更新してモデルを有効にする
Models に戻り、モデルを選ぶ前に右側の更新ボタンをクリックします。モデル一覧の更新が完了するまで待ってください。
モデル広場から正確な Model ID をコピーしてください。
チャットに戻って Auto を無効にする
設定後、Cursor のチャット画面に戻り、入力欄の下にあるモデル選択を開きます。Auto が有効な場合は、先に無効にしてください。
モデルを選択してチャットを開始する
有効にしたモデルを選び、チャットを開始します。
接続の確認
短いテストプロンプトを送信します。認証エラーや Model ID エラーがなく応答が返れば、接続は完了です。設定を変更した後は、ツールを完全に再起動してください。
Cursor CLI の制限
公式 Cursor CLI（cursor-agent）は Cursor アカウント認証を使います。CURSOR_API_KEY は Cursor Key であり、BetterToken API Key ではありません。--endpoint オプションは Cursor サービスのアドレスを指定します。公式の認証とパラメーターのリファレンスには、OpenAI 互換 Base URL の記載がありません。このページのデスクトップ向け BYOK 設定は Cursor CLI には適用されません。
モデルの切り替え
モデル選択を開くか、設定の Model フィールドを変更します。モデル一覧にある正確な Model ID を使用し、現在のセッションを再起動してください。
よくあるエラー
カスタム API と API Key のエラー
モデルや Key を変更する前に、Cursor のカスタム OpenAI API 設定と現在の設定を比較してください。
Custom API、API Key、Base URL の項目が表示されない
Cursor のプランとクライアントのバージョンを確認してください。カスタムモデルは、対応する有料プランでのみ利用できます。Cursor を更新した後、Settings → Models を開き直します。
API Key を有効化または検証できない
OpenAI API Key のトグルを有効にする前に、Base URL https://bettertoken.ai/v1 と API Key を入力します。Base URL に /chat/completions を追加せず、Claude プロバイダーの Key を使わないでください。
更新後もモデルが表示されない
モデル広場から正確な Model ID をコピーしてください。
Cursor の組み込みモデルが動作しなくなる
Override OpenAI Base URL はグローバル設定です。BetterToken を使わないときは、このトグルを無効にして Cursor が自身の Base URL を使えるようにしてください。
チャットで別のモデルが選ばれる
モデル選択を開き、Auto を無効にします。その後、有効にしたモデルを手動で選択してください。
関連する質問
技術情報
プロトコル、エンドポイント、内部プロバイダーフィールド
この設定では https://bettertoken.ai/v1 を使用します。ツールが OpenAI 互換エンドポイントのパスを追加します。特定のフィールドで明示的に必要な場合を除き、/chat/completions や /responses を追加しないでください。
補足
モデル広場から正確な Model ID をコピーしてください。
