StoryClaw Docs

CC Switch

CC Switch は無料・オープンソースのデスクトップアプリで、AI ツールのモデルプロバイダー設定を GUI で管理し、設定ファイルや環境変数の手動編集を不要にします。

CC Switch は無料・オープンソースのデスクトップアプリです。AI コーディングツールのプロバイダー設定を GUI で管理し、設定ファイルや環境変数の手動編集を不要にします。複数のプロバイダーをワンクリックで切り替えることもできます。

CC Switch は任意です。 Claude Code は環境変数 2 つ、Codex は config.toml の記述だけで StoryClaw に接続できます。デスクトップアプリを入れたくない場合は、Claude Code または Codex のページにある「方法 A:手動設定」を参照してください。

ダウンロードとインストール

インストーラーはすべて GitHub Releases にあります。最新版を選んでダウンロードしてください。

macOS 12(Monterey)以降が必要です。インストーラーは Universal Binary で、Intel と Apple Silicon の両方に対応します。

方法 1:Homebrew

# インストール
brew install --cask cc-switch

# 最新版に更新
brew upgrade --cask cc-switch

方法 2:インストーラーをダウンロード

Releases から CC-Switch-<バージョン>-macOS.dmg をダウンロードし、開いて CC Switch を Applications フォルダにドラッグします。

「開発元を検証できません」と表示された場合

初回起動時に macOS の Gatekeeper がブロックすることがあります。いずれかの方法で解決できます。

  • 「システム設定 → プライバシーとセキュリティ」を開き、「セキュリティ」欄の「このまま開く」をクリックします。
  • ターミナルで xattr -cr /Applications/CC\ Switch.app を実行します。

Windows 10 以降が必要です。

方法 1:MSI インストーラー

Releases から CC-Switch-<バージョン>-Windows.msi をダウンロードして実行し、スタートメニューから起動します。自動更新に対応しています。

方法 2:ポータブル版

CC-Switch-<バージョン>-Windows-Portable.zip をダウンロードして展開するだけで使えます。レジストリには書き込みません。

Windows Defender が警告を表示する場合があります。CC Switch はオープンソースです。「詳細情報」→「実行」を選んでください。

.deb.rpm、AppImage の 3 形式を提供しており、主要なディストリビューションをカバーします。

まず CPU アーキテクチャを確認し、対応するパッケージをダウンロードしてください。

uname -m
# x86_64            → x86_64 パッケージ
# aarch64 または arm64 → arm64 パッケージ

Ubuntu / Debian

# ファイル名は実際にダウンロードしたバージョンとアーキテクチャに置き換えてください
sudo apt install ./CC-Switch-<バージョ>-Linux-x86_64.deb

Fedora / RHEL / openSUSE

# Fedora / RHEL
sudo dnf install ./CC-Switch-<バージョ>-Linux-x86_64.rpm

# openSUSE
sudo zypper install ./CC-Switch-<バージョ>-Linux-x86_64.rpm

その他のディストリビューション(AppImage、インストール不要)

chmod +x CC-Switch-<バージョ>-Linux-x86_64.AppImage
./CC-Switch-<バージョン>-Linux-x86_64.AppImage

次のステップ

CC Switch をインストールしたら、その中に StoryClaw をプロバイダーとして追加します。設定項目はツールごとに異なるため、接続したいツールのガイドを参照してください。

On this page