Coding Agent のセットアップ

Claude Desktop の BetterToken 接続

Gateway 接続先、BetterToken API Key、Claude モデルを使って Claude Desktop を設定します。認証、モデル選択、再起動の手順を確認できます。

Claude Desktop で使用できるのは Claude モデルのみです。これは Claude Desktop クライアントの制限です。

モデル広場から利用可能な Claude Model ID をコピーし、保存して Claude Desktop を再起動します。

主要設定

項目	値
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai`
Model	Claude

事前準備

BetterToken API Key を作成してコピー
モデル広場から正確な Model ID をコピーしてください。

サブスクリプションと API 課金を分ける

Gateway リクエストは BetterToken API Key と BetterToken 残高を使用します。Claude サブスクリプションの利用枠を消費したり延長したりするものではありません。サブスクリプションと API は別のアクセス・課金経路として扱ってください。

実際の作業に使う前に、次を確認します。

Claude Desktop 専用の BetterToken API Key を作成します。
Gateway から機密情報を含まない短いテストメッセージを送信します。
BetterToken Dashboard を開き、モデル、ステータス、input、output、cache Token、請求額を確認します。
Key がスクリーンショット、リポジトリ、公開ログに含まれた場合は、失効させて新しい Key を作成します。

インストール

Claude Desktop のサイトから最新バージョンをインストールまたは更新し、Claude Desktop を起動します。

手動設定

開発者モードを有効にする

Claude Desktop の macOS メニューバーで Help → Troubleshooting → Enable Developer Mode を選択します。

Claude Desktop の Help メニューから Enable Developer Mode を選択します。

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

サードパーティ推論設定を開く

再起動後、macOS メニューバーで Developer → Configure Third-Party Inference… を選択します。

Developer メニューから Configure Third-Party Inference を選択します。

BetterToken API 設定を入力する

Gateway を選択して、次を入力します。

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

認証方式を選択すると、Claude Desktop が利用可能な Claude モデルを取得します。Apply Changes をクリックすると、このデバイスに設定を保存して Claude Desktop を再起動します。古いバージョンでは Apply locally、続いて Save & Restart が表示される場合があります。

Claude Desktop に BetterToken Gateway の Base URL、API Key、認証方式を入力します。

接続を確認する

Claude Desktop の再起動後、Continue with Gateway を選択して短いメッセージを送信します。左下に Gateway が表示され、通常どおり応答が返れば設定は有効です。

Claude Desktop が BetterToken Gateway 経由で開かれ、使用できる状態です。

モデルを切り替える

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

よくあるエラー

問題	対処方法
Gateway に接続できない	Gateway base URL には正確に `https://bettertoken.ai` を使用します。`/v1` は追加しません。
リクエストが `401` を返す	BetterToken API Key をもう一度コピーし、認証方式が `x-api-key` であることを確認します。
Claude モデルが表示されない	モデル広場から利用可能な Claude Model ID をコピーし、保存して Claude Desktop を再起動します。
設定が適用されない	Claude Desktop を完全に終了して開き直し、Continue with Gateway を選択します。