Claude APIでCursorを無制限に使う

CursorはAI搭載コードエディタの中でも特に人気が高く、OpenAI Base URLの上書き機能を使うことで、自分のAPIキーを持ち込んで利用できます。この上書き先を定額制のClaude APIゲートウェイであるAI Prime Tech Unlimitedに向けると、トークン課金を気にせずCursor内でClaudeを使えます。このガイドでは、初期設定から高度な使い方、モデル選定の考え方、よくあるエラーの解決、そしてCursorを本格的に使う開発者にとってClaude無制限がなぜ大きな意味を持つのかまで、実務目線で詳しく説明します。

事前準備と必要なもの

Cursorで無制限Claudeゲートウェイを使う前に、まず2つのものを用意します。1つ目は動作するCursor本体です。現在の設定画面の構成に対応しているバージョンとして、Cursor 0.40以降を使うのがおすすめです。2つ目はAI Prime Tech Unlimitedで発行された有効なAPI keyです。AI Prime Tech UnlimitedはOpenAI Chat Completions互換のendpointを提供しているため、Cursor側から見るとOpenAI互換APIとして扱えます。つまり、Claudeを接続する場合でもCursorのAnthropic欄ではなく、OpenAIのカスタム設定欄に入力するのが正しい手順です。Claude API 購入後に発行されるClaude API キーを、そのままCursorのOpenAI互換ルートへ設定するイメージです。

Base URLはあらかじめ確認しておきましょう。AI Prime Tech UnlimitedのURLは https://claudeapikey.dev/v1 です。ここで重要なのは末尾の /v1 まで含めることです。Cursorは入力されたBase URLに対して、自動的に /chat/completions を追加します。そのため、Base URL欄には /v1 までを入力し、それ以上のpathを足してはいけません。API keyはAI Prime Tech Unlimitedのdashboardから取得したものを使います。CursorでVerifyをクリックすると、その場で実際の通信が行われるため、設定時点でゲートウェイに接続できる必要があります。会社のproxy、VPN、ゼロトラスト系ネットワークを使っている場合は、unlimited.aiprimetech.io 宛てのoutbound HTTPSが許可されているかも確認してください。

構成上のポイントとして、Cursorのカスタムキー設定は基本的にグローバルに効きます。OpenAI Base URLのoverrideを有効にすると、OpenAI互換pathを通るカスタムモデルのchat trafficは、指定したBase URLへ送られます。Cursor内で他のproviderも併用している場合、どのモデルがOpenAI互換pathを使うのかを意識しておくと混乱を避けられます。特に、Claude API 料金を気にして従量課金のAPIと無制限ゲートウェイを切り替えている人は、設定がどの経路に適用されるかを把握しておくことが大切です。AI Prime Tech UnlimitedはClaude無制限の開発体験を実現するためのゲートウェイなので、Cursorで大量にchat、edit、code reviewを行う用途と相性が良い構成です。

Base URLとAPIキーの設定手順

Cursorを開き、sidebarのgear iconからSettingsを開きます。ショートカットを使う場合はWindowsまたはLinuxならCtrl+Comma、macOSならCmd+Commaです。設定画面の左側navigationからModelsを選択し、OpenAI API Keyのsectionまでscrollします。ここには主に2つの入力欄があります。1つはBase URL override用のfield、もう1つはAPI keyそのものを入力するfieldです。Claudeを使うのにOpenAI欄を触るのは少し直感に反するかもしれませんが、AI Prime Tech UnlimitedがOpenAI互換endpointを提供しているため、このルートが正解です。

Override OpenAI Base URLのtoggleを有効にし、Base URL欄に https://claudeapikey.dev/v1 を貼り付けます。そのすぐ下にあるOpenAI API Key欄には、AI Prime Tech UnlimitedのAPI keyを貼り付けます。画面上のlabelはOpenAI API Keyですが、実際のrequestはあなたが指定したcustom endpointへ送られ、その先でClaudeへforwardされます。Cursorはcustom providerをOpenAI-compatible path経由で扱う設計になっているため、Claude API キーを使う場合でもこの入力欄を使います。Claude Code API キー設定に慣れている人なら、env varにkeyを入れてCLIから呼ぶ代わりに、CursorのUIにBase URLとkeyを入れる、と考えると理解しやすいでしょう。

