Cursor

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

前提条件

Cursor がインストール済み
ツール呼び出し対応モデルにアクセスできる ai& API キー

セットアップ

Cursor の設定を開く(Cmd+, / Ctrl+,)
Models → OpenAI API Key までスクロール
OpenAI API Key フィールドに ai& API キーを貼り付け
Override OpenAI Base URL を有効にして、以下を設定:
```
https://api.aiand.com/v1
```
/v1 サフィックスは必須です — Cursor は指定された URL に /chat/completions を追加します。
モデルリストで + Add Model をクリックし、カタログからツール呼び出し対応のモデル ID を入力。例:
```
zai-org/glm-5.2
```
モデルを有効にしてから Verify をクリック — Cursor がテストリクエストを送信し、キーとモデルが機能することを確認します

Agent モードの使用

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

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

接続の確認

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

macOS / Linux
Windows (PowerShell)

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

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

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

トラブルシューティング

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

Cursor ホスト型モデルに戻す

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

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