CC-Switch で BeatAPI を使う

CC-Switch は、Claude Code、Codex CLI、Gemini CLI など複数の AI コーディング CLI の接続設定をまとめて管理するオープンソースのデスクトップアプリです。BeatAPI を一度登録すると、エディターを使わずクリックだけで切り替えられます。

前提条件

1. 対応する CLI が 1 つ以上インストールされていること。 Claude Code または Codex CLI を利用します。
2. BeatAPI API キー。 ダッシュボード → API キーで作成します。

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

brew tap farion1231/ccswitch
brew install --cask cc-switch

初回起動時にインストール済みの CLI を検出し、現在の設定を標準の接続先として取り込めます。

ステップ 2：BeatAPI を追加する

メイン画面上部でツールのグループを選択し、利用する CLI を設定します。

Claude Code の場合

1. Claude Code グループを選択します。
2. 右上の + を押します。
3. フォームを入力します。

4. Add を押します。

Codex の場合

1. Codex グループを選択します。
2. 右上の + を押します。
3. Codex の接続設定は 2 つのブロックです。auth.json ブロックには次を入力します。

{
  "OPENAI_API_KEY": "<BEATAPI_API_KEY>"
}

config.toml ブロックには次を入力します。

model = "gpt-5.6-sol"
model_provider = "beatapi"
[model_providers.beatapi]
name = "BeatAPI"
base_url = "https://api.beatapi.io/v1"
wire_api = "responses"
requires_openai_auth = true

4. 名前を BeatAPI にして Add を押します。CC-Switch は保存前に JSON と TOML を検証します。

ステップ 3：切り替える

メイン画面では、一覧の BeatAPI を選び Enable を押します。確認の通知が表示されます。

システムトレイでは、CC-Switch のアイコンを押し、メニューから接続先を選びます。

Claude Code は新しいセッションで変更を取り込みます。Codex はターミナルまたはエージェントの再起動が必要です。

モデル

どちらの CLI でも /model で切り替えられます。全モデルは Text API、料金は料金ページを参照してください。

よくある質問

切り替えが反映されません

• Claude Code は新しいセッションを開始します。解決しなければエージェントを再起動します。
• Codex はターミナルか Codex 自体を再起動します。

キーが拒否されます

1. 前後の空白なしでキー全体をコピーしたか確認します。
2. ダッシュボード → API キーで有効か確認します。
3. 上の注記と URL を照合します。Claude Code は /v1 なし、Codex は /v1 ありです。

Codex の追加時に形式エラーが出ます

CC-Switch は auth.json を JSON、config.toml を TOML として検証します。括弧やカンマの欠落、項目名の誤り、文書から貼り付けた装飾付きの引用符を確認してください。

どのファイルを書き換えますか？

• Claude Code は ~/.claude/settings.json。
• Codex は ~/.codex/config.toml と ~/.codex/auth.json。

CC-Switch は切り替え前にこれらをバックアップするため、手動編集は不要です。

サポート

ダッシュボードからチケットを作成し、失敗したレスポンスの request_id を添えてください。