# CC Switch

出典: https://docs.aicentos.com/ja/clients/cc-switch

Language: ja

> aicentos コンソールから CC Switch へワンクリックで設定をインポートし、Claude Code / Codex / Gemini CLI を管理

CC Switch はクロスプラットフォームの AI CLI 設定管理ツールで、Claude Code、Codex、Gemini CLI などのツールのモデルプロバイダー（Provider）設定を一元管理します。複数の CLI ツールや複数の設定の間をワンクリックで切り替えられ、環境変数を何度も書き換える必要がありません。

aicentos コンソールには **CC Switch ワンクリックインポート**が組み込まれています。Base URL とキーを手打ちする必要はなく、数クリックで CC Switch に設定を書き込めます。

## 準備

1. [aicentos コンソール](https://aicentos.com/) にログインします
2. アカウントに残高があることを確認します（登録特典の体験クレジット ¥1 が進呈され、使い切ったら「**ウォレット**」でチャージします）
3. CC Switch をインストールします（下記参照）

## CC Switch のインストール

CC Switch はオープンソースプロジェクトで、ソースコードは GitHub でホストされています：[farion1231/cc-switch](https://github.com/farion1231/cc-switch)。

[Releases ページ](https://github.com/farion1231/cc-switch/releases) を開き、最新バージョンのリソース一覧から、お使いの OS に対応したインストーラーを選択します：

* macOS：`.dmg`
* Windows：`.msi`
* Linux：`.AppImage` / `.deb`

ダウンロードが完了したら、通常の方法で OS にインストールし、**CC Switch を少なくとも 1 回開いてください**。こうすることで、コンソールのインポートリンクがこのマシンへのインストール済みを認識できるようになります。

## ワンクリックインポート（推奨）

### ステップ 1：コンソールでインポートを開始

コンソール左側の「**API キー**」に入り、使いたいキーの行で右側の「**⋯**」をクリックし、メニューから「**CC Switch**」を選択します：

API キー一覧で CC Switch を選択

### ステップ 2：アプリとモデルの選択

「**CC Switch に入力**」ダイアログで対象アプリ（Claude / Codex / Gemini）を選択し、使用するモデルを確認します：

CC Switch 設定の入力

| 項目                 | 説明                                                                                                                   |
| ------------------ | -------------------------------------------------------------------------------------------------------------------- |
| アプリ                | どの CLI の設定に書き込むかを選択します。**Claude** は Anthropic プロトコル、**Codex** は OpenAI 互換フォーマット、**Gemini** は Gemini ネイティブフォーマットを使います |
| 名前                 | インポート後に CC Switch に表示される設定名。カスタマイズできます                                                                               |
| メインモデル             | この設定がデフォルトで使うモデル。必須です                                                                                                |
| Haiku / Sonnet モデル | Claude アプリ配下のティア別モデル。必要に応じて指定します                                                                                     |

モデル名は[対応モデル](https://docs.aicentos.com/ja/billing/models-list)を参考にできます。例：`claude-opus-4-8`、`claude-sonnet-5`、`claude-haiku-4-5`。

選択したら「**CC Switch を開く**」をクリックします。

### ステップ 3：ブラウザーでの起動確認

ブラウザーが CC Switch を開くかどうか尋ねてきたら、「**CC Switch.app を開く**」をクリックします：

ブラウザーが CC Switch の起動を確認

> 「aicentos.com が関連アプリでこの種のリンクを開くことを常に許可」にチェックを入れておくと、以降のインポートではこの確認ダイアログが表示されなくなります。

### ステップ 4：CC Switch でインポートを確認

CC Switch に「**プロバイダー設定のインポート確認**」ダイアログが表示されます。情報を確認して「**インポート**」をクリックします：

CC Switch のインポート確認

ダイアログには書き込まれるエンドポイント、キー、ティア別モデルが一覧表示されます。内容に問題がなければ「**インポート**」をクリックします。

インポートが完了すると、`aicentos Claude` が CC Switch の設定一覧に現れ、クリックするだけで切り替えられます：

インポート完了

## 手動設定

ワンクリックインポートを使いたくない場合は、CC Switch 内で「**新しいプロバイダーを追加**」をクリックして手動入力することもできます：

CC Switch で新しいプロバイダーを追加

| 項目        | 入力する値                                                                      |
| --------- | -------------------------------------------------------------------------- |
| プロバイダー名   | `aicentos`（自由に識別しやすい名前で OK）                                                |
| API Key   | コンソール「**API キー**」ページで作成したキー。`sk-xxxxxxxx` のような形式です                         |
| リクエストアドレス | Claude / Gemini は `https://aicentos.com`、Codex は `https://aicentos.com/v1` |

> **Anthropic プロトコルはルートアドレスだけを入力してください**。`/v1/messages` を手動で追加しないでください。クライアントが自動で連結します。

## 次のステップ

* [モデルステータスモニター](https://docs.aicentos.com/status) — 各モデルのリアルタイム稼働率を確認
* [対応モデル](https://docs.aicentos.com/ja/billing/models-list) — 完全なモデル一覧と ID を確認
* [課金](https://docs.aicentos.com/ja/billing/pricing) — チャージと従量課金について