AIコーディング 2026.04.23

Claude Codeのコンテキスト管理5ステップ【セッション間で説明を繰り返さない設定方法】

タグ：ClaudeCode / AI開発効率化 / コンテキスト管理 / プロンプトエンジニアリング / ビギナー向け

Claude Codeで実現できるようになること

Claude Codeを仕事と個人プロジェクト、または複数のクライアント案件で使い分けている場合、従来はアカウントを切り替えるたびに再度ログインする必要がありました。毎回のログイン作業は数分の時間ロスになり、開発フローが途切れます。

この記事では、claude-swapというコミュニティ製ツールを使って、複数のClaude Codeアカウントをターミナルコマンドで瞬時に切り替える方法を解説します。再ログイン不要で、アカウント間の移動が数秒で完了するため、開発チームやフリーランスの時間効率が劇的に改善します。

前提条件

以下の環境が必要です。

Claude Codeがインストール済み（2026年版以降推奨）
Node.js 16以上（ローカルインストール用）
ターミナル（macOS/Linux/Windowsの場合はPowerShell or Git Bash）
複数のAnthropicアカウント（各アカウントの認証情報）

claude-swapはオープンソースツールで、GitHub経由で入手できます。公式のClaude Code機能ではなく、コミュニティが開発したユーティリティです。

そもそも「アカウント切り替え」が必要になる場面

Claude Codeを複数案件で使っていると、「このプロジェクトは別のAnthropicアカウントで管理したい」というケースが出てきます。たとえば、以下のような状況です。

会社用と個人用でAPIキーを分けている
クライアントごとに請求先アカウントが異なる
本番環境とステージング環境で別々のAPIキーを使いたい

何もしないと、そのたびにブラウザでログアウト・ログインを繰り返す必要があり、開発の流れが途切れます。

claude-swapの導入手順

ステップ1: claude-swapリポジトリのクローン

ターミナルを開き、以下のコマンドを実行してください。

git clone https://github.com/umesh-malik/claude-swap.git
cd claude-swap

リポジトリサイズは小さく、クローンは数秒で完了します。

ステップ2: 依存関係のインストール

npm install

このコマンドで、claude-swapの実行に必要なNode.jsパッケージがインストールされます。

ステップ3: 初期設定ファイルの作成

npm run init

このコマンドを実行すると、ホームディレクトリに.claude-swapという設定ディレクトリが自動生成されます。このディレクトリに複数アカウントの情報が保存されます。

ステップ4: アカウント情報の登録

npm run add-account

対話的なプロンプトが表示されます。以下の情報を順番に入力してください。

アカウント名: 識別用の名前（例: work-account, personal-account）
Anthropic APIキー: 各アカウントの認証トークン
デバイス名: このコンピュータの識別名（例: my-mac, work-pc）

入力例：

? Account name: work-account
? Anthropic API Key: sk-ant-xxxxxxxxxxxxxxxx
? Device name: my-macbook
✓ Account "work-account" registered successfully

複数のアカウントを登録する場合は、このコマンドを繰り返し実行します。

npm run add-account
# 2つ目のアカウント登録

ステップ5: アカウント一覧の確認

現在登録されているアカウントを確認するには、以下のコマンドを実行します。

npm run list-accounts

出力例：

Registered Accounts:
━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. work-account (Device: my-macbook)
2. personal-account (Device: my-macbook)
3. client-a-account (Device: my-macbook)

アカウントの切り替え方法

基本的な切り替えコマンド

登録済みのアカウントに切り替えるには、以下のコマンドを実行します。

npm run switch -- work-account

work-accountの部分を、登録時に付けたアカウント名に変更してください。実行すると、Claude Codeがそのアカウントで再起動します。

アカウント切り替えの仕組み

claude-swapが行う処理は以下の通りです：

登録されたアカウント名をチェック
APIキーを環境変数として設定
Claude Codeのセッション情報を更新
新しいアカウントで自動ログイン

