CC Switch の接続
難易度 🧩 中級 | インターフェース形式 Claude | base_url
https://byesu.com
CC Switch は、オープンソースかつクロスプラットフォームの AI CLI 統合管理ツールで、Claude Code、Codex、Gemini CLI の間でワンクリックで異なる API プロバイダーを切り替えられます。環境変数や設定ファイルを手動で書き換える必要はありません。Byesu API を接続しておけば、その中でいつでも byesu のチャンネルに切り替えられます。
始める前に
まず コンソール → トークン で新しいトークン（sk-xxxx のような形式）を作成し、トークンに正しいグループを選択してください。グループによって、呼び出せるモデルや使用する経路が決まります。選び方が分からない場合は グループの選択 を参照してください。
CC Switch が管理するのは Claude Code のような CLI なので、Claude Code は Anthropic インターフェース形式 を使用し、base_url には https://byesu.com（/v1 を付けない）を使います。
ステップ 1：CC Switch をインストールする
公式ダウンロード：GitHub Releases（Windows / macOS / Linux 全プラットフォームのインストーラー）· 公式サイト ccswitch.io
お使いのシステムに合わせてインストール方法を選んでください：
brew tap farion1231/ccswitch
brew install --cask cc-switchGitHub Releases から MSI インストーラーをダウンロードするか、portable ZIP をダウンロードして解凍すればそのまま使えます。# GitHub Releases から DEB パッケージ / AppImage / RPM をダウンロード
# ArchLinux は AUR からインストール：
paru -S cc-switch-binインストールが完了したら CC Switch を開き、左上で Claude（Claude Code） のカテゴリーに切り替えます。
ステップ 2：byesu プロバイダーを追加する
方法 1：ワンクリックインポート（最速）
Byesu のコンソール上で操作している場合は、ccswitch:// のディープリンクで直接インポートでき、手入力を省けます：
- コンソール → トークン に入り、対象トークンのドロップダウンメニューから CC Switch を選択します。
- ポップアップした設定ボックスで：
- アプリケーションタイプ：Claude を選択
- 設定名：自由に付けてよい。例：
byesu - メインモデル（必須）：
claude-opus-4-8を選択 - Opus モデル：
claude-opus-4-8 - Sonnet モデル / Haiku モデル：任意。必要に応じて他の利用可能なモデルを選択
- CC Switch を開く をクリックすると、設定が自動的にインポートされます。
base_url とトークンを確認する
ワンクリックインポートは byesu のインターフェースアドレスとこのトークンの key を自動的に付与します。インポート後は、プロバイダーの詳細で base_url が https://byesu.com（Anthropic 形式、/v1 なし）になっているか確認してください。
方法 2：手動で追加する
CC Switch の Claude カテゴリーで「プロバイダーを追加」をクリックし、下表に従って入力します：
| 項目 | 入力内容 |
|---|---|
| 名称（Name） | byesu（任意） |
API アドレス / Base URL（ANTHROPIC_BASE_URL に対応） | https://byesu.com |
API Key / Auth Token（ANTHROPIC_AUTH_TOKEN に対応） | sk-xxxx（あなたの byesu トークン） |
| メインモデル / Opus | claude-opus-4-8 |
| Sonnet | claude-opus-4-8（または他の利用可能なモデル） |
| Haiku | デフォルトのままにするか、軽量モデルを選択 |
モデル名は byesu で実際に利用可能なものを使う
例えば claude-opus-4-8 です。Claude Code の Opus/Sonnet/Haiku の 3 段階はいずれも byesu 上の同じモデルまたは異なるモデルを指定できます。あなたのトークンの所属グループがそのモデルに対応していることだけ確認してください。
保存後、プロバイダー一覧でこの byesu をクリックすると、CC Switch がそれを Claude Code の設定（環境変数 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN）に書き込みます。
ステップ 3：有効になっているか確認する
- CC Switch で現在のプロバイダーを
byesuに切り替え ます。 - 新しいターミナルを開き、Claude Code を実行します：
claude- 何でもよいので質問してみてください。例：「こんにちは、使っているモデルを教えて」。正常に返信があり、認証エラーが出なければ、byesu に接続できています。
以前から Claude Code を開いていた場合は、プロバイダーを切り替えた後にターミナルを再起動してから実行し、新しい環境変数を有効にしてください。
うまくいかないときは？
- 401 / 認証失敗が出る：トークンが間違っているか、余分なスペースが含まれています。key が
sk-xxxxの形式になっているか確認してください。よくあるエラー #auth を参照。 - 利用可能なチャンネルがない / no channel と表示される：現在のトークンのグループにそのモデルが含まれていません。そのモデルに対応した別のグループに変更するか、グループ内のモデルを使ってください。グループの選択 と よくあるエラー #no-channel を参照。
- 残高不足 / balance：トークンのクォータまたはアカウント残高が不足しています。よくあるエラー #balance を参照。
- プロバイダーを切り替えても有効にならない：環境変数は既に開いているターミナルでは自動的に更新されません。ターミナルを再起動してから再試行してください。
さらなるトラブルシューティングは よくあるエラー を参照してください。