> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# CC-Switch で BeatAPI を使う

> 1 つのデスクトップアプリで Claude Code と Codex CLI の BeatAPI 設定を管理し、設定ファイルを編集せずに接続先を切り替えます。

# CC-Switch で BeatAPI を使う

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

## 前提条件

1. **対応する CLI が 1 つ以上インストールされていること。** [Claude Code](/integrations/claude-code) または [Codex CLI](/integrations/codex-cli) を利用します。
2. **BeatAPI API キー。** [ダッシュボード → API キー](https://beatapi.io/dashboard/apikeys)で作成します。

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

#### macOS

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

GitHub Releases から署名済みの `.dmg` も取得できます。macOS 12 以降が必要です。

#### Windows

GitHub Releases から `.msi` インストーラーかポータブル版の `.zip` を取得します。Windows 10 以降が必要です。

#### Linux

GitHub Releases から、Debian/Ubuntu 用の `.deb`、Fedora/RHEL 用の `.rpm`、または汎用の `.AppImage` を取得します。Arch では `paru -S cc-switch-bin` を実行します。

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

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

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

### Claude Code の場合

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

| 項目           | 値                        |
| ------------ | ------------------------ |
| Name         | `BeatAPI`                |
| Endpoint URL | `https://api.beatapi.io` |
| API Key      | BeatAPI API キー           |
| API Format   | `Anthropic Messages`     |

4. **Add** を押します。

### Codex の場合

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

```json
{
  "OPENAI_API_KEY": "<BEATAPI_API_KEY>"
}
```

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

```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 を検証します。

> **Note**
>
> 2 つの URL は意図的に異なります。取り違えが最もよくある設定ミスです。Claude Code は Anthropic ネイティブ形式で `https://api.beatapi.io` を使います。クライアントが `/v1/messages` を付加するため、`/v1` は付けません。Codex は OpenAI 互換形式で、`/v1` を含む `https://api.beatapi.io/v1` を使います。

## ステップ 3：切り替える

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

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

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

## モデル

| モデル ID             | 利用先         | 用途                            |
| ------------------ | ----------- | ----------------------------- |
| `claude-fable-5-1` | Claude Code | 最新世代。エージェントによるコーディングの標準選択     |
| `claude-opus-5`    | Claude Code | 最も高度な推論                       |
| `claude-sonnet-5`  | Claude Code | 性能と速度のバランス                    |
| `gpt-5.6-sol`      | Codex       | 最も高性能なコーディングモデル               |
| `gpt-6-astra`      | Codex       | 最新世代。入力トークンが 272K を超えると単価が上がる |

どちらの CLI でも `/model` で切り替えられます。全モデルは [Text API](/text-api)、料金は[料金ページ](https://beatapi.io/pricing)を参照してください。

## よくある質問

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

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

### キーが拒否されます

1. 前後の空白なしでキー全体をコピーしたか確認します。
2. [ダッシュボード → API キー](https://beatapi.io/dashboard/apikeys)で有効か確認します。
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 は切り替え前にこれらをバックアップするため、手動編集は不要です。

## サポート

[ダッシュボード](https://beatapi.io/dashboard)からチケットを作成し、失敗したレスポンスの `request_id` を添えてください。