Claudeアカウントスイッチの自動化

概要

Claude Codeはアカウントの認証情報をOSごとのセキュアストレージに保管します。

macOSではKeychainにClaude Code-credentials項目として保存され、LinuxとWindowsではユーザーのホームディレクトリにある.claude/.credentials.jsonファイルを使用します。

複数のClaudeアカウントを交互に使用する場合、毎回ログアウトとブラウザでのログインを繰り返すと作業の流れが途切れてしまいます。

この記事ではClaude Codeアカウントを素早く切り替える方法をまとめます。

主な方式は2つあります。

個人的には、単純なテストであれば直接スクリプトを組む方式で十分です。

頻繁に切り替えたり、GUI環境を好む場合はCCSwitcherのような専用ツールを使う方が安定します。

CASE 1: macOS Keychain認証情報の直接制御

1# 현재 Claude Code 인증 정보 백업
2security find-generic-password -s "Claude Code-credentials" -w > ~/.claude-creds-work.json
3
4# 기존 Keychain 항목 삭제
5security delete-generic-password -s "Claude Code-credentials" 2>/dev/null
6
7# 백업한 인증 정보를 Keychain에 다시 등록
8security add-generic-password -s "Claude Code-credentials" -a "$USER" -w "$(cat ~/.claude-creds-work.json)"

上記のコマンドは、現在ログインしているClaude Codeの認証情報をファイルに保存した後、Keychain項目を置き換える流れです。アカウントごとに~/.claude-creds-personal.json、~/.claude-creds-work.jsonのようにファイルを分けておくと、素早く切り替えられます。

自動化スクリプト

 1# Claude switch account
 2claude-switch() {
 3  local account=$1
 4  local creds_file=~/".claude-creds-${account}.json"
 5  
 6  if [ ! -f "$creds_file" ]; then
 7    echo "❌ 계정 파일 없음: $creds_file"
 8    return 1
 9  fi
10  
11  # Keychain 업데이트
12  security delete-generic-password -s "Claude Code-credentials" 2>/dev/null
13  security add-generic-password -s "Claude Code-credentials" -a "$USER" -w "$(cat $creds_file)"
14  
15  echo "✅ Claude 계정 전환 완료: $account"
16}
17
18# 사용법: claude-switch personal / claude-switch work

CASE 2: 専用ツールの使用

Keychainを直接制御する方式が負担に感じる場合は、アカウント切り替え専用のツールを使うのがよいでしょう。

• ターミナルベース: claudini
• macOS GUIベース: CCSwitcher

claudiniは、ターミナルでClaude Codeアカウントを切り替えたい場合に適しています。スクリプト方式と同様に、CLI中心で使用できます。

CCSwitcherは、macOSのメニューバーからアカウントを選択して切り替えられるGUIツールです。複数のアカウントを頻繁に行き来する環境であれば、自分でスクリプトを管理するより便利です。

macOSではCCSwitcherがおすすめ

まとめ

複数のClaude Codeアカウントを使用する場合、重要なのは認証情報をアカウントごとに分けておき、必要なタイミングで現在の認証情報に置き換えることです。

macOSではClaude Codeの認証情報がKeychainに保存されるため、securityコマンドで直接バックアップし、置き換えることができます。

この方式は構造がシンプルで、別途ツールを必要としません。

ただし、認証情報ファイルを自分で管理する必要があるため、ファイルの権限と保管場所に気を配る必要があります。

アカウントの切り替えが頻繁に必要な場合は、専用ツールを使う方がよいでしょう。

ターミナル中心で作業するならclaudiniを使用でき、macOSでGUIベースの切り替えを望むならCCSwitcherが最も便利です。

認証情報はアカウントへのアクセス権限と同様に扱う必要があります。バックアップファイルは外部ストレージにアップロードせず、必要なユーザーだけが読み取れるように管理してください。