CCBaga:Claude IDとブラウザチェックのためのクロスプラットフォームツールキット

CCBagaは、暗号化されたClaude IDのローカルアーカイブ、フィンガープリント機能を備えたコンパニオンブラウザ、システムの地域設定コントロールを、macOS、Linux、Windows向けのネイティブツールキットに統合します。

Claude CodeやClaude Desktopのローカル環境を複数管理していると、リスクが伴うことがあります。アカウントを切り替える際に役立つ状態が上書きされたり、意図した範囲を超えてデータが削除されたり、ブラウザやシステムの設定が選択した地域と一致しなかったりする可能性があります。CCBagaは、何をアーカイブするか、ワークスペースに何を残すか、どの環境チェックに実際に合格したかを明示的に管理できるネイティブのデスクトップワークフローに、これらの作業をまとめます。

このプロジェクトは、macOS、Linux、Windows向けの、MITライセンスで提供される独立したRustおよびTauriアプリケーションです。明示された想定用途は、海外に居住または渡航している人が自身のClaude IDを管理することです。Anthropicの利用規約に違反する使い方は禁止されています。

役割を分担する2つのアプリ

CCBagaは連携する2つのアプリで構成されています。CCBaga-AはローカルID、システム設定、環境チェックを管理します。CCBaga-Bは専用プロファイルを備えた、コンパニオンのFingerprint Chromiumブラウザです。ブラウザでの測定結果はローカルセッションを介してホストに返されるため、ブラウザのテストページにTauriコマンドへのアクセス権を与える必要はありません。

この分離が重要なのは、設定が適用されていることと、結果が検証されていることは同じではないからです。CCBagaはタイムゾーンやブラウザのフィンガープリントを適用したうえで、ブラウザとマシンが実際にどのような情報を報告するかを測定できます。

日常的なワークフローでは、まず地域を選択し、ブラウザキャッシュの消去、フィンガープリントのローテーション、タイムゾーンと言語のリセット、現在のIDのアーカイブという4つの一般的な操作を行えます。詳細な設定は、Network、Claude identities、Browser、Computerにあります。インターフェースは英語と簡体字中国語に対応しています。UIの言語を変更しても、コンピューターやブラウザの言語は変わりません。

現在の状態を失わずにClaude IDを切り替える

IDマネージャーは、Claude CodeとClaude Desktopの既定のローカルデータディレクトリを管理します。IDを切り替えるたびに、保存済みのIDを復元する前、または空のワークスペースで開始する前に、切り替え元のIDが保存されます。切り替える前にKeep in workspaceを展開すると、スキルとコマンド、プラグイン、MCP設定、個人設定、プロジェクト記録、会話履歴、キャッシュやログをそのまま残すか、IDと一緒に移動するかを選択できます。ログインデータは、アーカイブされたIDと常に一緒に移動します。

アーカイブは圧縮、認証、暗号化された.bagaコンテナで、Claudeの作業ディレクトリの外部に保存されます。ローカルのSQLiteデータベースには、ID名、保持ポリシー、復旧状態が記録されます。CCBagaはワークスペースを変更する前にアーカイブを検証します。切り替えに失敗するとロールバックされ、中断された切り替えからの復旧手段も提供されます。復旧時も、まず復旧前の状態が保存されます。

保存したIDは、同じオペレーティングシステムを実行するデバイス間でエクスポートおよびインポートできます。エクスポートはパスワードで保護され、インポートではIDの切り替えや既存アカウントの上書きをせずにアーカイブが追加されます。フィンガープリント設定を任意で含めることができますが、ブラウザのCookie、パスワード、プロキシ設定は含まれません。リポジトリでは、暗号化されたデバイス間転送と、IDバックアップの安全性チェックについても説明されています。

重要な制限事項があります。Claude独自のデータディレクトリ外にあるプロジェクトソースはスキャンされません。カスタムのCLAUDE_CONFIG_DIRの場所は自動的には含まれません。選択中の現在のデータを直接削除しても、アーカイブは作成されません。保存済みのカードを削除すると、そのアーカイブが削除されます。どちらの操作にも明示的な確認が必要です。ファイルシステムの所有権や管理者アクセスは、絶対的な秘密保持の境界ではありません。また、サーバー側で有効期限が切れたログインや取り消されたログインでは、再認証が必要になる場合があります。

設定だけでなく、ブラウザ環境を測定する

CCBagaのブラウザチェックでは、ネットワークの出口と推定国、タイムゾーン、言語、プラットフォーム、CPU数、ブラウザエンジンのバージョン、位置情報の設定を確認します。チェック結果が一致し、レポートがクリーナーに届き、測定エラーが残っていない場合にのみ、成功ページが表示されます。

キャッシュの消去と完全なリセットの違いは、特に重要です。Clear cacheでは、サインイン状態と個人のブラウザデータが保持されます。Clear all browser dataを実行すると、保存したパスワード、暗号化メタデータ、ブックマーク、履歴、拡張機能、設定、ウェブサイトのセッションを含む、現在のIDのブラウザプロファイル全体が恒久的にリセットされます。他のIDのプロファイルやID保管庫には影響せず、バックアップも作成されません。実行には、別途確認が必要です。