手作業でのログアウト・ログイン操作は不要です。

シェルエイリアスで高速切り替え（応用）

毎回フルコマンドを打つのが手間な場合は、シェルの設定ファイルにエイリアスを追加できます。

macOS/Linuxの場合（~/.zshrcまたは~/.bashrcを編集）：

alias cs='npm run switch --'

設定を反映させます：

source ~/.zshrc

その後は、以下の短いコマンドで切り替え可能になります。

cs work-account

つまずきやすいポイント

❌ よくある失敗：APIキーの期限切れに気づかない

AnthropicのアカウントからAPIキーを取得しても、有効期限が切れると「APIキーが無効です」エラーが出ます。登録済みアカウントが急に使えなくなった場合は、まずAPIキーの有効期限を確認しましょう。

対策: 定期的にAPIキーをローテーション（更新）し、期限切れ前に登録情報を更新する習慣をつけましょう。

npm run remove-account -- work-account
npm run add-account
# 新しいAPIキーを入力

❌ 公共PCやシェアードマシンでの使用

claude-swapはAPIキーをローカルの.claude-swapディレクトリに保存します。他人が使うマシンでそのまま利用すると、アカウント情報が漏洩するリスクがあります。

対策: 共有マシンでは使用しないか、使用後に必ずアカウント情報を削除してください。組織での利用時は、APIキーを環境変数（.envファイル等）で管理する方がより安全です。

❌ 切り替えコマンドのタイプミス

アカウント名のスペルを間違えると「Account not found」エラーになります。ハイフンや大文字小文字も含めて正確に入力する必要があります。

対策: まずnpm run list-accountsで登録済みの正確なアカウント名を確認してから切り替えコマンドを実行しましょう。

実装パターン例：複数クライアント案件を並行している場合

朝の開始時：クライアントA向けプロジェクト

cs client-a-account
# Claude Codeがクライアントaのアカウントで起動

昼間：クライアントB向けプロジェクトに切り替え

cs client-b-account
# 瞬時にセッション切り替え（再ログイン不要）

夕方：個人プロジェクトに切り替え

cs personal-account

この流れで、1日中複数プロジェクトを切り替えながら効率的に開発できます。再ログインの待ち時間がゼロになるため、実際の開発時間が大幅に増加します。

実験してみる価値がある工夫

Claude Codeを自動テストやコード生成に組み込む際、CI/CDパイプラインでもclaude-swapを活用できます。

npm run switch -- ci-account
npm run generate-code -- src/

本番環境とステージング環境で異なるAPIキーを自動的に切り替えながら、コード生成やテストを実行することが可能です。

よくある質問

Q. claude-swapはAnthropicの公式ツールか？ A. いいえ。コミュニティが開発したオープンソースのユーティリティです。公式サポートはなく、GitHubリポジトリでメンテナンスされています。

Q. アカウントを削除したい場合はどうするか？ A. 以下のコマンドで登録情報を完全削除できます。

npm run remove-account -- account-name

Q. 切り替え後もClaude Codeが古いアカウントを使っている。 A. Claude Codeのプロセスがバックグラウンドで稼働している可能性があります。以下のコマンドで既存プロセスを終了してから再切り替えしてください。

# macOS/Linux
pkill -f "claude"
npm run switch -- work-account

Q. Node.jsが入っていない場合はどうするか？ A. Node.js公式サイト（https://nodejs.org）から最新版（v16以上）をインストールし、ターミナルを再起動してください。`node —versionとnpm —version`でバージョン番号が表示されれば準備完了です。

次に読むと良い記事

Claude Codeの基本的な使い方を学べる初心者向けガイド
プロンプトの工夫で生成AIの精度を上げるテクニック集
複数人でのプロジェクト管理とAI連携のベストプラクティス

参考ソース

Memory management in Claude Code: Context Pipeline