ccswitch - Claude Code Account Switcher

複数のClaude Codeアカウントを簡単に切り替えるためのCLIツールです。~/.claude ディレクトリと ~/.claude.json（認証情報）を丸ごと入れ替えることで、異なるアカウントの設定・履歴・認証情報を素早く切り替えられます。

特徴

• シンプル: bash スクリプトのみで動作、依存関係なし
• 安全: 切り替え前に既存の設定を自動保存
• 高速: ディレクトリのコピーのみで瞬時に切り替え
• 直感的: 明確なコマンド体系

インストール

1. リポジトリをクローン

git clone https://github.com/bi9dri/switch-claude-code.git
cd switch-claude-code

2. スクリプトをインストール

# $HOME/.local/bin にコピー（推奨）
mkdir -p ~/.local/bin
cp ccswitch ~/.local/bin/

# PATHが通っていることを確認
# 以下を ~/.bashrc または ~/.zshrc に追加（必要に応じて）
# export PATH="$HOME/.local/bin:$PATH"

3. インストール確認

ccswitch --help

使い方

基本的なワークフロー

1. 現在の設定を保存

# 現在の ~/.claude を 'work' という名前で保存
ccswitch --save work

このコマンドは ~/.claude を ~/.config/ccswitch/work/ に、~/.claude.json を ~/.config/ccswitch/work.json に移動し、プロファイルとして登録します。

2. 別のアカウントで Claude Code を使用

通常通り Claude Code を起動し、別のアカウントでログインします。新しい ~/.claude ディレクトリが作成されます。

3. その設定も保存

# 新しい設定を 'personal' という名前で保存
ccswitch --save personal

4. プロファイルを切り替え

# 'work' プロファイルに切り替え
ccswitch work

# 'personal' プロファイルに切り替え
ccswitch personal

コマンド一覧

コマンド	説明
ccswitch <name>	指定したプロファイルに切り替え
ccswitch --save <name>	現在の ~/.claude と ~/.claude.json をプロファイルとして保存
ccswitch --status	現在アクティブなプロファイルと各ファイルの存在状態を表示
ccswitch --list	保存済みプロファイルの一覧を表示
ccswitch --help	ヘルプメッセージを表示

使用例

# 現在の状態を確認
ccswitch --status

# 保存済みプロファイルを確認
ccswitch --list

# 'work' プロファイルに切り替え
ccswitch work
# ✓ Switched to profile 'work'

# 現在のプロファイルを確認
ccswitch --status
# ✓ Current profile: work
# → ~/.claude: present
# → ~/.claude.json: present

仕組み

ディレクトリ構造

~/.claude/                      # Claude Code が使用する設定ディレクトリ
~/.claude.json                  # Claude Code の認証情報
~/.config/ccswitch/
├── .current                    # 現在アクティブなプロファイル名を記録
├── work/                       # 'work' プロファイルの ~/.claude のコピー
│   ├── settings.json
│   ├── projects/
│   ├── skills/
│   └── ...
├── work.json                   # 'work' プロファイルの ~/.claude.json のコピー
├── personal/                   # 'personal' プロファイルの ~/.claude のコピー
│   ├── settings.json
│   ├── projects/
│   └── ...
└── personal.json               # 'personal' プロファイルの ~/.claude.json のコピー

動作概要

1. 保存時 (--save <name>):

   • ~/.claude → ~/.config/ccswitch/<name>/ に移動
   • ~/.claude.json → ~/.config/ccswitch/<name>.json に移動
   • ~/.config/ccswitch/.current に <name> を記録

2. 切り替え時 (<name>):

   • 現在の ~/.claude を元のプロファイルに戻す
   • 現在の ~/.claude.json を元のプロファイルに戻す
   • ~/.config/ccswitch/<name>/ → ~/.claude にコピー
   • ~/.config/ccswitch/<name>.json → ~/.claude.json にコピー（存在しない場合は ~/.claude.json を削除）
   • ~/.config/ccswitch/.current を更新

トラブルシューティング

~/.claude と ~/.claude.json が存在しない

Claude Code を起動してログインし、初期設定を完了してから ccswitch --save を実行してください。~/.claude と ~/.claude.json のどちらか一方だけでも存在すれば保存できます。

プロファイルが見つからない

ccswitch --list

で保存済みプロファイルを確認してください。

パーミッションエラー

chmod +x ~/.local/bin/ccswitch

を実行して、スクリプトに実行権限があることを確認してください。

既存の ~/.claude を保護したい

# 初回は必ず --save で保存してから使用
ccswitch --save original

アンインストール

# スクリプトを削除
rm ~/.local/bin/ccswitch

# 保存したプロファイルも削除する場合
rm -rf ~/.config/ccswitch

ライセンス

MIT License

貢献

Issue や Pull Request を歓迎します！

注意事項

• Claude Code を使用中にプロファイルを切り替えないでください。必ず Claude Code を終了してから切り替えてください。
• ~/.config/ccswitch/ ディレクトリのバックアップは定期的に取ることをお勧めします（認証情報を含みます）。
• プロファイル名には英数字、ハイフン、アンダースコアのみ使用できます。

FAQ

Q: 複数のプロファイルを同時に使用できますか？

A: いいえ。任意の時点で1つのプロファイルのみが ~/.claude として存在します。別のプロファイルを使用するには切り替えが必要です。

Q: プロファイルのバックアップは？

A: すべてのプロファイルは ~/.config/ccswitch/ に保存されています。

Q: プロファイルを削除するには？

A: 以下のコマンドで削除できます。

rm -rf ~/.config/ccswitch/<プロファイル名>
rm -f ~/.config/ccswitch/<プロファイル名>.json