コンテンツにスキップ
日本語
РусскийEnglish简体中文HindiEspañolPortuguês (BR)日本語FrançaisDeutsch한국어
無料で登録
高度な設定

CC Switch で BetterToken を設定する

CC Switch で Claude Code、Claude Desktop、Codex CLI、OpenCode、OpenClaw の BetterToken API Key、接続先、モデルを管理します。

CC Switch は Claude Code、Claude Desktop、Codex CLI、OpenCode、OpenClaw の API Key、接続先、モデル設定を管理する任意のデスクトップアプリです。

CC Switch をインストールする

macOS

Homebrew が最も簡単な方法です。GitHub Releases から最新の .dmg または .zip をダウンロードすることもできます。

ターミナルウィンドウ
brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows

GitHub Releases から最新の CC-Switch-v{version}-Windows.msi インストーラーまたはポータブル版 .zip をダウンロードします。

Linux

GitHub Releases から最新の .deb、.rpm、または .AppImage をダウンロードします。

準備するもの

  • BetterToken API Key（登録して取得）
  • Claude Code は Anthropic プロトコルを使用するため、Base URL は https://bettertoken.ai です
  • Codex、OpenCode、OpenClaw は OpenAI 互換プロトコルを使用するため、Base URL は https://bettertoken.ai/v1 です
  • Codex、OpenCode、OpenClaw 用に現在のモデル ID を 1 つ用意します。BetterToken モデル広場からコピーするか、CC Switch に /v1/models から取得させます

BetterToken プロバイダーを追加する

Claude Code

CC Switch で Claude Code を選び、Add Provider をクリックしてください。

BetterToken API Key、Base URL https://bettertoken.ai、使用する Model ID を設定して Claude Code に接続します。

  • Provider Name: BetterToken
  • API Key: YOUR_API_KEY
  • API Endpoint: https://bettertoken.ai

Anthropic Messages API 形式を使用します。Model Mapping に選択した Model ID を入力して保存します。

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

設定を保存して BetterToken を有効にし、クライアントを完全に再起動します。

Claude Desktop

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

CC Switch の独立した Claude Desktop ページで、プロバイダーを追加するか、既存の Claude Code プロバイダーをインポートします。有効にする前に、インポートした Claude Model ID と接続モードを確認してください。Claude Desktop 公式マニュアルを参照してください。

Claude Desktop で直接設定する場合は、Claude Desktop ガイドに従い、Gateway、Base URL https://bettertoken.ai、BetterToken API Key、Gateway auth scheme x-api-key を設定します。Apply Changes で保存すると Claude Desktop が再起動します。

Codex

現在の CC Switch でログインを維持する場合は、先に公式アカウントでログインします。設定 → アプリ設定 → Codex で 引き継ぎなしの切り替え時に公式ログインを維持 を有効にし、BetterToken を追加または有効化します。公式ログインファイルを外部 Key で上書きしないでください。

CC Switch で Codex を開き、プロバイダーを追加する

CC Switch を開き、Codex に切り替えて Add Provider をクリックします。CC Switch が最初にプリセットの選択を求める場合は、OpenAI Compatible または Custom を選択してください。

スクリーンショットの番号はこれらの操作に対応します。

  1. Codex に切り替えます
  2. 右上の Add Provider をクリックします
CC Switch の Codex ページ。上部で Codex が選択され、右上の追加ボタンで新しいプロバイダーを作成します。

基本項目を入力する

  • Provider Name: BetterToken
  • Base URL: https://bettertoken.ai/v1
  • API Key: BetterToken API Key

カスタム設定ビューに切り替える場合は、基になる設定で wire_api = "responses" が使用されていることを確認します。

スクリーンショットの番号はこれらの項目に対応します。

  1. Provider Name
  2. API Key
  3. Base URL
CC Switch の Codex プロバイダー編集ページ。Provider Name、API Key、Base URL の入力場所を示しています。

モデルを取得してマッピングする

Fetch Models をクリックし、モデル広場から現在の Model ID を選択します。Codex では CC Switch proxy は不要です。

保存して切り替える

保存して BetterToken を有効にします。外部 API Key は config.toml の provider 設定に保存され、公式 auth.json の維持はログイン維持スイッチで制御します。

保存後、リストに戻り、BetterToken の項目が In Use と表示されていることを確認します。

BetterToken が選択され、In Use と表示された CC Switch の Codex プロバイダーリスト。

OpenCode

CC Switch で OpenCode を開き、プロバイダーを追加する

