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

# MonkeyCode のセットアップ：インストール、API Key、Base URL、カスタムモデル

> MonkeyCode をインストールし、BetterToken の Base URL と API Key を設定して、対応プロバイダーのモデルを選び、よくあるエラーを解決します。

MonkeyCode を BetterToken に接続するには、API Key を用意し、以下の Base URL を入力して、モデル広場から現在の Model ID を選択します。

## 主要な設定

| 項目       | 値                                                                   |
| -------- | ------------------------------------------------------------------- |
| API Key  | BetterToken API Key                                                 |
| Base URL | `https://www.bettertoken.ai/v1`                                     |
| Model    | <a href={"https://bettertoken.ai/pricing"}>モデル広場</a>にある現在の Model ID |

## 前提条件

* 現在のバージョンのツールがインストールされている
* BetterToken API Key：<a href={"https://bettertoken.ai/register"}>登録して取得</a>
* <a href={"https://bettertoken.ai/pricing"}>モデル広場</a>の Model ID

### 追加要件

* MonkeyCode アカウント（[MonkeyCode で登録](https://monkeycode.ai)）

## インストール

MonkeyCode をインストールまたは開いてから、以下の手動設定を続けます。

## 手動設定

この設定は MonkeyCode の設定 UI で完了します。設定ファイルを編集する必要はありません。

| 項目       | 値                                                                   |
| -------- | ------------------------------------------------------------------- |
| API Key  | BetterToken API Key                                                 |
| Base URL | `https://www.bettertoken.ai/v1`                                     |
| Model    | <a href={"https://bettertoken.ai/pricing"}>モデル広場</a>にある現在の Model ID |

### 設定手順

<Steps>
  <Step title="MonkeyCode にログインする">
    [MonkeyCode](https://monkeycode.ai) にアクセスしてログインします。
  </Step>

  <Step title="システム設定を開く">
    タスクページに入り、右下の **Settings** をクリックします。
  </Step>

  <Step title="AI モデルをバインドする">
    **AI Model** セクションで **Bind** をクリックします。
  </Step>

  <Step title="BetterToken の設定を入力する">
    | 項目            | 値                                                                               |
    | ------------- | ------------------------------------------------------------------------------- |
    | Model API URL | `https://www.bettertoken.ai/v1`                                                 |
    | API Key       | BetterToken API Key                                                             |
    | API 形式        | `OpenAI` または `OpenAI Compatible`（現在の UI 表記に従います）                                |
    | モデル名          | <a href={"https://bettertoken.ai/pricing"}>モデル広場</a>からコピーした、**対応プロバイダーのモデル ID** |
  </Step>

  <Step title="公式ドキュメントで明示的に要求される場合にのみ追加ヘッダーを設定する">
    `User-Agent` を BetterToken で必須とする公式 MonkeyCode 設定要件は見つかりませんでした。このページに記載されている `Base URL`、API Key、モデル ID から始めてください。

    カスタムゲートウェイ、テナントルーティング、可観測性、キャッシュレイヤーも使用している場合は、その上流サービスの公式ドキュメントに従ってのみヘッダーを追加してください。
  </Step>

  <Step title="保存して使い始める">
    **Save** をクリックしてからメインページに戻り、設定したモデルを選択します。
  </Step>

  <Step title="MonkeyCode を再起動する">
    設定を保存した後、新しいモデルを使用する前にページを更新するか、MonkeyCode を開き直します。
  </Step>
</Steps>

<Note>
  追加ヘッダーが必要な場合は、`User-Agent` が BetterToken で必須だと想定せず、現在の MonkeyCode ドキュメントまたは上流ゲートウェイの要件に従ってください。
</Note>

## 接続を確認する

短いテストプロンプトを送信します。認証または Model ID のエラーなしでツールがレスポンスを返せば、接続は機能しています。設定を変更した後はツールを完全に再起動してください。

## モデルを切り替える

モデルセレクターを開くか、設定の `Model` フィールドを変更します。<a href={"https://bettertoken.ai/pricing"}>モデル広場</a>にある正確な Model ID を使用してから、現在のセッションを再起動してください。

## よくあるエラー

| エラー                      | 確認事項                                       |
| ------------------------ | ------------------------------------------ |
| `401` または `Unauthorized` | BetterToken API Key を確認し、先頭または末尾の空白を削除します。 |
| `404`                    | Base URL を確認し、特定の Endpoint パスを追加しないでください。  |
| `model not found`        | モデル広場から現在の Model ID をコピーします。               |
| 変更が反映されない                | 設定を保存して、ツールを完全に再起動します。                     |

* [OpenAI 互換 API と Anthropic 互換 API](/ja/faq/concepts/openai-compatible-vs-anthropic-compatible)
* [MCP と API Key / Base URL の違い](/ja/faq/concepts/mcp-vs-api-key-base-url)
* [model\_provider、base\_url、wire\_api とは何ですか？](/ja/faq/codex/model-provider-base-url-wire-api)
* [Cline で OpenAI 互換 API を設定する方法](/ja/faq/cline/openai-compatible-api)

## 詳細設定

## 対応プロバイダー

| プロバイダー | 対応状況 |
| ------ | ---- |
| Claude | 未対応  |
| GPT    | 手動設定 |
| Kimi   | 手動設定 |
| GLM    | 手動設定 |

<Note>ここに示す対応状況は、このページで説明する BetterToken の設定方法に適用されます。</Note>

<Accordion title="設定方法の説明">
  * **手動設定**：API Key、Base URL、Model を入力します。
  * **未対応**：検証済みの直接接続方法はまだありません。
</Accordion>

## 技術詳細

<Accordion title="プロトコル、Endpoint、内部プロバイダーフィールド">
  この設定では `https://www.bettertoken.ai/v1` を使用します。ツールが OpenAI 互換の Endpoint パスを追加します。特定のフィールドで明示的に要求されない限り、`/chat/completions` や `/responses` を追加しないでください。
</Accordion>