ホームガイド
Cursor 用 Claude Code API:カスタムエンドポイント設定
特定のベンダーに依存しないclaude code api for cursor設定をお探しですか?Cursorは任意のOpenAI互換エンドポイントと連携でき、このガイドでは必要な設定を順に示します。
更新日:

セットアップ内容
Cursorは内蔵AI機能を備えたエディターです。モデル設定には、OpenAIのBase URLを独自のものに置き換え、独自のキーを入力するフィールドがあります。これにより、OpenAIのchat-completions形式に従う任意のサービスにチャットリクエストを送信できます。このサービスはそれに従うため、Cursorはチャットやインライン編集のモデルとしてそれを使用できます。
入力する値は固定です。ベース URL: https://api.claudecodeapikey.com/v1。モデル名: uncensored。キー: アカウントから取得したキーで、Bearer トークンとして送信します。サーバー側で他に設定すべきことはありません。
これが何であるかを明確にしてください。エンドポイントの背後にあるモデルは、独立したプロバイダのオープンウェイトモデルです。Claude モデルではなく、Anthropic 公式の API でもありません。Cursor 内に Claude 自体を期待してここに来た場合、これは別のものです。最後のセクションで、あなたの作業に十分な性能かどうかを判断する方法を説明します。
Cursor を開く前に
途中で止まらないよう、事前にこれらを用意してください。
- Google またはメールとパスワードでアカウントを作成します。
- API キーページを開き、キーを作成します。キーガイドに各ボタンの場所が示されています。
- 支払いなしでテストしたい場合は、$0.50の無料トライアルクレジットを取得してください。ワンクリックで、カード不要、7日間有効です。
- エディタのせいにする前に、ターミナルからクイックチェックを実行してキーが動作することを確認してください。
curl https://api.claudecodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'
メッセージ付きの JSON 応答は、キーと URL が正しいことを意味します。HTTP 401 は、キーが間違っているか、余分な空白が含まれていることを意味します。ここで修正してください。Cursor のエラーメッセージは curl よりも具体的でないためです。
Cursor でのステップバイステップ設定
メニュー名は Cursor のバージョンによって異なるため、以下のラベルは参考として扱い、最も近い一致を探してください。
- Cursorの設定を開き、モデルセクションに移動します。
- OpenAI APIキーのフィールドを見つけ、このサービスからのキーを貼り付けます。
- OpenAI のベース URL の上書きオプションを有効にし、
https://api.claudecodeapikey.com/v1を入力します。末尾に/v1を含め、/chat/completionsなどの末尾パスは残さないでください。 - カスタムモデルの追加オプションを使用し、小文字で
uncensoredを正確に入力します。 - キーフィールドの横にある検証または保存ボタンを押します。Cursor は小さなテストリクエストを送信します。
- チャットパネルを開き、モデルドロップダウンで
uncensoredを選択し、短いプロンプトを送信します。
検証ステップで失敗したがcurlチェックが成功した場合は、URLをキーフィールドではなくBase URLフィールドに入力したか、またアップデート後にCursorのバージョンが上書きをリセットしていないか確認してください。このエディター向けの現在のステップはクイックスタートに保存されています。
知っておくべき詳細:1 つの上書きは OpenAI プロバイダースロットに適用されます。そのスロットを通じて実際の OpenAI モデルも使用する場合、それらもこのエンドポイントにルーティングされます。多くのユーザーは別の Cursor プロファイルを使用するか、切り替える際に上書きを無効にします。
実際のコーディングプロンプトでテスト
挨拶はほとんど証明になりません。コンテキストと指示を試すプロンプトを使用してください。プロジェクト内の関数を選択し、チャットを開き、入力検証とユニットテストの追加など具体的なものを依頼します。3つの点に注意してください。
- ストリーミング。 回答はトークン単位で表示されるはずです。エンドポイントは SSE でストリーミングするため、長い待機後にテキストの塊が表示される場合は、プロキシや設定がバッファリングしている可能性があります。
- コンテキストの使用。 2〜3 ファイルを添付し、それらすべてが必要な質問をしてください。ウィンドウは 100,000 トークンで大量のソースコードを保持できますが、実際に送信する量はエディタが決定します。
- 指示のフォロー。差分のみ返信または厳密な出力形式を依頼し、モデルがそれに従うか確認してください。オープンウェイトモデルはここで異なります。初日からモデルの挙動を把握すべきです。
リポジトリから5 つの実際のタスクの短いリストを保持し、温度などの設定を変更するたびに再実行してください。独自のコードから判断することは、当社の主張を含む一般的な主張よりも優れています。
一般的なエラーの修正
401 または無効なキー
キーが間違っているか、クリップボードから貼り付けたキーが期限切れか、または周囲に空白があります。再度貼り付けてください。AuthorizationスキームがBearerであることを確認してください。OpenAIのキーフィールドを使用する場合、Cursorはこれを自動的に設定します。
404 またはモデルが見つからない
ほぼ常にベース URL の問題です。/v1 の欠落や余分な /chat/completions がパスを壊します。モデル名も uncensored で、大文字や空白を含めてはいけません。
レート制限または同時接続による 429
制限に達しました。試用キーは同時2リクエスト、分60リクエストまで、フルキーは同時8リクエスト、分300リクエストまでです。エディタはチャットとバックグラウンド編集など複数のリクエストを同時に送信でき、ストリーミングは終了までスロットを保持します。エラーコードはどの制限を示しているか:rate_limitedは1分あたりのリクエスト数、concurrencyは同時実行数です。一時的な過負荷でも429とRetry-After: 5が返るため、5秒待って再試行するのが正解です。
回答が途中で切れる
ウィンドウは100,000トークン(プロンプトと生成テキストの合計)です。非常に大きな添付ファイルは返信の余地を残しません。ファイル数を減らすか、新しいチャットを開始してください。
何もしない機能
API はテキストのみで、埋め込みは提供しません。Cursor の機能に埋め込みモデルや画像入力が必要な場合、このエンドポイントでは機能しません。
動作確認後に調整すべき設定
最初のチャットが成功した後、いくつかの調整で日常利用がスムーズになります。
編集タスクには温度を下げます。エディターが設定可能であれば、0.2前後の値がより安定したコード生成をもたらします。ブレインストーミングには上げてください。次に、コンテキストの量を注意深く見守ってください。ウィンドウは広大ですが、添付ファイルはすべて入力として課金されるため、関連のないタブを閉じ、ビルドフォルダーを除外することでコストを抑え、回答を集中させます。
エージェントやマルチステップモードを使用する場合、ツール呼び出しのサポートを覚えておいてください。エンドポイントは tools と tool_choice を受け入れ、tool_calls をストリーミングします。特定の Cursor 機能がこれらを使用するかどうかはバージョンに依存するため、大きな変更を信頼する前に小さなエージェントタスクを実行して結果を確認してください。最後に、ターミナルテストで X-Balance-USD ヘッダーを時々確認し、作業の途中で残高不足で驚かないようにしてください。
スクリプトでのキーの使用方法
OpenAI 互換エンドポイントの利点の一つは、Cursor で設定したキーがコードでも機能することです。ビルドスクリプトやコミットメッセージツールに便利な Node の例を以下に示します。
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.claudecodeapikey.com/v1",
apiKey: process.env.API_KEY,
});
const out = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
],
});
console.log(out.choices[0].message.content);
キーをコミットするファイルではなく環境変数に保存してください。各応答には X-Balance-USD ヘッダーが含まれるため、スクリプトはクレジットが少なくなった際に警告できます。
コストと変更すべきでないタイミング
エディタ利用は各リクエストにファイルコンテキストが含まれるため入力が重いです。1M入力トークンあたり$0.15、1M出力トークンあたり$0.50で、15,000入力トークンと1,000出力トークンのリクエストは0.015 x $0.15 + 0.001 x $0.50 = $0.00225 + $0.0005 = $0.00275かかります。100個なら$0.275です。料金ページにはチャージ額があり、$20から、$50以上でボーナスがあります。
特定のベンダーのモデルに依存した複雑なリファクタリングが必要な場合や、ワークフローが単純なチャットエンドポイントでは提供できない機能に依存している場合は、既存のセットアップを維持してください。トークンあたりの単価を抑え、シンプルなAPI、合合合法的な作業におけるコンテンツ拒否を減らしたい場合はこちらをご利用ください。多くの開発者は両方を設定し、タスクに応じて切り替えています。
その他のガイド
質問と回答
CursorにどのベースURLを入力すればよいですか?
https://api.claudecodeapikey.com/v1に/v1を含めて入力してください。末尾に/chat/completionsを追加しないでください。
どのモデル名を追加すればよいですか?
小文字のuncensoredというカスタムモデルを追加してください。これがAPIが提供する唯一のモデルIDです。
これによりCursorでClaudeモデルが利用可能になりますか?
いいえ。エンドポイントは独立したプロバイダーのオープンウェイトモデルを1つだけ提供します。Anthropicやその他のベンダーの公式APIではありません。
エディタで429エラーが発生するのはなぜですか?
1分あたりのレート制限を超えたか、一度に多すぎる同時リクエストを送信しています。トライアルキーは同時2、1分あたり60まで、フルキーは同時8、1分あたり300まで許可します。
支払いなしで試すことはできますか?
はい。新しいユーザーはAPIキーページで$0.50の試用クレジットを受け取れます。カードの登録は不要で、7日間有効です。
キーはフォーム 1 つで手に入ります
アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。