コンテンツへスキップ
1折AI ドキュメント
日本語

Cursor連携

カスタムのOpenAI APIキーとBase URLを使って、Cursorから1折AIのClaudeモデルを呼び出す方法と、カスタムAPIキーが使用されない機能について。

Cursorでは設定画面から独自のAPIキーを入力でき、チャットモデルはこのAPIキーを使ってリクエストを送信します。以下は1折AIへの接続方法と、事前に知っておくべきいくつかの制限事項です。

始める前に、次の3点を理解してください。

  • Cursorの公式ドキュメントによると、カスタムAPIキーはチャットモデルにのみ適用され、Tab補完は常にCursor独自のモデルを使用します。
  • リクエストはCursorのサーバーを経由してから、入力したアドレスに送信されるため、Base URLは公開アクセス可能でなければなりません（https://1zheai.com/v1は問題ありませんが、ローカルのlocalhostプロキシは使用できません）。
  • 「Override OpenAI Base URL」トグルはCursorの公式ドキュメントには記載されていません。以下のインターフェースの説明はCursorフォーラムやコミュニティのチュートリアルに基づいており、Cursorのアップデート後に変更される可能性があります。

設定

「設定」というセクション

  1. モデル設定を開く

    Cursor → Cursor Settings → Models と進み、Keysセクションを見つけます。

  2. OpenAI API Key と Base URL を入力

    text
    OpenAI API Key              sk-你的Key（1折AI 的 Key）
    Override OpenAI Base URL    https://1zheai.com/v1

    Base URLには/v1を含める必要があります。

  3. モデルを追加する

    モデル一覧のAdd modelをクリックし、モデルIDを入力します（例：claude-sonnet-5-5）。その後、トグルをオンにします。モデルIDについては対応モデル を参照してください。

  4. チャットで一度試す

    チャットパネルで新しく追加したモデルを選択し、メッセージを送信します。返信が正常に戻ってきたら、コンソールの呼び出しログ でこの呼び出しを確認してください。

既知の問題

「既知の問題」というセクション

Cursorフォーラムには次のフィードバックがあります。Override OpenAI Base URLを設定した後、名前がclaude-で始まるモデルはCursorによってAnthropicモデルとして扱われ、Anthropic APIキーで処理されるか、エラーが直接発生することがあります。Claudeを選択する場合、モデルIDはclaude-で始まります。この問題に遭遇した場合は、まずCursorに入力済みのAnthropic APIキーをすべてクリアしてから再試行してください。

参考：フォーラム投稿144899 、フォーラム投稿146998 。

よくある質問

「よくある質問」というセクション
Tab 補完は 1折AI を使いますか？

いいえ。Cursorの公式ドキュメントによると、Tab補完は常にCursorの組み込みモデルを使用し、あなたのAPIキーを経由しません。

Verify をクリックしても失敗する？

まず、Base URLに/v1が含まれていることを確認してください。コミュニティのフィードバックによると、VerifyボタンはOpenAI以外のモデル名では必ずしも通過するとは限りません。チャットで直接メッセージを送信してテストできます。判定基準は呼び出しログに記録があるかどうかです。

Agent / Composer は使えますか？

コミュニティのチュートリアルでは、一般的にカスタムAPIキーを使用するのはChatのみで、Agent、Apply、Inline Editなどの機能は依然としてCursor独自のバックエンドを経由する可能性があると報告されています。実際に呼び出しログに表示される記録を頼りにしてください。

エディタで Claude を完全に使いたい？

主にClaudeでコードを書きたい場合は、Claude Code （コマンドラインまたはVS Code拡張機能）やCline の方が、カスタムアドレスのサポートがより完全です。