Base URLには /chat/completions を追加しないでください。Cursorがそのpath segmentを自動で付けます。もし誤って https://claudeapikey.dev/v1/chat/completions のように入力すると、実際のrequest先は /v1/chat/completions/chat/completions のように重複したpathになり、404 errorが返ります。この場合、見た目上は認証に失敗したように感じることがありますが、原因はAPI keyではなくpathの二重化です。正しい値は常に /v1 のrootまでで、末尾slashも追加しないのが安全です。設定をコピーする際は、前後に空白が入っていないかも確認しておくと、余計な認証エラーを避けられます。

Claudeモデルの追加とVerify

Base URLとAPI keyを入力したら、次にCursorへ利用するClaude modelを追加します。Models画面で + Add Model buttonをクリックし、ゲートウェイが公開している正確なmodel identifierを入力します。例としては claude-sonnet-4-5、claude-opus-4-6、claude-haiku-4-5 などがあります。ここで入力する文字列はrequestのmodel fieldにそのまま入るため、スペルやhyphenの位置まで完全一致している必要があります。Cursorはmodel nameを自動変換したり、別名にaliasしてくれたりしません。

モデルを追加したら、そのmodel toggleが有効、つまりgreenになっていることを確認します。そのうえでVerifyをクリックします。CursorはあなたのBase URL、API key、追加したmodel nameを使って実際のAPI callを送ります。URL pathが正しく、keyが有効で、ゲートウェイ側が稼働していればVerifyは成功します。成功したらSaveを押して設定を保存します。失敗した場合は、まず3つの典型的な原因を確認しましょう。/v1 suffixが抜けている、model stringが間違っている、API keyが期限切れまたは無効になっている、の3つです。Claude API 購入直後にkeyを作った場合でも、dashboardで有効状態になっているか確認すると安心です。

保存後は新しいchatを開いて動作確認します。Ctrl+L、macOSならCmd+Lで新規chatを開き、chat panel上部のmodel picker dropdownから、先ほど追加したClaude modelを選択します。その状態で短いtest messageを送信してください。Claudeからresponseが返ってくれば、CursorからAI Prime Tech Unlimitedの無制限ゲートウェイを経由してClaudeを呼び出すend-to-end接続は成功です。以後は、Cursor内のchat、manual edit、code explanation、test generationなどで、定額のClaude無制限環境を活用できます。

高度なワークフローとモデル選定の考え方

Cursorで日常的なcodingをする場合、たとえば関数の実装、bugの原因調査、既存コードの説明、unit test生成、軽いrefactor案の相談などでは、Claude Sonnetを標準モデルにするのが実用的です。Sonnetはresponse速度とreasoning品質のバランスが良く、多くの編集作業に十分対応できます。一方で、より深い設計判断が必要な場面、複雑なarchitectureの見直し、大規模なcodebase全体をまたぐ依存関係の分析、微妙な副作用を含むrefactoring planの作成には、Claude Opusを使う価値があります。Sonnetでは見落としやすい細かな関係性も、Opusならより丁寧に拾えることがあります。

Cursorには複数のClaude modelを同時に追加できます。普段使いとして claude-sonnet-4-5 を登録し、より重い推論が必要なときのために claude-opus-4-6 を追加しておく構成が便利です。conversationごとにmodel pickerから切り替えられるので、作業内容に応じて柔軟に選べます。AI Prime Tech Unlimitedのような定額プランでは、強いmodelを使ったからといってそのたびに追加のClaude API 料金が発生するわけではありません。従量課金のようにtoken数を気にして質問を削る必要がないため、本当に必要な場面でOpusを選びやすくなります。tradeoffは主にlatencyで、OpusのresponseはSonnetより少し遅くなることがあります。

