cc-switch/docs/user-manual/ja/1-getting-started/1.2-installation.md

1.2 インストールガイド

前提条件

Node.js のインストール

CC Switch が管理する CLI ツール（Claude Code、Codex、Gemini CLI）には Node.js 環境が必要です。

推奨バージョン：Node.js 18 LTS 以上

Windows

1. Node.js 公式サイト にアクセス

2. LTS バージョンのインストーラーをダウンロード

3. インストーラーを実行し、指示に従ってインストール

4. インストールの確認：

node --version
npm --version

macOS

# Homebrew でインストール
brew install node

# または nvm を使用（推奨）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts

Linux

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# または nvm を使用
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts

CLI ツールのインストール

Claude Code

方法 1：Homebrew（macOS 推奨）

brew install claude-code

方法 2：npm

npm install -g @anthropic-ai/claude-code

Codex

方法 1：Homebrew（macOS 推奨）

brew install codex

方法 2：npm

npm install -g @openai/codex

Gemini CLI

方法 1：Homebrew（macOS 推奨）

brew install gemini-cli

方法 2：npm

npm install -g @google/gemini-cli

---

Windows

インストーラー方式

1. Releases ページ にアクセス
2. CC-Switch-v{バージョン}-Windows.msi をダウンロード
3. インストーラーをダブルクリックして実行
4. 指示に従ってインストール

ポータブル版（インストール不要）

1. CC-Switch-v{バージョン}-Windows-Portable.zip をダウンロード
2. 任意のディレクトリに展開
3. CC-Switch.exe を実行

macOS

方法 1：Homebrew（推奨）

# tap を追加
brew tap farion1231/ccswitch

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

最新バージョンに更新：

brew upgrade --cask cc-switch

方法 2：手動ダウンロード

1. CC-Switch-v{バージョン}-macOS.zip をダウンロード
2. 展開して CC Switch.app を取得
3. 「アプリケーション」フォルダにドラッグ

初回起動時の警告

開発者が Apple 開発者アカウントを持っていないため、初回起動時に「不明な開発者」の警告が表示される場合があります：

推奨される解決方法： ターミナルで以下のコマンドを実行してください：

sudo xattr -dr com.apple.quarantine /Applications/CC\ Switch.app/

別の解決方法（システム設定から）：

1. 警告ダイアログを閉じる
2. 「システム設定」→「プライバシーとセキュリティ」を開く
3. CC Switch に関する表示を見つけ、「このまま開く」をクリック
4. 再度アプリを開くと正常に使用可能

Linux

ArchLinux

AUR ヘルパーを使用してインストール：

# paru を使用
paru -S cc-switch-bin

# または yay を使用
yay -S cc-switch-bin

Debian / Ubuntu

1. CC-Switch-v{バージョン}-Linux.deb をダウンロード
2. インストール：

sudo dpkg -i CC-Switch-v{バージョン}-Linux.deb

# 依存関係に問題がある場合
sudo apt-get install -f

AppImage（汎用）

1. CC-Switch-v{バージョン}-Linux.AppImage をダウンロード
2. 実行権限を追加：

chmod +x CC-Switch-v{バージョン}-Linux.AppImage

3. 実行：

./CC-Switch-v{バージョン}-Linux.AppImage

インストールの確認

インストール完了後、CC Switch を起動します：

1. アプリウィンドウが正常に表示される
2. システムトレイに CC Switch のアイコンが表示される
3. Claude / Codex / Gemini の 3 つのアプリを切り替えられる

自動更新

CC Switch には自動更新機能が内蔵されています：

• 起動時に自動で更新を確認
• 新しいバージョンがある場合、画面に更新通知を表示
• クリックするとダウンロードしてインストール

「設定 → バージョン情報」から手動で更新を確認することもできます。

アンインストール

Windows

• 「設定 → アプリ」からアンインストール
• またはインストールディレクトリのアンインストーラーを実行

macOS

• CC Switch.app をゴミ箱に移動
• オプション：設定ディレクトリ ~/.cc-switch/ を削除

Linux

# Debian/Ubuntu
sudo apt remove cc-switch

# ArchLinux
paru -R cc-switch-bin