緑色の結果が示すのは限定的な証拠であり、匿名性やアカウントの受け入れを保証するものではありません。DNSおよびWebRTCの漏えいチェックは独立して検証されず、IPジオロケーションは外部サービスによる推定です。地域を選択すると言語、タイムゾーン、地域設定が変わりますが、パブリックIPは変わりません。フィンガープリントをローテーションするとCCBaga-Bが終了して再起動するため、ブラウザで未完了の作業がある場合は、先に保存してください。

承認ベースの任意のネットワーク設定

Networkセクションには、「VPSを入手」「住宅用プロキシを入手」「Skillをインストール」という3段階のガイドと、選択したコーディングエージェント(General、Codex、Cursor、OpenCode、Copilot)向けのコピー可能なプロンプトがあります。独立したccbaga-network SkillはAgent Skills仕様に準拠しており、次のコマンドでインストールできます。

npx skills add liseami/CCBaga --skill ccbaga-network --global

このSkillは、ポート22でrootの鍵認証を使う、Debian 12または13の認証済みサーバーに対応しています。VPSのアドレス、対応するPEM/PPK/PUB鍵ファイルまたはダウンロードした鍵バンドル、住宅用SOCKS5接続情報があれば、Xray/Realityを設定し、SSH IDと固定のSOCKS5出口を確認できます。また、サーバーのセルフチェックが通過した後に、非公開のローカルインポートファイルを提供できます。リモートでの変更は、実際の変更内容が承認された後にのみ行われます。クライアントの設定では、TUNをON、System ProxyをOFFにし、ブラウザの明示的なプロキシ設定は空にします。TUNとブラウザの動作については、別途検証が必要です。

サブスクリプションURLはHTTPを使用し、認証情報を含むため、プロジェクトではSSH経由で取得したファイルを優先するよう推奨しています。アプリ自体がSSH鍵やプロキシ認証情報を収集したり、サーバーにデプロイしたりすることはありません。ネットワーク設定は任意です。ローカルのID管理やブラウザのメンテナンスにVPSやプロキシのサブスクリプションは必要ありません。コーディングエージェントに提供したデータは、各プロバイダーのデータ取り扱い方針の対象となります。

インストールと開発

公式に対応するプラットフォームは、Apple Silicon搭載のmacOS 12以降、Linux x86_64、Windows 10/11 x86_64です。Intel MacとLinux ARM64はサポート対象外です。Linuxビルドには、Ubuntu 22.04(glibc 2.35)上でビルドされたDEB、RPM、AppImageパッケージに加え、現行のArch/pacmanシステム向けの別パッケージがあります。いずれのパッケージにもコンパニオンブラウザが含まれます。Windowsでは、2つのアプリを含むNSISインストーラーを使用します。Authenticode署名はなく、SmartScreenの警告が表示されたり、管理対象のセキュリティポリシーによってブロックされたりすることがあります。

macOSでは、公式のCCBaga-<version>-macos-arm64.dmgをダウンロードしてください。1つのディスクイメージにCCBaga-A.appとCCBaga-B.appの両方が含まれており、ブラウザだけを別途ダウンロードする必要はありません。両方を「アプリケーション」にドラッグし、CCBaga-Aを起動すると、コンパニオンブラウザも起動します。

macOS向けのソースビルドに必要なものとして、リポジトリではBun、Rust、Xcode Command Line Tools、および別途取得するブラウザエンジンを挙げています。取得スクリプトは、固定バージョンのFingerprint Chromium 148.0.7778.215(macOS arm64)エンジンをダウンロードし、SHA-256を検証したうえで、バンドル構造と通知ファイルを保持します。基本的な開発手順は次のとおりです。

bun install --frozen-lockfile
python3 scripts/fetch-browser.py
sh scripts/make-icons.sh
sh scripts/package-browser.sh
bun run tauri dev

有用なチェックには、bun run build、bun test、cargo test --manifest-path src-tauri/Cargo.tomlによるRustテスト、ブラウザ署名テスト、オフラインのNetwork Skillテストがあります。プロジェクトのCIでは、Ubuntu、macOS、Windows上でフロントエンド、ネイティブRust、Skill、インストールのチェックを実行します。ドキュメントに記載されたワークフローでは、読み取り専用トークンを使用し、署名シークレットや成果物のアップロードは行いません。エンジンとインストーラーの完全な検証は別途実施されます。

CCBagaのアーキテクチャは、ネイティブコマンドとトランザクション境界を担うRustおよびTauri 2、UIを担うReact 19とTypeScript、OS統合用のプラットフォーム固有ブリッジ、実際のブラウザ測定を行う専用Chromiumランタイムを組み合わせています。中核となる設計原則は、明確な境界のもとで状態を可視化することです。切り替え前にアーカイブする、破壊的な操作の前に確認を求める、適用済みの設定と測定結果を区別する、そしてあらゆる環境やアカウントの状態に対応しているかのように見せず、プラットフォーム上の制限を明示することです。

ソース

liseami/CCBaga