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

Cursor のカスタムキーはアプリ自身の設定に保存され、CodeNodex CLI からは安全に書き込めません。--client cursor がするのは 2 つだけ。キーを検証し、手入力すべき 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 のバージョンでメニュー名は変わりますが、値は 3 つで固定です。OpenAI provider、末尾が /v1 の Base URL、キーのグループに実在するモデル ID。

Cursor でタスクを動かす前に、モデル一覧を直接取得します。これで「ゲートウェイの認証は通っているか」と「Cursor 側のモデル設定は合っているか」を切り離せます。

レスポンスが返ってくるのは、キーと Base URL が通っている証拠にすぎません。Cursor で使いたいモデル ID が本当にその結果に含まれているかも確認してください。

Cursor で使い捨てのディレクトリを開き、先ほどのモデルを選んで、結果が確認しやすい低リスクのタスクを 1 つだけ渡します。関数の説明や、純粋関数への単体テスト追加が向いています。

3 つを同時に見ます。モデルセレクター、レスポンスが完全に戻ったか、CodeNodex の使用量ログ。3 つが揃って初めて、Cursor が別の provider に黙ってフォールバックしていないと言えます。

401 は通常、キーが違うか無効です。404 は /v1 が二重に付いた、モデル ID が存在しない、エンドポイントのパスが合わない、のいずれかが多いです。429 は残高・同時実行数・上流の制限を確認してください。

curl は通るのに Cursor が失敗するなら、Override OpenAI Base URL をもう一度確認し、競合する provider が同時にオンになっていないか調べます。タイムアウトなら、まずプロンプトを短くして再試行し、それからネットワークとモデル状態を疑います。