短い質問、素早いcompletion、formattingの相談、軽量な修正案の確認など、response speedを優先したい場面ではClaude Haikuが役立ちます。claude-haiku-4-5 を3つ目のoptionとして追加しておくと、深い推論よりもテンポを重視したいときに切り替えられます。無制限プランではSonnet、Opus、Haikuの使い分けをコスト面で過度に悩む必要がありません。作業の性質に合わせて、速さが必要ならHaiku、普段の実装ならSonnet、難しい設計や調査ならOpus、というように使い分けると、Cursorでの開発効率が大きく上がります。

CursorのCustom Key利用時に知っておくべき制限

Cursorでは、providerに関係なくcustom key利用時に一部機能の挙動が異なります。代表的なのがCursor Tabです。入力中にinline autocompleteとして表示されるCursor Tabは、常にCursor側のbuilt-in modelを使います。あなたが設定したAI Prime Tech Unlimitedのgatewayにはroutingされません。これはゲートウェイ側の制限ではなく、Cursor側の仕様です。つまり、無制限keyで利用できるのは主にchat、edit、manual completionなどの機能であり、Tab autocompleteは別系統として扱われます。

Agent modeやComposer modeにもcustom key特有の制約があります。Ask、Plan、Chatといったmodeはcustom key path経由でも比較的安定して動作します。一方で、Cursorが自律的に複数ファイルを編集するagentic editingは、完全なtool-call supportやCursor側の内部実装に依存するため、どのproviderを使っていても制限を受ける場合があります。深いagentic editingを多用したい場合は、CursorとあわせてClaude CodeやClineのような専用agentを使う運用も検討できます。Claude Code API キー設定を別途行い、CLIやagent側では同じClaude API キーを使う、といったワークフローも開発チームではよく使われます。

また、CursorのUIにはrequest timeoutを細かく調整する設定が公開されていません。複雑なqueryでOpusを選んだ場合など、responseまで時間がかかるとchatが止まったように見えることがあります。これは必ずしも異常ではなく、重い推論を待っている状態の可能性があります。急ぎのfeedback loopではSonnetやHaikuへ切り替え、深い分析が必要な場面だけOpusを使うと快適です。定額のClaude無制限プランであれば、長いresponseを待っている間にもper-token costが積み上がる不安がないため、必要な場面では大きめのcontextを渡してじっくり分析させる使い方がしやすくなります。

よくある問題のトラブルシューティング

もっとも多い失敗は、Verify時の404 errorです。これはほぼBase URLのpathが間違っていることを意味します。入力値が正確に https://claudeapikey.dev/v1 になっているか確認してください。末尾slashは不要で、/chat/completions のような追加pathも入れません。Cursorは /chat/completions を自動で追加するため、最終的なrequest先は https://claudeapikey.dev/v1/chat/completions になります。もし設定欄に /chat/completions まで入れてしまうと、存在しない二重pathに送信され、404になります。/v1が抜けている場合も同じように失敗します。あわせてmodel stringがゲートウェイ側の公開名と完全一致しているかも確認しましょう。

Verifyは成功するのにchat responseが失敗する場合は、chat pickerで正しいmodelを選んでいるかを確認してください。Cursorではoverrideを有効にしていても、会話画面でcustom modelを明示的に選ばないと、built-in modelへ戻っているように見えることがあります。model pickerに表示されている名前が、Models設定で追加したClaude modelと一致しているかを毎回確認すると安全です。特に複数のClaude modelや他providerを登録している環境では、会話ごとに選択中のmodelが変わっていないかを意識しておくと、原因切り分けが早くなります。

401または403のauthentication errorが出る場合は、API keyが間違っている、期限切れになっている、または要求したmodelへのaccess権がない可能性があります。dashboardからkeyを再度コピーし、先頭や末尾に空白が入らないように貼り直してください。keyをpassword manager経由で貼り付けた場合、見えない改行やspaceが混ざることもあるため注意が必要です。ゲートウェイが一時的にmaintenance中の場合はconnection errorが出ることがありますが、その場合はservice復旧後に解消します。問題が続く場合は、Base URL、key、model name、network policyの4点を順に確認するのが最短です。

無制限アクセスがCursor利用を変える理由

