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

# CursorでElkAPIを使用する

> Cursor AIコードエディターで ElkAPI API サービスを設定および使用する方法の詳細ガイド。このガイドでは、CursorでElkAPI APIを設定し、コード開発用の豊富なAIモデルリソースにアクセスする方法を説明します。

## 準備

開始する前に、以下を確認してください：

1. **Cursorがインストールされている**\
   [Cursor公式サイト](https://cursor.sh/)からお使いのOSに適したバージョンをダウンロードしてインストールしてください

2. **ElkAPI APIキーを取得済み**\
   [ElkAPIコンソール](https://api.elkapi.com/keys)にログインしてAPIキー（`sk-`で始まる）を取得してください

<Note>
  **ヒント:** ElkAPIアカウントをお持ちでない場合は、まず[ElkAPI](https://api.elkapi.com)で登録してAPIキーを取得してください。
</Note>

## ステップ1：Cursor設定を開く

Cursorを起動後、設定ページに移動します：

1. 右上の\*\*⚙️ 設定\*\*アイコン（歯車アイコン）をクリック
2. またはキーボードショートカットを使用：
   * Windows/Linux: `Ctrl+Shift+J`
   * macOS: `Cmd+Shift+J`

## ステップ2：モデル設定を構成

### 2.1 モデル設定にアクセス

設定ページで：

1. 左側メニューの**Models**オプションを見つける
2. クリックしてモデル設定ページに入る

### 2.2 OpenAI API Keyを選択

モデル設定ページで：

1. **OpenAI API Key**設定エリアを見つける
2. **Add new**または**Override OpenAI Base URL**オプションをクリック

<Note>
  **重要：** CursorはOpenAI互換APIをサポートしているため、ElkAPIをカスタムAPIプロバイダーとして設定できます。
</Note>

### 2.3 ElkAPI API 情報を設定

以下の設定情報を入力：

| 設定項目         | 入力内容                                |
| ------------ | ----------------------------------- |
| **API Key**  | お客様のElkAPI APIキー（`sk-xxxxxxxxxxxx`） |
| **Base URL** | `https://api.elkapi.com/v1`         |

<Note>
  **重要：**

  * Base URLには`/v1`サフィックスを含める必要があります：`https://api.elkapi.com/v1`
  * API Keyは、ElkAPIコンソールから取得した`sk-`で始まるキーである必要があります
  * 設定後、CursorはElkAPIのモデルを使用してコード補完とチャットを行います
</Note>

## ステップ3：使用するモデルを選択

### 3.1 モデル選択

モデル設定で、使用するモデルを選択できます：

**利用可能なモデルタイプ：**

* **GPT-4/5 シリーズ** - 複雑なコード生成と問題解決に適しています
  * `gpt-5.5` - 最新のGPT-5モデル
  * `gpt-5.5` - GPT-5.5モデル
  * `gpt-5.4-mini` - より高速で経済的なバージョン

* **Claude シリーズ** - コード理解とリファクタリングに適しています
  * `claude-sonnet-4-6` - Claude Sonnet 4.6
  * `claude-sonnet-4-6` - Claude Opus 4.7

* **その他のモデル**
  * `gemini-3.1-flash-lite-preview` - Google Gemini 3.1 Flash Lite

<Tip>
  **推奨モデル：**

  * 💰 **コード補完（コスト効果的）：** `gpt-5.4-mini`
  * 🚀 **複雑なタスク（高性能）：** `gpt-5.5`、`gpt-5.5-pro`、`claude-sonnet-4-6`
  * ⚡ **高速レスポンス：** `gpt-5.4-mini`、`gemini-3.1-flash-lite-preview`
</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）を押してAIチャットパネルを開く
2. 質問や要求を入力します。例えば：
   * 「クイックソートアルゴリズムの実装方法は？」
   * 「このコードのパフォーマンスを最適化してください」
   * 「この関数の動作を説明してください」

### 4.2 コード補完

1. エディターで通常通りコードを書く
2. Cursorが自動的にコード補完の提案を提供します
3. `Tab`キーを押して提案を受け入れます

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

1. 編集したいコードを選択
2. `Cmd+K`（macOS）または`Ctrl+K`（Windows/Linux）を押す
3. 編集指示を入力します。例えば：
   * 「エラーハンドリングを追加」
   * 「この関数をリファクタリング」
   * 「型注釈を追加」

### 4.4 コード説明

1. 理解したいコードを選択
2. 右クリックして「Explain with AI」を選択またはショートカットを使用
3. AIがコードの機能とロジックを詳しく説明します

## よくある質問

### Q1：ElkAPIサービスに接続できない？

**解決策：**

1. **Base URLを確認**：
   * Base URLが`https://api.elkapi.com/v1`であることを確認（`/v1`サフィックスに注意）
   * 余分なパスを省略または追加しないでください

2. **API Keyを確認**：
   * API Keyが正しく、`sk-`で始まることを確認
   * [ElkAPIコンソール](https://api.elkapi.com/keys)でキーが有効か確認

3. **ネットワーク接続を確認**：
   * `https://api.elkapi.com`にアクセスできることを確認
   * 中国国内の場合、プロキシの設定が必要な場合があります

### Q2：AIの応答が遅い？

**解決策：**

1. **より高速なモデルに切り替え**：
   * `gpt-5.5`の代わりに`gpt-5.4-mini`を使用
   * `gemini-3.1-flash-lite-preview`を使用してより高速な応答を得る

2. **コンテキスト長を減らす**：
   * AIに送信するコードコンテキストを制限
   * より正確な質問記述を使用

3. **ネットワーク状況を確認**：
   * ネットワークレイテンシをテスト
   * プロキシを使用して接続を最適化することを検討

### Q3：API呼び出しが失敗またはエラーを返す？

**一般的なエラーと解決策：**

| エラーメッセージ                    | 原因                | 解決方法                        |
| --------------------------- | ----------------- | --------------------------- |
| `401 Unauthorized`          | API Keyが無効または期限切れ | API Keyを再取得して設定を更新          |
| `429 Too Many Requests`     | リクエストレート制限超過      | しばらく待ってから再試行、またはプランをアップグレード |
| `500 Internal Server Error` | 一時的なサーバー問題        | 数分待ってから再試行                  |
| `insufficient_quota`        | アカウント残高不足         | コンソールでチャージ                  |

### Q4：API使用状況と料金を確認するには？

[ElkAPIコンソール](https://api.elkapi.com)にログインして確認：

* 📊 API呼び出し統計
* 💰 料金詳細
* 📈 使用トレンドチャート
* 🔍 詳細なリクエストログ

## 使用のヒント

### 1. コンテキストを活用

Cursorは自動的に関連するコードコンテキストを含めます。できること：

* 関連ファイルを開いてAIにプロジェクト構造を理解させる
* `@filename`を使用して特定のファイルを参照
* `@folder`を使用してフォルダー全体を参照

### 2. 明確なプロンプトを書く

良いプロンプトはより良い結果をもたらします：

**❌ 悪いプロンプト：**

```
これを最適化
```

**✅ 良いプロンプト：**

```
この関数のパフォーマンスを最適化してください。重点：
1. ループのネストを減らす
2. より効率的なデータ構造を使用
3. キャッシングメカニズムを追加
```

### 3. 反復的な開発

AIと協力する際：

1. シンプルな要件から始める
2. 徐々に改善と最適化
3. 迅速にテストと検証
4. 結果に基づいてプロンプトを調整

### 4. プロジェクト基準を活用

`.cursorrules`ファイルを作成して定義：

* コードスタイルガイドライン
* 命名規則
* アーキテクチャパターン
* テスト要件

## 機能

Cursor + ElkAPIを使用すると、以下が可能です：

* 💬 **インテリジェントチャット** - いつでもプログラミングの質問をして、詳細な回答を得る
* ⚡ **コード補完** - リアルタイムのインテリジェントなコード提案と補完
* ✏️ **クイック編集** - 自然言語でコードを素早く変更
* 🔍 **コード理解** - 複雑なコードの動作を深く理解
* 🐛 **デバッグアシスタント** - コードのバグを見つけて修正するのを支援
* 📝 **ドキュメント生成** - コードコメントとドキュメントを自動生成
* 🔄 **コードリファクタリング** - インテリジェントにリファクタリングしてコード構造を最適化
* 🧪 **テスト生成** - 単体テストとテストケースを自動生成

## サポート＆ヘルプ

問題が発生した場合：

* 📚 [ElkAPIドキュメント](https://docs.elkapi.com)
* 📧 テクニカルサポート：[support@elkapi.com](mailto:support@elkapi.com)

***

<Card title="ElkAPIを今すぐ使い始める" icon="rocket" href="https://api.elkapi.com">
  今すぐElkAPIに登録して、APIキーを取得し、プログラミング効率を向上させましょう！
</Card>