> ## 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.

# BetterToken で Claude モデルを Claude Desktop に接続する

> Base URL と API Key を使って、Claude Desktop Gateway で BetterToken の Claude プロバイダーを設定します。

このページでは、BetterToken の **Claude プロバイダー**向け Claude Desktop 直接設定のみを説明します。BetterToken API Key、`https://www.bettertoken.ai`、`x-api-key` を入力してから Claude Desktop を再起動してください。

## 主要設定

| 項目       | 値                            |
| -------- | ---------------------------- |
| API Key  | BetterToken API Key          |
| Base URL | `https://www.bettertoken.ai` |
| Model    | Claude プロバイダーのモデル            |

## 事前準備

* <a href={"https://bettertoken.ai/register"}>BetterToken API Key を作成してコピー</a>
* API Key で Claude プロバイダーのモデルを利用できることを確認

## インストール

[Claude Desktop のサイト](https://claude.ai/download)から最新バージョンをインストールまたは更新し、Claude Desktop を起動します。

## 手動設定

<Steps>
  <Step title="開発者モードを有効にする">
    Claude Desktop の macOS メニューバーで **Help** → **Troubleshooting** → **Enable Developer Mode** を選択します。

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/claude-desktop-llmeasy-api/enable-developer-mode-menu.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=88d5591c4fc6690a13b846df03f84991" alt="Claude Desktop の Help メニューから Enable Developer Mode を選択します。" style={{ borderRadius: '0.5rem' }} width="3840" height="2160" data-path="images/claude-desktop-llmeasy-api/enable-developer-mode-menu.png" />
    </Frame>

    確認ウィンドウで **Enable** をクリックし、Claude Desktop を再起動します。

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/developer-mode-confirm.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=ec60755e271216c1383bd7ec466c58db" alt="Claude Desktop で開発者モードを確認します。" style={{ borderRadius: '0.5rem' }} width="520" height="480" data-path="images/claude-desktop-llmeasy-api/developer-mode-confirm.png" />
    </Frame>
  </Step>

  <Step title="サードパーティ推論設定を開く">
    再起動後、macOS メニューバーで **Developer** → **Configure Third-Party Inference...** を選択します。

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/claude-desktop-llmeasy-api/configure-third-party-inference.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=f4412369928fe11c78433578e0efa60a" alt="Developer メニューから Configure Third-Party Inference を選択します。" style={{ borderRadius: '0.5rem' }} width="3840" height="2160" data-path="images/claude-desktop-llmeasy-api/configure-third-party-inference.png" />
    </Frame>
  </Step>

  <Step title="BetterToken API 設定を入力する">
    **Gateway** を選択して、次を入力します。

    | 項目                      | 値                            |
    | ----------------------- | ---------------------------- |
    | **Gateway base URL**    | `https://www.bettertoken.ai` |
    | **Gateway API key**     | あなたの BetterToken API Key     |
    | **Gateway auth scheme** | `x-api-key`                  |

    認証方式を選択すると、Claude Desktop が利用可能な Claude モデルを取得します。**Apply locally** をクリックしてください。

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/claude-desktop-llmeasy-api/gateway-credentials.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=14951973725bde190ce650415e7b67f8" alt="Claude Desktop に BetterToken Gateway の Base URL、API Key、認証方式を入力します。" style={{ borderRadius: '0.5rem' }} width="1800" height="1440" data-path="images/claude-desktop-llmeasy-api/gateway-credentials.png" />
    </Frame>
  </Step>
</Steps>

## 接続を確認する

**Save & Restart** をクリックします。**Continue with Gateway** を選択して短いメッセージを送信してください。左下に **Gateway** が表示され、通常どおりメッセージが返れば設定は有効です。

<Frame>
  <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/gateway-ready.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=292b7db7ffddbcb11be3312dda097997" alt="Claude Desktop が BetterToken Gateway 経由で開かれ、使用できる状態です。" style={{ borderRadius: '0.5rem' }} width="3840" height="2100" data-path="images/claude-desktop-llmeasy-api/gateway-ready.png" />
</Frame>

## モデルを切り替える

モデルセレクターを開き、Gateway が返した別の Claude モデルを選択します。モデルが表示されない場合は、**Configure Third-Party Inference...** を開き直し、**Apply locally** をクリックして Claude Desktop を再起動します。

## よくあるエラー

| 問題                | 対処方法                                                                          |
| ----------------- | ----------------------------------------------------------------------------- |
| Gateway に接続できない   | **Gateway base URL** には正確に `https://www.bettertoken.ai` を使用します。`/v1` は追加しません。 |
| リクエストが `401` を返す  | BetterToken API Key をもう一度コピーし、認証方式が `x-api-key` であることを確認します。                  |
| Claude モデルが表示されない | API Key で Claude プロバイダーのモデルを利用できることを確認し、設定ウィンドウを開き直します。                       |
| 設定が適用されない         | Claude Desktop を完全に終了して開き直し、**Continue with Gateway** を選択します。                 |

## 高度な設定

Claude Desktop で GPT、Kimi、GLM、または他の Claude 以外のプロバイダーを使うには、[CC Switch の Claude Desktop タブ](/ja/ai-tools/cc-switch#claude-desktop)を参照してください。CC Switch が API Format、モデルマッピング、プロキシ、再起動の手順を処理します。

### 対応プロバイダー

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

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

<Accordion title="設定方法の説明">
  * **高度な設定**：CC Switch をインストールし、ローカルプロキシ、プロトコル変換、またはモデルマッピングを使用します。
  * **手動設定**：API Key、Base URL、Model を入力します。
</Accordion>

### 関連ガイド

* [Claude Desktop で外部モデルを使う](/ja/faq/claude-desktop/third-party-models)
* [CC Switch で BetterToken を設定する](/ja/ai-tools/cc-switch)
* [Codex CLI でカスタムプロバイダーを設定する](/ja/ai-tools/codex)
* [最新の CC Switch リリースをダウンロードする](https://github.com/farion1231/cc-switch/releases)

## 技術詳細

<Accordion title="Gateway のエンドポイントと認証">
  Anthropic 互換の `https://www.bettertoken.ai` を `/v1` なしで **Gateway base URL** として使用します。認証方式には `x-api-key` を選択します。
</Accordion>