環境変数

CLAUDE_CONFIG_DIR

設定、資格情報、履歴、プラグインなどが保存されるディレクトリ(デフォルト:~/.claude)を上書きします。

使い方・用途

  • 仕事用と個人用など、複数のアカウント設定を切り替えて並行して利用したい場合にエイリアスなどでディレクトリを分けることができます。
  • クラウドプロバイダーの設定ウィザード(/setup-vertex 等)において、カスタムパスを指定した状態でのセットアップをより正確かつ容易にします。
英語原文(公式ドキュメントより)

Override the configuration directory (default: ~/.claude). All settings, credentials, session history, and plugins are stored under this path. Useful for running multiple accounts side by side: for example, alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

関連する変更履歴

v2.1.136(1件)

Fixed
IDEシェル統合用のロックファイルが、CLAUDE_CONFIG_DIR による設定ディレクトリの変更を反映していない問題を修正しました。
英語原文を表示
Fixed IDE shell-integration lock files not respecting CLAUDE_CONFIG_DIR

変更前

複数のアカウントやプロジェクトを切り替えるために設定ディレクトリをカスタマイズしていても、一部のロックファイルがデフォルトのパスに作成されてしまい、競合が発生していました。

変更後

シェル統合機能が環境変数を正しく認識し、指定されたカスタムディレクトリ内に全ての管理ファイルを配置するようになりました。

ユーザーへの恩恵

設定ディレクトリを完全に分離して、複数の Claude Code インスタンスを安全に並列実行できるようになります。

関連ドキュメント

v2.1.111(1件)

Improved
/setup-vertex/setup-bedrockにおいて、CLAUDE_CONFIG_DIR設定時のパス表示の正確化、既存設定の再利用、および100万トークンのコンテキストオプションの提示といった改善を行いました。
英語原文を表示
Improved /setup-vertex and /setup-bedrock to show the actual settings.json path when CLAUDE_CONFIG_DIR is set, seed model candidates from existing pins on re-run, and offer a "with 1M context" option for supported models

変更前

カスタム設定ディレクトリを使用している場合にパス表示が正しくなかったり、再設定時に以前選択したモデルが引き継がれず、設定の手間が大きくなっていました。

変更後

設定ウィザードが現在の環境をより正確に反映し、大規模なコードベースに必要な1Mコンテキストの有効化も簡単に行えるようになりました。

ユーザーへの恩恵

クラウドプロバイダー経由での利用開始や設定変更がより迅速かつ確実になり、特に大規模プロジェクトでのセットアップが楽になります。

関連ドキュメント

v1.0.6(1件)

Changed
Respect CLAUDE_CONFIG_DIR everywhere