CC Switch の変更が反映されないとき、最も多い原因は保存失敗ではありません。確認しているファイル、実行中のクライアント、CC Switch が書き込んだ live config が同じものではないことがあります。先に設定を削除せず、実際に有効な設定元を見つけます。
3種類の設定を区別する
- CC Switch 自体のデータ：Provider、同期、バックアップ、管理記録。
- 対象ツールの live config：Claude Code、Codex などが起動時に実際に読む設定。
- プロジェクト設定：リポジトリ専用の MCP、環境変数、説明ファイル。ユーザー設定より優先される場合がある。
CC Switch は対象ツールの live config を書き込みまたは読み戻すことを目的にしていますが、実際のパスはツール、OS、バージョンで変わります。ネット上の固定ディレクトリをそのまま使わず、CC Switch で選択中のツールが管理する対象を確認し、対象 CLI の設定出力やログで照合してください。
変更後も反映されない場合の順序
- CC Switch で Provider、MCP、Skill が保存済みで、正しいワークスペースを切り替えたか確認する。
- 対象 CLI と関連端末を完全に終了してから再起動する。多くの CLI は Provider 設定をホットリロードしない。
- プロジェクトディレクトリの設定または環境変数がユーザー設定を上書きしていないか確認する。
- MCP server 自体のログを見て、「設定は読まれたが起動に失敗した」状態ではないか確認する。
- クラウド同期を使う場合、別デバイスが古い版を書き戻していないか確認する。
手編集を同期で上書きしない
切り分けではバックアップと比較はできますが、CC Switch、テキストエディタ、同期フォルダーで同じ項目を同時に編集しないでください。同期を一時停止し、現行設定をエクスポートまたはバックアップし、最小変更を1つ行い、再起動と検証後に同期を戻す方法が安全です。
API key、MCP コマンド、ローカルパスは機密になり得ます。スクリーンショットやログを共有する前に隠してください。Provider、クラウド同期、バックアップは CC Switch 使用ガイドを、MCP 呼び出しのエラーは MCP ツール呼び出しの切り分けを参照してください。
まとめ
CC Switch の変更が反映されない場合は、「どこへ書いたか、何が上書きするか、再起動したか、サービスが起動するか」を順に確認します。最小限の検証は、全再インストールや設定全削除より安全です。
まず設定元の一覧を作る
調査前に、CC Switch の現在設定、対象クライアントのユーザー設定、プロジェクト設定、端末環境変数、システム環境変数、クラウド同期コピーを一覧にします。「最後に編集したファイルが有効」とは限りません。多くの CLI は起動時に環境変数を読み、プロジェクト設定もユーザー設定を上書きできます。
| 項目 | 記録する内容 |
|---|---|
| 現在のクライアント | 名前、バージョン、起動方法 |
| 現在のワークスペース | リポジトリルート、信頼状態 |
| Provider | Base URL とモデル別名、完全な key は記録しない |
| MCP | server 名、コマンド、起動ログの場所 |
| 同期 | 有効か、最後に同期したデバイス |
Provider が切り替わらない場合
対象クライアントの要求ログまたはサーバーログで、実際に接続した endpoint を確認します。まだ旧アドレスなら書き込み、上書き、再起動不足を調べます。新アドレスなのに失敗するなら、新 Provider の key、モデル名、サービス状態を調べます。この2種類を分けると、誤った層を何度も変えずに済みます。
古い端末ウィンドウにも注意します。CC Switch がシステム設定を更新しても、実行中 shell は古い環境変数を保持します。閉じて新しい端末を開き、最小要求を試してください。
MCP の変更が反映されない場合
MCP には、クライアントが設定を読むことと、server が起動できることの2段階があります。ツール一覧に server がなければ設定未読または形式不正です。表示されるのに呼び出しが失敗するなら、起動コマンド、作業ディレクトリ、依存関係、ポート、stderr ログを確認します。
Windows では空白を含むパス、入れ子の引用符、別環境の Node/Python 実行ファイルがよく原因になります。未検証の長い shell コマンドを設定に直接入れず、同じ端末で単独実行してから使います。
安全な復旧方法
設定が混乱している場合は、読める状態をエクスポートまたはコピーして同期を停止します。CC Switch が管理していると分かるテスト項目だけを削除し、無関係なツール設定は残します。単純な Provider または MCP server を作り、書き込み、再起動、呼び出しを確認してから、古い内容を段階的に取り込みます。
FAQ：すべての設定ディレクトリを削除できますか？
推奨しません。key の参照、MCP 設定、セッション、再構築しにくいプロジェクト設定を失う可能性があります。先にバックアップし、所有者を特定してから最小範囲で復旧してください。
FAQ：別のPCで切替結果が違うのはなぜですか？
最初に同期版、クライアント版、システム環境変数を確認します。同期はファイルをコピーするだけで、ローカルモデル、パス、実行ファイル、権限まで同一にするものではありません。