AI コーディング

ロシアでClaude Desktopを使う：推論ゲートウェイの設定

Claude DesktopをAnthropic互換ゲートウェイに直接接続するか、CC Switchのローカル経路に接続し、Dashboardでリクエストを検証します。

BT

BetterToken

編集チーム
2 分で読めます

Claude Desktopは、開発者モードからサードパーティーの推論ゲートウェイに接続できます。ClaudeキーグループはAnthropic互換endpointに直接接続できますが、OpenAI互換グループではCC Switch経由のローカル経路が必要です。以下のmacOS向け手順は、API Keyグループの選択からDashboardでのリクエスト確認までを扱います。

自分のAPI Keyを適切な経路で接続し、すぐに確認してください。 BetterTokenはOpenAI-compatibleとAnthropic-compatibleのインターフェースを分けて提供しているため、モデル名だけでアドレスを選ぶことはできません。Claude Desktop用BetterToken最新ガイドを開き、API Keyのグループを確認して、該当する手順に進んでください。

Claude Desktopにおけるサードパーティー推論とは

通常、Claude DesktopはAnthropicアカウントとAnthropicのサービスを使用します。サードパーティー推論では、モデルへのリクエスト経路が変わり、アプリケーションは設定済みゲートウェイへ送信します。これによって第三者のAPIがClaudeサブスクリプションになるわけではなく、インストール、アップデート、機能利用可否に関するアプリ側の要件もなくなりません。

推論ゲートウェイをDesktop ExtensionsやMCPと混同しないでください。ExtensionsはClaudeにローカルアプリケーションやデータへのアクセスを与えます。ゲートウェイはモデルへのリクエストをルーティングします。一つの層の障害だけで、別の層まで壊れているとは判断できません。

Anthropicの現行ドキュメントでは、Claude DesktopはmacOS、Windows、Linux betaで利用可能とされています。以下のHelp → TroubleshootingおよびDeveloper → Configure Third-Party Inference…は、macOS向けBetterToken最新ガイドで確認されているメニューです。別のOSでは、インストール済みのアプリ版に同じ設定があることを先に確認してください。

API Keyグループごとに経路を選ぶ

  • Claudeグループ： Anthropic-compatibleの直接ゲートウェイ。Gateway base URLはhttps://www.bettertoken.ai、認証方式はx-api-keyです。
  • Codexグループ： BetterToken → CC Switch → ローカルClaude経路。Gateway base URLはCC SwitchのService address、認証方式はbearerです。

Codexグループでは、https://www.bettertoken.ai/v1をClaude DesktopのGatewayに直接入力しないでください。これはOpenAI-compatibleのBase URLであり、Gatewayフィールドが期待するのはAnthropic互換の経路です。CC SwitchはOpenAI Responses APIを受け、モデルをマッピングして、Claude Desktop用のローカルサービスアドレスを公開します。

Claudeグループを直接設定する

1. 最新のClaude Desktopをインストールする

Claude公式ページからアプリをダウンロードします。Anthropicの通常インストールではサインインが求められます。BetterToken Gatewayの手順は通常サインインの前に始まるため、二つのモードを混ぜないようゲートウェイガイドの順序に従ってください。

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

macOSで次を開きます。

Help → Troubleshooting → Enable Developer Mode

Enableをクリックし、Claude Desktopを完全に終了します。再起動後にDeveloperメニューが表示されるはずです。

3. ゲートウェイ設定を開く

次へ進みます。

Developer → Configure Third-Party Inference…

Gatewayを選択し、以下を入力します。

Gateway base URL: https://www.bettertoken.ai
Gateway API key: Token managementの自分のAPI Key
Gateway auth scheme: x-api-key

キーを記事、スクリーンショット、公開ログ、リポジトリに記載しないでください。x-api-keyを選択すると、アプリケーションはClaudeグループで利用可能なモデルを取得するはずです。

4. 設定を適用して再起動する

Apply locallyをクリックし、続いてRelaunch nowをクリックします。起動後、Continue with Gatewayを選びます。左下のCowork 3P | Gateway表示が経路の有効化を示します。

Codexグループ用のローカル経路

この経路はより長くなります。Claude DesktopはローカルのCC Switchアドレスに接続し、CC SwitchがリクエストをBetterToken OpenAI Responses APIへ送ります。

1. CC SwitchにBetterTokenをproviderとして追加する

Claude Codeを開き、Add Providerをクリックして入力します。

Provider Name: BetterToken
Base URL: https://www.bettertoken.ai
API Key: 自分のBetterToken API Key

