Files
cc-switch/docs/user-manual/ja/1-getting-started/1.2-installation.md
Jason 44b6eacf87 feat(ci): add macOS code signing and Apple notarization to release workflow
- Import Developer ID Application certificate into temporary keychain
- Inject APPLE_SIGNING_IDENTITY/APPLE_ID/APPLE_PASSWORD/APPLE_TEAM_ID
  into Tauri build step for automatic signing and notarization
- Staple notarization tickets to both .app and .dmg (hard-fail)
- Add verification step: codesign --verify + spctl -a + stapler validate
  for both .app and .dmg, gating the release on success
- Collect .dmg alongside .tar.gz and .zip in release assets
- Clean up temporary keychain with original default restored
- Update release notes to recommend .dmg and note Apple notarization
- Remove all xattr workarounds and "unidentified developer" warnings
  from README, README_ZH, installation guides, and FAQ (EN/ZH/JA)
2026-03-23 22:43:41 +08:00

4.4 KiB
Raw Blame History

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

方法 1HomebrewmacOS 推奨)

brew install claude-code

方法 2npm

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

Codex

方法 1HomebrewmacOS 推奨)

brew install codex

方法 2npm

npm install -g @openai/codex

Gemini CLI

方法 1HomebrewmacOS 推奨)

brew install gemini-cli

方法 2npm

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

方法 1Homebrew推奨

# 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. 「アプリケーション」フォルダにドラッグ

署名・公証済み

CC Switch の macOS 版は Apple のコード署名と公証を受けています。追加の操作なしで直接インストールして開くことができます。

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
  1. 実行:
./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