Cursorを本格的に使う開発日には、API requestが簡単に数百回に達します。chat messageを送るたび、inline editを依頼するたび、コードの説明を求めるたび、test生成を行うたびに、それぞれ別のAPI callが発生します。さらに、入力側にはcode contextや会話履歴のtokenが入り、出力側にはmodelのresponse tokenが発生します。従量課金のClaude API 料金では、大きなファイルを扱ったり長いconversationを続けたりすると、想定以上のコストになることがあります。結果として、質問する前に「これは聞くほどの価値があるか」と考えてしまい、AI editorの強みを使い切れないことがあります。

無制限モデルはこの摩擦を大きく減らします。一度gatewayを設定すれば、あとは作業に必要なだけCursorを使えます。meterを見張る必要も、token数を頭の中で概算する必要も、大きなファイルをreviewに出す前に躊躇する必要もありません。定額subscriptionにより、月額の見通しを立てやすくなり、開発中の判断がシンプルになります。Claude API 購入を検討している開発者にとって、従量課金APIを直接使うか、AI Prime Tech Unlimitedのような定額ゲートウェイを使うかは、利用頻度で大きく変わります。Cursorを毎日長時間使うなら、Claude無制限の価値は非常に高くなります。

このメリットは、開発が忙しい局面ほど大きくなります。新機能のship直前、production issueのdebug、未知のcodebaseへのonboarding、大規模なrefactor、test不足のlegacy codeの理解などは、まさにClaudeに何度も質問したくなる場面です。そうしたタイミングでcostを気にして利用を控えるのは、生産性の観点ではもったいない選択です。無制限アクセスがあれば、必要なときに最大限Claudeへ頼れます。Cursorの中で設計相談、差分review、error log解析、test case作成を連続して行っても、per-request課金を気にしなくて済みます。結果として、AIを補助ツールではなく日常的な開発partnerとして使いやすくなります。

# Cursor Settings -> Models -> OpenAI API Key
#
# 1. 有効化: Override OpenAI Base URL
# 2. Base URL: https://claudeapikey.dev/v1
# 3. API Key:  <your AI Prime Tech Unlimited key>
# 4. + Add Model: claude-sonnet-4-5
#    （必要に応じて claude-opus-4-6 と claude-haiku-4-5 も追加）
# 5. Verify をクリック -> Save
# 6. New Chat (Ctrl+L) -> Claude modelを選択 -> coding開始
#
# gatewayはOpenAI Chat Completions形式で通信します。
# CursorはBase URLに /chat/completions を自動で追加します。

FAQ

CursorではAnthropic欄とOpenAI欄のどちらを使いますか？
OpenAI欄を使い、Override OpenAI Base URLを有効にします。AI Prime Tech UnlimitedのgatewayはOpenAI互換なので、CursorのOpenAI custom-key pathを使うのが正しい設定です。Cursor内のAnthropic欄はapi.anthropic.comへ直接接続する用途で、custom Base URLを同じようには扱えません。

Verifyが404 errorで失敗するのはなぜですか？
Base URLが間違っている可能性が高いです。https://claudeapikey.dev/v1 を正確に入力してください。末尾slashも /chat/completions suffixも不要です。Cursorが /chat/completions を自動で追加します。二重pathや /v1 の不足が404の原因になります。model stringがゲートウェイで公開されている名前と一致しているかも確認してください。

Cursor Tabのautocompleteは無制限keyで動きますか？
いいえ。Cursor Tabはcustom key設定に関係なく、常にCursor側のbuilt-in modelを使います。無制限keyが使われるのはchat、edit、manual completionなどの機能です。Tab autocompleteはCursor内部の別機能として扱われます。

Cursorで複数のClaude modelを同時に使えますか？
はい。Sonnet、Opus、Haikuなど複数のmodelを追加し、conversationごとにchat pickerで切り替えられます。無制限プランではmodelごとの従量コスト差を気にする必要がないため、速度とreasoningの必要度に応じて選べます。

Cursorで無制限プランを使う場合、requestごとの料金はかかりますか？
いいえ。定額subscriptionには、plan期間中の対象利用が含まれます。per-token課金やper-request課金はありません。ただし、すべてのユーザーに安定したgateway応答を提供するため、公平利用のためのrate limitは適用されます。