Cursor を CodeNodex に接続する：カスタム API キーと Base URL

Cursor はカスタムキーをアプリ設定に保存するため、CodeNodex CLI は Cursor の構成を書き込みません。--client cursor はキーを検証し、手動入力用の Base URL、キー、provider 値を表示します。

CodeNodex の OpenAI グループでキーを作成します。リクエストには、そのキーで返される正確なモデル ID を使用し、Web インターフェースの表示名は使用しません。

Cursor Settings を開き、Models または API Keys を探します。カスタム OpenAI API キーを有効化し、CodeNodex のキーを入力し、Override OpenAI Base URL を https://token.codenodex.com/v1 に設定します。

Cursor のバージョンによりメニュー名は異なります。必要な値は OpenAI provider、末尾が /v1 の Base URL、キーで利用可能な正確なモデル ID です。

Cursor でタスクを実行する前に、モデル一覧を直接照会します。この確認により、ゲートウェイ認証と Cursor のモデル構成を分離できます。

成功レスポンスはキーと Base URL のみを検証します。対象のモデル ID がレスポンスに含まれることも確認します。

一時ディレクトリで Cursor を開き、構成済みのモデルを選択して、関数の説明や純粋関数への単体テスト追加など、結果を確認できる低リスクのタスクを一つ実行します。

モデルセレクター、レスポンス完了、CodeNodex の使用量記録を確認します。3 つの値が一致すれば、Cursor が構成済みの provider とキーを使用したことを確認できます。

401 は通常、キーが無効または停止されていることを示します。404 は /v1 の重複、利用できないモデル ID、不正なエンドポイントパスを示す場合があります。429 では残高、同時実行数、上流制限を確認します。

curl は成功し Cursor が失敗する場合、Override OpenAI Base URL を確認し、競合する provider が有効になっていないことを確認します。タイムアウトでは短いリクエストをテストしてから、ネットワークとモデルの状態を調査します。