> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Cline で BeatAPI を使う

> VS Code の Cline 拡張機能で OpenAI Compatible 接続を設定し、BeatAPI を利用します。

# Cline で BeatAPI を使う

Cline は、エディター内からプロジェクトのコード作成、コマンド実行、ファイル編集を行う VS Code 拡張機能です。**OpenAI Compatible** 接続で BeatAPI を利用でき、3 つの項目を設定するだけで、追加のプラグインは不要です。

## 前提条件

1. **Visual Studio Code がインストールされていること。**
2. **Cline 拡張機能がインストールされていること。** 拡張機能マーケットプレイス（`Ctrl+Shift+X` / `Cmd+Shift+X`）で「Cline」を検索します。
3. **BeatAPI API キー。** [ダッシュボード → API キー](https://beatapi.io/dashboard/apikeys)で作成します。

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

初回インストール時はウェルカムパネルの **Use your own API key** を選択します。

設定済みの場合は、Cline サイドバー上部の歯車アイコンを押します。

## ステップ 2：BeatAPI を設定する

**API Configuration** を展開し、次を入力します。

| 設定           | 値                           |
| ------------ | --------------------------- |
| API Provider | `OpenAI Compatible`         |
| Base URL     | `https://api.beatapi.io/v1` |
| API Key      | BeatAPI API キー              |
| Model ID     | モデル ID。例 `claude-fable-5-1` |

**Done** を押します。設定は自動で保存され、再読み込みなしで即座に反映されます。

> **Note**
>
> **OpenAI** ではなく **OpenAI Compatible** を選択してください。一部の Cline では、OpenAI 接続で Base URL 欄が表示されず、独自の URL を指定できません。OpenAI Compatible では常に表示されます。

> **Note**
>
> Model ID は手入力のため、タイプミスは入力検証エラーではなく `not_found` として現れます。[料金ページ](https://beatapi.io/pricing)か `GET /v1/models` からコピーしてください。ID は大文字と小文字を区別し、ベンダーのプレフィックスは付けません。`anthropic/claude-fable-5-1` ではなく `claude-fable-5-1` を指定します。

タスクを始める前に、Cline の **Verify** ボタンで確認してください。

## ステップ 3：作業する

Cline パネル下部の入力欄に作業内容を入力します。

```
Create a JavaScript function that validates an email address, with unit tests
```

Cline は計画を立ててファイルを作成し、ターミナルのコマンドを実行する前に確認します。コードを選択して右クリックすると **Explain with Cline** と **Improve with Cline** を使えます。

入力欄の下のボタン、または設定の Model ID でモデルを切り替えます。変更は即座に反映されます。

## モデル

| モデル ID                      | 用途                          |
| --------------------------- | --------------------------- |
| `claude-fable-5-1`          | 最新世代。エージェントによるコーディングの標準選択   |
| `claude-opus-5`             | 複雑なアーキテクチャと難しいデバッグ          |
| `claude-sonnet-5`           | 日常的な開発を低コストで                |
| `gpt-5.6-sol`               | OpenAI シリーズの最も高性能なコーディングモデル |
| `claude-haiku-4-5-20251001` | 高速、低価格な処理や簡単な編集             |

アカウントのすべてのテキストモデルを利用できます。全モデルは [Text API](/text-api) を参照してください。

## よくある質問

### API キーが無効と表示されます

1. 余分な空白なしでキー全体をコピーしたか確認します。
2. Base URL が `/v1` を含み、末尾スラッシュのない `https://api.beatapi.io/v1` か確認します。
3. [ダッシュボード → API キー](https://beatapi.io/dashboard/apikeys)でキーが有効か確認します。

### 「Model Not Found」と表示されます

アカウントで有効な Model ID ではありません。[料金ページ](https://beatapi.io/pricing)とつづり、大文字と小文字を照合してください。

### 応答が遅いです

`claude-haiku-4-5-20251001` や `claude-sonnet-5` など、速いモデルに切り替え、作業範囲を絞ってください。Cline は開いているファイルと選択範囲をコンテキストとして送るため、選択を小さくすると速く、安くなります。

### 402 insufficient\_credits

残高が 0、またはリクエストの料金に不足しています。ダッシュボードからチャージしてください。

### 429 rate\_limit\_exceeded

キーのリクエスト数が上限を超えました。Cline は再試行しますが、失敗が続く場合は呼び出し頻度を下げるか、上限を増やしてください。毎分の上限はチャージ累計額に応じて増え、ダッシュボードに表示されます。

### コストを管理するには

* ファイル全体ではなく、作業が必要なコードだけを選択します。
* 通常の編集は安いモデルで行い、難しい問題では高性能モデルに切り替えます。
* [`GET /v1/usage`](/quick-guide) の `by_api_key`、またはダッシュボードでキー別の内訳を確認します。

## サポート

[ダッシュボード](https://beatapi.io/dashboard)からチケットを作成し、失敗したレスポンスの `request_id` を添えてください。