CC Switch を開き、OpenCode に切り替えて Add Provider をクリックします。CC Switch が最初にプリセットを求める場合は、OpenAI Compatible または Custom を選択してください。

基本項目を入力する

  • Provider Name: BetterToken
  • Base URL: https://bettertoken.ai/v1
  • API Key: BetterToken API Key
  • API Format: OpenAI Compatible

デフォルトモデルを選択する

可能な場合は Fetch Models を使用します。モデルを手動で入力する必要がある場合は、BetterToken モデル広場にある現在のモデル ID を使用します。

OpenCode は保存されたプロバイダー設定を直接読み込むため、CC Switch proxy は不要です。

保存して切り替える

CC Switch でプロバイダーを追加し、OpenCode 内で BetterToken のプロバイダーとモデルを選択します。CC Switch は既存の OpenCode プロバイダーと並べてこのプロバイダーを保存します。

OpenClaw

CC Switch で OpenClaw を開き、プロバイダーを追加する

CC Switch を開き、OpenClaw に切り替えて Add Provider をクリックします。CC Switch が最初にプリセットを求める場合は、OpenAI Compatible または Custom を選択してください。

基本項目を入力する

  • Provider Name: BetterToken
  • Base URL: https://bettertoken.ai/v1
  • API Key: BetterToken API Key
  • API Format: OpenAI Responses API

カスタム OpenClaw プロバイダー設定を編集する場合は、api が openai-responses に設定されていることを確認します。

デフォルトモデルを選択する

可能な場合は Fetch Models を使用します。モデルを手動で入力する必要がある場合は、現在のモデル ID を使用します。

OpenClaw は保存されたプロバイダー設定を直接使用するため、CC Switch proxy は不要です。

保存して切り替える

CC Switch でプロバイダーを追加し、OpenClaw 内で BetterToken のプロバイダーとモデルを選択します。CC Switch は既存の OpenClaw プロバイダーと並べてこのプロバイダーを保存します。

保存した変更を反映する

保存してプロバイダーを切り替えた後、設定を確認する前に対象のクライアントまたは Gateway を再起動します。

  • Claude Code：現在の Claude Code セッションを完全に終了してから、もう一度起動します。
  • Claude Desktop：アプリを完全に終了して開き直し、左下に Gateway が表示されることを確認します。
  • Codex：現在の Codex プロセスを再起動するか、新しいターミナルセッションを開きます。
  • OpenCode：現在の OpenCode セッションを終了してから、もう一度起動します。
  • OpenClaw：openclaw gateway restart を実行してから、Discord で /new、/status、/model を使用します。

CC Switch 固有の高度な機能

CC Switch は直接切り替えるときに公式 Codex ログインを維持できます。Codex セッション履歴の統合 は任意で、CLI の resume リストのみが対象です。現在のデスクトップ版だけなら不要です。別の provider で旧セッションを続行すると失敗する場合があるため、切り替え後は新しいセッションを作ります。公式ログインと履歴を参照してください。

よくある問題

  • Claude Code では、/v1 を Base URL に追加しないでください

  • Claude Desktop で Claude プロバイダー以外を使用する場合、CC Switch proxy を有効にし、アプリを完全に再起動します

  • Codex、OpenCode、OpenClaw は https://bettertoken.ai/v1 を使用します

  • Codex、OpenCode、OpenClaw でモデルを求められた場合は、モデル ID を使用します

  • Fetch Models が失敗する場合は、API Key と Base URL を確認してからモデル ID を手動で貼り付けます

  • 変更が反映されない場合は、Codex では CC Switch で BetterToken が有効になっていること、OpenCode/OpenClaw ではクライアント内で BetterToken が選択されていることを確認し、上記の手順で対象のクライアントまたは Gateway を再起動します

  • 公式アカウントの利用枠を使い切って Codex が送信をブロックする場合、公式ログインを保持するとブロックも続くことがあります。公式リリースの案内に従い、直接接続モードに切り替え、Settings → App config → Codex の Keep official login for direct switches をオフにして BetterToken を有効にし、Codex を完全に再起動してください。API Key モードになるため、公式ログインが必要な機能は利用できなくなります。利用枠がリセットされたら、ログインを保持する設定に戻してください。

関連ページ

関連 FAQ

BetterTokenAI MODEL APIsすべてのモデルを1つのAPIでAI API · 従量課金$2 割引$5 チャージでチャージ額の $5 全額が残高に反映。API の利用を始める初回チャージ：$5 分の残高、$2 割引条件を満たす初回チャージが対象。