> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor で APIMart を使う

> Cursor AI エディタで APIMart API を構成・利用する手順をまとめました。豊富な AI モデルをコード開発に活用できます。

## 事前準備

開始する前に、次を確認してください。

1. **Cursor をインストール済みであること**\
   [Cursor 公式サイト](https://cursor.sh/) から OS 向けインストーラーを取得し、インストールします

2. **APIMart API キーを取得済みであること**\
   [APIMart コンソール](https://apimart.ai/keys) で API キー（`sk-` 始まり）を取得します

<Note>**ヒント:** アカウントがない場合は [APIMart](https://apimart.ai) で登録し、API キーを発行してください。</Note>

## ステップ 1: 設定を開く

Cursor を起動したら、設定へ進みます。

1. 右上の **⚙️ 設定**（ギア）をクリック
2. またはショートカット: Windows/Linux `Ctrl+Shift+J`、macOS `Cmd+Shift+J`

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/main-interface.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=0cdb42d41c54585a4fdb57605722a617" alt="Cursor メイン画面" width="1200" height="800" data-path="images/integrations/cursor/main-interface.png" />
</Frame>

<caption>*メイン画面右上のギアから設定へ*</caption>

## ステップ 2: モデル設定

### 2.1 モデル画面へ

設定で次を行います。

1. 左メニューの **Models** を開く
2. モデル設定ページへ移動

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/settings-models.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=58aa677bafc3c5baf2f1cecbadc2f6c7" alt="Cursor 設定 Models" width="1200" height="800" data-path="images/integrations/cursor/settings-models.png" />
</Frame>

<caption>*左メニューから Models を選択*</caption>

### 2.2 OpenAI API Key を使う

モデル設定ページで:

1. **OpenAI API Key** セクションを探す
2. **Add new** または **Override OpenAI Base URL** を選択

<Note>**重要:** Cursor は OpenAI 互換 API に対応しているため、APIMart をカスタムプロバイダーとして設定できます。</Note>

### 2.3 APIMart を入力する

次のとおり入力します。

| 項目           | 入力内容                                |
| ------------ | ----------------------------------- |
| **API Key**  | APIMart の API キー（`sk-xxxxxxxxxxxx`） |
| **Base URL** | `https://api.apimart.ai/v1`         |

<Note>
  **重要:** - Base URL は必ず `/v1` を含める: `https://api.apimart.ai/v1` - キーはコンソールで発行した `sk-` で始まるものを使う - 保存後、補完とチャットで APIMart のモデルが利用されます
</Note>

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/api-config.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=96fdcd9f4cb5894281096afacc3e8157" alt="APIMart API 設定" width="1200" height="800" data-path="images/integrations/cursor/api-config.png" />
</Frame>

<caption>*API Key と Base URL を入力*</caption>

## ステップ 3: モデルを選ぶ

### 3.1 モデル選択

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/api-model.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=162421d76a09a5831298a9cc6194fed4" alt="モデル選択" width="1200" height="800" data-path="images/integrations/cursor/api-model.png" />
</Frame>

モデル設定で利用モデルを選べます。

**利用可能な系統:**

* **GPT-4/5 系** — 複雑な生成・質問向け
  * `gpt-5` — 最新の GPT-5
  * `gpt-4o` — GPT-4o
  * `gpt-4o-mini` — 高速・低コスト
* **Claude 系** — 読解・リファクタ向け
  * `claude-sonnet-4-5-20250929` — Sonnet 4.5
  * `claude-haiku-4-5-20251001` — Haiku 4.5
* **その他**
  * `gemini-2.0-flash-exp` — Google Gemini 2.0 Flash

<Tip>
  **おすすめ:** - 💰 **補完のコスパ:** `gpt-4o-mini` - 🚀 **重いタスク:** `gpt-5`、`gpt-4o`、`claude-sonnet-4-5-20250929` - ⚡ **応答速度:** `gpt-4o-mini`、`gemini-2.0-flash-exp`
</Tip>

### 3.2 機能ごとのモデル

Cursor では機能ごとに別モデルを選べます。

* **Chat** — AI との対話
* **Autocomplete** — コード補完
* **Cmd+K** — クイック編集・生成

用途ごとに最適なモデルを設定してください。

## ステップ 4: 利用開始

構成ができたら、Cursor の AI 機能を使い始められます。

### 4.1 AI チャット (`Cmd+L` / `Ctrl+L`)

1. `Cmd+L`（macOS）または `Ctrl+L`（Windows/Linux）でチャットを開く
2. 例:
   * 「クイックソートはどう実装する？」
   * 「このコードのパフォーマンスを最適化して」
   * 「この関数の動きを説明して」

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/ai-chat.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=916680a9a52cc82daa87ba904e64944b" alt="AI チャット" width="1200" height="800" data-path="images/integrations/cursor/ai-chat.png" />
</Frame>

<caption>*チャットで質問*</caption>

### 4.2 コード補完

1. 通常どおりコードを書く
2. 補完提案が表示される
3. `Tab` で採用

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/autocomplete.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=34992c1174e6019df9d21ea5b71bf1b6" alt="補完" width="1925" height="1025" data-path="images/integrations/cursor/autocomplete.png" />
</Frame>

<caption>*インライン補完の例*</caption>

### 4.3 クイック編集 (`Cmd+K` / `Ctrl+K`)

1. 編集したいコードを選択
2. `Cmd+K` / `Ctrl+K`
3. 例:
   * 「エラー処理を追加」
   * 「この関数をリファクタ」
   * 「型注釈を追加」

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/quick-edit.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=eab6aa4afabc8f28ff3cd246bb2ebea7" alt="クイック編集" width="1920" height="1031" data-path="images/integrations/cursor/quick-edit.png" />
</Frame>

<caption>*Cmd+K で編集*</caption>

### 4.4 コード説明

1. 知りたいコードを選択
2. 右クリックから **Explain with AI**、またはショートカット
3. AI が機能とロジックを説明します

## よくある質問

### Q1: APIMart に繋がらない

**対処:**

1. **Base URL**
   * `https://api.apimart.ai/v1` であること（`/v1` を含む）
   * 余計なパスを付けない

2. **API キー**
   * `sk-` で始まり、コピペミスがないこと
   * [コンソール](https://apimart.ai/keys) で有効か確認

3. **ネットワーク**
   * `https://api.apimart.ai` に到達できること
   * 制限がある環境ではプロキシが必要な場合があります

### Q2: 応答が遅い

**対処:**

1. **より軽いモデルへ**
   * `gpt-4o` の代わりに `gpt-4o-mini`
   * 速さ重視なら `gemini-2.0-flash-exp`

2. **コンテキストを絞る**
   * 送るコード量を抑える
   * 質問を具体的にする

3. **回線・遅延**
   * レイテンシを確認
   * プロキシで経路を最適化

### Q3: API エラー

| メッセージ                       | 想定原因      | 対処           |
| --------------------------- | --------- | ------------ |
| `401 Unauthorized`          | キー不正・期限切れ | キーを再発行し設定を更新 |
| `429 Too Many Requests`     | レート制限     | しばらく待って再試行   |
| `500 Internal Server Error` | 一時障害      | 数分後に再試行      |
| `insufficient_quota`        | 残高不足      | コンソールでチャージ   |

### Q4: 利用量・課金は？

[APIMart コンソール](https://apimart.ai/overview) で確認:

* 📊 呼び出し統計
* 💰 コスト内訳
* 📈 利用トレンド
* 🔍 リクエストログ

## 使い方のコツ

### 1. コンテキストを活かす

Cursor は関連コードを取り込みます。次も有効です。

* 構造把握のため関連ファイルを開く
* `@filename` で特定ファイルを参照
* `@folder` でフォルダ全体を参照

### 2. プロンプトを明確に

**❌ 弱い例:**

```
これを最適化して
```

**✅ 強い例:**

```
この関数のパフォーマンスを最適化して。特に:
1. ループのネストを減らす
2. より効率的なデータ構造を使う
3. キャッシュを入れる
```

### 3. 反復で進める

1. 小さな依頼から始める
2. 段階的に改善
3. こまめにテスト・検証
4. 結果に合わせてプロンプトを調整

### 4. `.cursorrules`

次を定義すると一貫しやすくなります。

* コードスタイル
* 命名規則
* アーキテクチャ
* テスト方針

## 機能

Cursor + APIMart で次が可能です。

* 💬 **対話** — いつでも質問し、詳しい回答を得られる
* ⚡ **補完** — リアルタイムな提案
* ✏️ **クイック編集** — 自然言語でコードを変更
* 🔍 **理解** — 複雑なコードの動きを把握
* 🐛 **デバッグ支援** — 不具合の発見・修正の手がかり
* 📝 **ドキュメント** — コメントや説明の下書き
* 🔄 **リファクタ** — 構造の見直しを支援
* 🧪 **テスト** — 単体テストなどのひな型生成

## サポート

お困りのときは:

* 📚 [APIMart ドキュメント](https://docs.apimart.ai)
* 💬 [Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="APIMart をはじめる" icon="rocket" href="https://apimart.ai">
  登録して API キーを取得し、Cursor で開発効率を上げましょう。
</Card>