Advanced OptionsでOpenAI Responses APIを選びます。続けてFetch Model Listをクリックし、利用可能なmappingフィールドにモデルを明示的に割り当てます。Codexグループ内の現在のIDだけを使用し、古い記事や他人のスクリーンショットからモデルをコピーしないでください。

2. ローカル経路を有効にする

providerを保存してIn useに設定し、proxyを有効にします。Settings → RoutingでマスタースイッチとClaude routeを確認します。表示されたService addressをコピーしてください。これがClaude Desktopに必要なローカルアドレスです。

3. Claude DesktopのGatewayフィールドを入力する

Developer → Configure Third-Party Inference…に戻り、Gatewayを選択して入力します。

Gateway base URL: CC SwitchのService address
Gateway API key: 自分のBetterToken API Key
Gateway auth scheme: bearer

Model listに、CC Switchで設定した現在のModel IDとDisplay nameを追加します。Apply locallyをクリックし、Relaunch nowを承認してContinue with Gatewayを選びます。

リクエストとDashboard記録を確認する

作業ディレクトリへのアクセスや長いタスクから始めないでください。個人情報を含まない短いリクエスト、たとえばJSON配列とオブジェクトの違いを尋ねる質問を送ってから、BetterToken Dashboardを開きます。

成功した確認には二つのシグナルがあります。

  1. Claude Desktopが応答と有効なCowork 3P | Gatewayモードを表示する。
  2. Dashboardに時刻、モデル、status、input/output/cache tokens、請求額を含む対応記録が表示される。

応答はあるのに記録がない場合、アプリが別のモードではなく実際にGatewayを使っていることを確認してください。エラーステータスの記録が表示された場合、経路はAPI層に到達しています。Keyグループ、認証方式、モデル、残高を確認します。Dashboardを完全なpromptや応答の保管場所にしないでください。サポートへ連絡する前に、ログからキーとリクエスト内容を削除してください。

Claude Desktopが接続しない場合の確認事項

  • Developerメニューがない： 開発者モードを再度有効にし、ウィンドウを閉じるだけでなくClaude Desktopを完全に終了します。
  • Your provider setup needs a fix： Model list、現在のID、CC Switch内の必須mappingをすべて確認します。
  • 401または403： Claudeグループにはx-api-key、Codexグループのローカル経路にはbearerを選びます。
  • 応答もDashboard記録もない： CC Switchでproxy、Routingのマスタースイッチ、Claude routeが有効か確認します。
  • 記録はあるがリクエストが失敗する： Keyグループ、現在のモデル、利用可能な残高、キーに余分な空白がないか確認します。
  • Apply locally後に何も変わらない： Relaunch nowをクリックし、Continue with Gatewayを選びます。

一つのUIラベルだけでGatewayを診断しないでください。Claude Desktopのモード、ローカル経路の状態、Dashboardのリクエスト記録を対応付け、チェーンがどの層で切れたかを確認します。

この方法の制限

BetterTokenは独立したAPIプロバイダーであり、Anthropic製品でもClaudeサブスクリプションの代替でもありません。BetterTokenは自社API Endpointと設定ドキュメントを担当します。ダウンロードへのアクセス、サインイン、アップデート、Cowork、Code mode、その他のClaude Desktop機能は、アプリの現行版、プラン、Anthropicの規則に依存します。

ロシアからBetterToken API Endpointへ接続する際にVPNは不要です。この説明はClaudeサイト、アプリのダウンロード、アカウント、外部サービスには及びません。メニュー項目がこの記事と異なる場合は作業を止め、Claude Desktopの公式インストールドキュメントとBetterTokenの最新設定ガイドを比較してください。

FAQ

https://www.bettertoken.ai/v1をClaude Desktop Gatewayに入力できますか？

ここで説明するワークフローではできません。これはOpenAI-compatibleのアドレスです。Claudeグループは直接のAnthropic-compatible endpoint https://www.bettertoken.aiを使用し、CodexグループはCC SwitchのローカルService address経由で接続します。

GatewayモードにClaudeアカウントは必要ですか？

Anthropicの通常手順では、インストール後にサインインします。BetterToken Gatewayの現行ガイドでは、通常サインインより前にContinue with Gatewayを進めます。片方のモードの手順をもう片方にコピーせず、インストール済みClaude Desktop版の画面を確認してください。

正しい認証方式はどう判断しますか？

直接のClaudeグループにはx-api-keyを使用します。CC SwitchでローカルにルーティングするCodexグループにはbearerを使用します。設定適用後、Desktopの応答と新しいDashboard記録の両方を確認してください。

LLM ワークフローを最適化しませんか？

単一 API でモデルを接続し、キーと AI コストを管理できます。