README_JA.md
<a href="https://trendshift.io/repositories/15372" target="_blank"></a>
English | 中文 | 日本語 | Changelog
</div><details open> <summary>クリックで折りたたむ</summary>
MiniMax-M2.7 は、自律的進化と実世界の生産性向上のために設計された次世代大規模言語モデルです。従来のモデルとは異なり、M2.7 はエージェントチーム、動的ツール使用、強化学習ループを通じて自身の改善に積極的に参加します。ソフトウェアエンジニアリングにおいて優れた性能を発揮し（SWE-Pro で 56.22%、VIBE-Pro で 55.6%、Terminal Bench 2 で 57.0%）、複雑なオフィスワークフローにも秀でており、GDPval-AA で 1495 ELO のリーディングスコアを達成しています。Word・Excel・PowerPoint の高忠実度編集と、40 以上の複雑なスキルにわたる 97% の遵守率により、M2.7 は AI ネイティブなワークフローと組織構築の新基準を打ち立てます。
こちらから MiniMax Token Plan の限定 12% オフを入手！
最新の AI コーディングは Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw などの CLI ツールに依存していますが、各ツールの設定形式はバラバラです。API プロバイダを切り替えるたびに JSON、TOML、.env ファイルを手動で編集する必要があり、複数ツール間で MCP や Skills を統一的に管理する手段もありません。
CC Switch は、5 つの CLI ツールを 1 つのデスクトップアプリで一元管理できます。設定ファイルを手作業で編集する代わりに、ワンクリックでプロバイダをインポートし、瞬時に切り替えられるビジュアルインターフェースを提供します。50 以上の組み込みプリセット、統一 MCP・Skills 管理、システムトレイからの即時切り替え機能を搭載。すべてはアトミック書き込みによる信頼性の高い SQLite データベースに支えられており、設定の破損を防ぎます。
| メイン画面 | プロバイダ追加 |
|---|---|
ccswitch://) -- URL 経由でプロバイダ、MCP サーバー、Prompts、Skills をワンクリックインポートCC Switch は Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw の 5 つのツールに対応しています。各ツールに専用のプロバイダプリセットと設定管理が用意されています。
</details> <details> <summary><strong>プロバイダを切り替えた後、ターミナルの再起動は必要ですか？</strong></summary>ほとんどのツールでは、はい。変更を反映するにはターミナルまたは CLI ツールを再起動してください。ただし Claude Code は例外で、現在プロバイダデータのホットスイッチに対応しており、再起動は不要です。
</details> <details> <summary><strong>プロバイダを切り替えた後、プラグイン設定が消えてしまいました。どうすればよいですか？</strong></summary>CC Switch には「共有設定スニペット」機能があり、APIキーやエンドポイント以外の共通データをプロバイダ間で引き継ぐことができます。「プロバイダ編集」→「共有設定パネル」→「現在のプロバイダから抽出」をクリックして、すべての共通データを保存してください。新しいプロバイダを作成する際に「共有設定を書き込む」にチェック（デフォルトで有効）を入れれば、プラグインなどのデータが新しいプロバイダ設定に含まれます。すべての設定項目は、アプリ初回起動時にインポートされたデフォルトプロバイダに保存されており、失われることはありません。
</details> <details> <summary><strong>macOS のインストールについて</strong></summary>CC Switch の macOS 版は Apple によるコード署名と公証が完了しています。直接ダウンロードしてインストールできます — 追加の手順は不要です。.dmg インストーラの使用を推奨します。
CC Switch は「最小限の介入」という設計原則に従っています。アプリをアンインストールしても、CLI ツールは正常に動作し続けます。すべての設定を削除すると対応する CLI ツールが使用できなくなるため、システムは常にアクティブな設定を 1 つ保持します。特定の CLI ツールをあまり使用しない場合は、設定で非表示にできます。公式ログインに戻す方法は、次の質問をご覧ください。
</details> <details> <summary><strong>公式ログインに戻すにはどうすればよいですか？</strong></summary>プリセットリストから公式プロバイダを追加してください。切り替え後、ログアウト／ログインのフローを実行すれば、以降は公式プロバイダとサードパーティプロバイダを自由に切り替えられます。Codex では異なる公式プロバイダ間の切り替えに対応しており、複数の Plus アカウントや Team アカウントの切り替えに便利です。
</details> <details> <summary><strong>データはどこに保存されますか？</strong></summary>~/.cc-switch/cc-switch.db（SQLite -- プロバイダ、MCP、Prompts、Skills）~/.cc-switch/settings.json（デバイスレベルの UI 設定）~/.cc-switch/backups/（自動ローテーション、最新 10 件を保持）~/.cc-switch/skills/（デフォルトでシンボリックリンクにより対応アプリに接続）~/.cc-switch/skill-backups/（アンインストール前に自動作成、最新 20 件を保持）各機能の詳しい使い方については、ユーザーマニュアル をご覧ください。プロバイダ管理、MCP/Prompts/Skills、プロキシとフェイルオーバーなど、すべての機能を網羅しています。
補足: 初回起動時に、既存の CLI ツール設定を手動でインポートしてデフォルトプロバイダとして使用できます。
Releases ページから最新版の CC-Switch-v{version}-Windows.msi インストーラー、またはポータブル版 CC-Switch-v{version}-Windows-Portable.zip をダウンロード。
方法 1: Homebrew でインストール（推奨）
brew tap farion1231/ccswitch
brew install --cask cc-switch
アップデート:
brew upgrade --cask cc-switch
方法 2: 手動ダウンロード
Releases から CC-Switch-v{version}-macOS.zip をダウンロードして展開。
注意: 開発者アカウント未登録のため、初回起動時に「開発元を確認できません」と表示される場合があります。一度閉じてから「システム設定」→「プライバシーとセキュリティ」→「このまま開く」をクリックしてください。以降は通常通り起動できます。
paru でインストール（推奨）
paru -S cc-switch-bin
Releases から最新版の Linux ビルドをダウンロード：
CC-Switch-v{version}-Linux.deb（Debian/Ubuntu）CC-Switch-v{version}-Linux.rpm（Fedora/RHEL/openSUSE）CC-Switch-v{version}-Linux.AppImage（汎用）<details> <summary><strong>アーキテクチャ概要</strong></summary>Flatpak：公式リリースには含まれていません。
.debから自分でビルドできます — 手順はflatpak/README.mdを参照してください。
┌─────────────────────────────────────────────────────────────┐
│ Frontend (React + TS) │
│ ┌─────────────┐ ┌──────────────┐ ┌──────────────────┐ │
│ │ Components │ │ Hooks │ │ TanStack Query │ │
│ │ (UI) │──│ (Bus. Logic) │──│ (Cache/Sync) │ │
│ └─────────────┘ └──────────────┘ └──────────────────┘ │
└────────────────────────┬────────────────────────────────────┘
│ Tauri IPC
┌────────────────────────▼────────────────────────────────────┐
│ Backend (Tauri + Rust) │
│ ┌─────────────┐ ┌──────────────┐ ┌──────────────────┐ │
│ │ Commands │ │ Services │ │ Models/Config │ │
│ │ (API Layer) │──│ (Bus. Layer) │──│ (Data) │ │
│ └─────────────┘ └──────────────┘ └──────────────────┘ │
└─────────────────────────────────────────────────────────────┘
コア設計パターン
~/.cc-switch/cc-switch.db（SQLite）に集約主要コンポーネント
# 依存関係をインストール
pnpm install
# ホットリロード付き開発モード
pnpm dev
# 型チェック
pnpm typecheck
# コード整形
pnpm format
# フォーマット検証
pnpm format:check
# フロントエンド単体テスト
pnpm test:unit
# ウォッチモード（開発に推奨）
pnpm test:unit:watch
# アプリをビルド
pnpm build
# デバッグビルド
pnpm tauri build --debug
cd src-tauri
# Rust コード整形
cargo fmt
# clippy チェック
cargo clippy
# バックエンドテスト
cargo test
# 特定テストのみ実行
cargo test test_name
# test-hooks フィーチャー付きでテスト
cargo test --features test-hooks
フロントエンドテスト:
テスト実行:
# 全テストを実行
pnpm test:unit
# ウォッチモード（自動再実行）
pnpm test:unit:watch
# カバレッジレポート付き
pnpm test:unit --coverage
フロントエンド: React 18 · TypeScript · Vite · TailwindCSS 3.4 · TanStack Query v5 · react-i18next · react-hook-form · zod · shadcn/ui · @dnd-kit
バックエンド: Tauri 2.8 · Rust · serde · tokio · thiserror · tauri-plugin-updater/process/dialog/store/log
テスト: vitest · MSW · @testing-library/react
</details> <details> <summary><strong>プロジェクト構成</strong></summary>├── src/ # フロントエンド (React + TypeScript)
│ ├── components/
│ │ ├── providers/ # プロバイダ管理
│ │ ├── mcp/ # MCP パネル
│ │ ├── prompts/ # Prompts 管理
│ │ ├── skills/ # Skills 管理
│ │ ├── sessions/ # Session Manager
│ │ ├── proxy/ # Proxy モードパネル
│ │ ├── openclaw/ # OpenClaw 設定パネル
│ │ ├── settings/ # 設定 (Terminal/Backup/About)
│ │ ├── deeplink/ # Deep Link インポート
│ │ ├── env/ # 環境変数管理
│ │ ├── universal/ # クロスアプリ設定
│ │ ├── usage/ # 使用量統計
│ │ └── ui/ # shadcn/ui コンポーネントライブラリ
│ ├── hooks/ # カスタムフック（ビジネスロジック）
│ ├── lib/
│ │ ├── api/ # Tauri API ラッパー（型安全）
│ │ └── query/ # TanStack Query 設定
│ ├── locales/ # 翻訳 (zh/en/ja)
│ ├── config/ # プリセット (providers/mcp)
│ └── types/ # TypeScript 型定義
├── src-tauri/ # バックエンド (Rust)
│ └── src/
│ ├── commands/ # Tauri コマンド層（ドメイン別）
│ ├── services/ # ビジネスロジック層
│ ├── database/ # SQLite DAO 層
│ ├── proxy/ # Proxy モジュール
│ ├── session_manager/ # セッション管理
│ ├── deeplink/ # Deep Link 処理
│ └── mcp/ # MCP 同期モジュール
├── tests/ # フロントエンドテスト
└── assets/ # スクリーンショット & パートナーリソース
Issue や提案を歓迎します！
PR を送る前に以下をご確認ください：
pnpm typecheckpnpm format:checkpnpm test:unit新機能の場合は、PR を送る前に Issue でディスカッションしてください。プロジェクトに合わない機能の PR はクローズされる場合があります。
MIT © Jason Young