# Cursor

Source: https://docs.aiand.com/ja/integrations/cursor/

[Cursor](https://cursor.com) は OpenAI ベース URL を独自の API キーで上書きする機能(BYOK: Bring Your Own Key)をサポートしています。ai& は OpenAI 互換の `/v1/chat/completions` エンドポイントを公開しているため、[カタログ](/ja/models/catalog/) 内の `tool_calling` 対応モデルで Cursor の Agent モードを駆動できます。

<Aside type="caution">
  上書きが有効な間、**すべての** リクエスト — 組み込みピッカーで選択した Cursor ホスト型モデルも含む — が指定したエンドポイントにルーティングされます。エンドポイントがそのモデル ID を提供していない限り、Cursor ホスト型モデルは「model not available」で失敗します。Cursor のモデルに戻すには、上書きをオフにしてください。
</Aside>

## 前提条件

- [Cursor](https://cursor.com) がインストール済み
- ツール呼び出し対応モデルにアクセスできる [ai& API キー](https://console.aiand.com/settings/api-keys)

## セットアップ

<Steps>

1. Cursor の設定を開く(`Cmd+,` / `Ctrl+,`)

2. **Models** → **OpenAI API Key** までスクロール

3. **OpenAI API Key** フィールドに ai& API キーを貼り付け

4. **Override OpenAI Base URL** を有効にして、以下を設定:
   ```
   https://api.aiand.com/v1
   ```
   `/v1` サフィックスは必須です — Cursor は指定された URL に `/chat/completions` を追加します。

5. モデルリストで **+ Add Model** をクリックし、[カタログ](/ja/models/catalog/) からツール呼び出し対応のモデル ID を入力。例:
   ```
   zai-org/glm-5.2
   ```
   モデルを有効にしてから **Verify** をクリック — Cursor がテストリクエストを送信し、キーとモデルが機能することを確認します

</Steps>

<Aside type="tip">
  `zai-org/glm-5.2`、`moonshotai/kimi-k3`、`deepseek-ai/deepseek-v4-pro` は優れたツール呼び出し性能を持ち、Agent モードに適しています。[カタログ](/ja/models/catalog/) 内で `tool_calling` 対応のモデルであれば利用できます。
</Aside>

## Agent モードの使用

認証が完了したら、Agent モードに切り替えます(サイドバーのロボットアイコン、または `Cmd+.` / `Ctrl+.`)。エージェントは以下を実行できます:

- ワークスペース内のファイルの読み取りと編集
- ターミナルコマンドの実行
- マルチターンのツール呼び出しでタスクを完了

## 接続の確認

シェルからキーが認証され、モデルが利用可能か確認します:

<Tabs syncKey="os">
<TabItem label="macOS / Linux">

```bash
curl -sS https://api.aiand.com/v1/models \
  -H "Authorization: Bearer $AIAND_API_KEY" \
  | grep -o 'zai-org/glm-5.2'
```

</TabItem>
<TabItem label="Windows (PowerShell)">

```powershell
(Invoke-RestMethod https://api.aiand.com/v1/models `
  -Headers @{ Authorization = "Bearer $env:AIAND_API_KEY" }).data.id `
  | Select-String "zai-org/glm-5.2"
```

</TabItem>
</Tabs>

一致すればキーが機能し、そのモデルが組織で利用可能であることを意味します。

## トラブルシューティング

- **「Invalid API key」** — ai& ダッシュボードから完全なキーをコピーしたか、キーが取り消されていないか確認してください。
- **「Model not found」** — モデル ID は [カタログ](/ja/models/catalog/) と完全一致する必要があります。プロバイダープレフィックス(`zai-org/`、`moonshotai/` など)も含めてください。
- **Agent モードがツールを使わない** — 選択したモデルがツール呼び出しに対応しているか確認してください。カタログのすべてのモデルが対応しているわけではありません。
- **キーとモデルが正しいのに Verify が失敗する** — Cursor が検証リクエストを `model: "default"` で送信することがあります。回避策: まずリスト内の他のモデルをすべて無効にしてから検証してください。
- **リクエストがブロックされる、または 403** — 企業プロキシや VPN が干渉している可能性があります。まず直接接続で試してください。

## Cursor ホスト型モデルに戻す

1. 設定 → Models に移動
2. **Override OpenAI Base URL** を無効化(またはフィールドをクリア)
3. Cursor ホスト型モデル(GPT-4o、Claude など)が再び利用可能になります

BYOK キーは Cursor によってローカルに保存され、上書き先のエンドポイント以外には送信されません。