初心者向け：CC Switch

コマンドラインでの設定に慣れていない場合は、オープンソースのデスクトップアプリ CC Switch がおすすめです。Claude Code、Codex、Gemini CLI などの AI コーディングツールの「プロバイダー」を GUI で管理でき、Base URL と API キーを一度入力すれば、公式 API と SoleAPI をワンクリックで切り替えられます。設定ファイルを手で編集する必要は一切ありません。

準備：API キーを取得する

まず SoleAPI に登録し、コンソールの「API Key」ページでキー（sk-sole-… 形式）を作成します。詳細はクイックスタートを参照してください。

ステップ 1：CC Switch をインストール

• macOS：以下のコマンドを実行するか、Releases から .dmg をダウンロードします。

brew install --cask cc-switch

• Windows：Releases から MSI インストーラー（またはポータブル版 ZIP）をダウンロードします。
• Linux：Releases に .deb / .rpm / AppImage があります。
• 公式ダウンロードページ：ccswitch.io/download（各プラットフォームの最新版）

ステップ 2：ワンクリックで SoleAPI をインポート

コンソールの「API Key」ページに CC Switch にインポートボタンがあります——キー作成直後のダイアログにも、既存キーの各行にも表示されます。クリックするとローカルの CC Switch が起動して設定プレビューが表示され、確認するだけで追加完了。Base URL もキーも自動で入力されます。

インポートしたプロバイダーは CC Switch の利用状況表示が自動で有効になります。一覧に残高と累計消費が表示され、データは GET https://api.soleapi.com/v1/usage（API キー認証、remaining / used / total / unit を返却、単位は Credits）から取得されます。手動追加の場合も、プロバイダーの「利用状況」設定にこの URL を入力すれば有効にできます。

手動で追加（代替手段）

ワンクリックインポートが使えない場合は手動でも設定できます：

1. CC Switch を開き、設定したいツールのタブ（例：Claude Code）を選びます。
2. **「プロバイダーを追加」**をクリックし、カスタム設定を選んで次のとおり入力します：

1. 名前は自由（例：SoleAPI）に付けて保存します。

ステップ 3：有効化して動作確認

1. 追加した SoleAPI をリストで選択し、**「有効化」**をクリックします。CC Switch が対応ツールの設定ファイルへ自動で書き込みます。
2. ターミナルを再起動（または CLI ツールを再起動）して設定を反映させます。Claude Code はホットスイッチに対応しているため、通常は再起動不要です。
3. Claude Code で何かメッセージを送り、正常に返答が来れば接続成功です。次のコマンドでもキーを確認できます：

curl https://api.soleapi.com/v1/models \
  -H "Authorization: Bearer sk-sole-your-key"

公式 API や他のプロバイダーに戻したいときは、CC Switch のリスト（またはシステムトレイのメニュー）で該当項目をクリックするだけです。何度でも切り替えられます。

よくある問題

• 401 エラー：キーのコピー漏れ、または無効化されています。コンソールで確認してください。詳細はエラーコードを参照。
• エラーに二重スラッシュ（//v1）が出る：Base URL 末尾の / を削除して再度有効化してください。
• 切り替えが反映されない：ターミナルを再起動し、CC Switch でそのプロバイダーが「有効」になっているか確認してください。
• 「CC Switch にインポート」をクリックしても反応がない：CC Switch が未インストール、v3.16 未満、または一度も起動していない（プロトコル未登録）可能性があります。インストール・起動後に再度クリックしてください。