# Cursor

Cursor のチャットとエージェントは、自分の OpenAI 互換サービスで動かせます。キーとベース URL を入力し、モデル名を手動で追加します。

> https://nezhagate.com/ja/docs/integrations/cursor

対象バージョン：Cursor 3.22

## 始める前に

- Cursor の有料プラン（Pro 以上）。無料プランでは、自分のキーでチャットやエージェントを動かせません。

- チームプランでは、管理者が個人の API キーの利用を許可している必要があります。

- Cursor は自社のサーバーからリクエストを送るため、NezhaGate の公開アドレスをそのまま使えます。

## セットアップ

1. **Cursor Settings**（`Ctrl/Cmd + Shift + J`） → **Models** を開き、下までスクロールして **API Keys** を展開します。

2. **OpenAI API Key** に NezhaGate のキーを貼り付け、**Use OpenAI API Key** をオンにします（別々の 2 つの操作で、どちらも必要です）。

3. **Override OpenAI Base URL** をオンにして、`https://nezhagate.com/v1` を入力します。

4. モデル検索ボックスに正確なモデル名を入力し（例えば下のリストにあるもの）、**Add Custom Model** をクリックします。

5. Cursor を再起動し、新しいチャットを開いて、追加したモデルを選びます。

Base URL`https://nezhagate.com/v1`

## 追加できるモデル

Cursor に追加できる、NezhaGate で販売中の対話モデル：

`gpt-5.6-sol` · `gpt-5.6-terra` · `gpt-5.6-luna` · `gpt-6-astra` · `gpt-6.1-sol` · `gpt-6-sol` · `gpt-6-luna` · `deepseek-v4.1-flash` · `deepseek-v4-flash-0731` · `glm-5.3` · `glm-5.3-flash` · `kimi-k3` · `qwen3.7-max` · `qwen3.8-max` · `qwen3.8-max-0902` · `qwen3.8-flash` · `doubao-seed-2-1-pro` · `doubao-seed-2-1-turbo` · `grok-4.7`

- 名前が `claude-` で始まるモデルは、Cursor がその Anthropic 用のキーを使って送るようになっており、そちらの欄にはベース URL の上書きがないため、NezhaGate の Claude モデルは Cursor では使えません。`gemini-` で始まる名前も、カスタムアドレスを必ず使うとは限らないため、上のリストには入れていません。Claude には [Claude Code](https://nezhagate.com/ja/docs/integrations/claude-code) をお使いください。

- Cursor 自身のモデルと同じ名前（例えば `gpt-5.5`）は追加できません。別のモデルを選んでください。

- 画像を送るには、画像入力に対応したモデルを選んでください（各モデルの API ドキュメントをご確認ください）。

## 知っておきたい制限

- Tab 補完では自分のキーは使われません。NezhaGate を経由するのはチャットとエージェントだけです。

- この設定は OpenAI 系のすべてのモデルに影響します。オンになっている間は、Cursor 自身のモデルの一部が、カスタムキーに対応していないと表示されることがあります。それらをまた使うには、**Use OpenAI API Key** をオフにしてください。

- Cursor にはカスタムキーを検証するボタンがなく、保存後はキー入力欄にキーの内容が表示されません。メッセージを送ってみるのが一番確実なテストです。

## テスト

新しいチャットを開いて追加したモデルを選び、Reply with exactly: ok と送ってみてください。回答が返ってきたら、コンソールのコールログにこのリクエストが表示されます。

## よくあるエラー

**Model name is not valid / AI Model Not Found**

**Use OpenAI API Key** がオフになっている（キーが送られていない）か、モデル名が `claude-` で始まっています。

**This model does not support custom API keys**

Cursor 自身のモデルが選ばれています。追加したモデルを選ぶか、**Use OpenAI API Key** をオフにして Cursor 自身のモデルを使ってください。

**Invalid API key / Unauthorized User API key**

キーが正しくありません。キー全体をもう一度貼り付けてください（入力欄には元の値は表示されないので、そのまま上書きすれば大丈夫です）。

**Planning next moves のまま進まず、最終的にレート制限か利用不可のエラーになる**

多くは無料プランでカスタムキーが使えないか、ベース URL が間違っています。プランと、アドレスが `https://nezhagate.com/v1` になっているかを確認してください。