環境変数

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.275(1件)

Fixed
[VSCode] environmentVariables 設定に空の CLAUDE_CONFIG_DIR エントリがあると、Claude Code がファイルをワークスペースに保持してしまう問題を修正
英語原文を表示
[VSCode] Fixed an empty CLAUDE_CONFIG_DIR entry in the environmentVariables setting making Claude Code keep its files in the workspace

変更前

空の CLAUDE_CONFIG_DIR エントリがあっても無視されるようになり、設定ファイル類は引き続きユーザーの設定ディレクトリに保存される

変更後

environmentVariables 設定に空の CLAUDE_CONFIG_DIR エントリがあると、Claude Code が設定ファイル類をワークスペース内に置いてしまう状態だった

ユーザーへの恩恵

environmentVariables に空の CLAUDE_CONFIG_DIR エントリが残っていても、設定ファイルの場所がワークスペースにずれることがなくなる

関連ドキュメント

v2.1.274(1件)

Fixed
[VSCode] CLAUDE_CONFIG_DIR を環境変数設定で変更した後にターミナルで行ったサインインやサインアウトが、再読み込みするまで表示されない問題を修正した
英語原文を表示
[VSCode] Fixed sign-ins and sign-outs made in a terminal not showing until a reload after CLAUDE_CONFIG_DIR changed in the Environment Variables setting

変更前

CLAUDE_CONFIG_DIR を環境変数設定で変更した後でも、ターミナルで行ったサインインやサインアウトが VS Code 拡張に即座に反映されるようになった。

変更後

CLAUDE_CONFIG_DIR を環境変数設定で変更した後、ターミナルでサインインやサインアウトしても、VS Code 拡張を再読み込みするまでその状態変更が UI に表示されなかった。

ユーザーへの恩恵

ターミナルでサインイン・サインアウトした後、再読み込みせずに VS Code 拡張上で最新のサインイン状態を確認できるようになる。

関連ドキュメント

v2.1.271(1件)

Fixed
[VSCode] environmentVariables 設定で CLAUDE_CONFIG_DIR を変更した後も、ウィンドウをリロードするまで開いているタブやサイドバーが古い設定フォルダを使い続ける問題を修正した。
英語原文を表示
[VSCode] Fixed open tabs and the side bar keeping the old config folder until a window reload after CLAUDE_CONFIG_DIR changed in the environmentVariables setting

変更前

設定で environmentVariables の中の CLAUDE_CONFIG_DIR を変更したとき、VSCode 拡張は起動時に値を再読み込みしない。開いているタブやサイドバーに表示される Claude Code は、古い設定フォルダを使い続ける。

変更後

設定で environmentVariables の中の CLAUDE_CONFIG_DIR を変更したとき、VSCode 拡張が開いているタブやサイドバーに表示される Claude Code は、古い設定フォルダを使い続ける。ユーザーがウィンドウをリロードするまで、この状態が続く。

ユーザーへの恩恵

この修正により、ウィンドウをリロードしなくても VSCode 拡張が CLAUDE_CONFIG_DIR の新しい値を反映する。

関連ドキュメント

v2.1.269(1件)

Fixed
IDESettings
[VSCode] 設定ファイルまたは environmentVariables 設定で CLAUDE_CONFIG_DIR が設定されている場合に、セッションリストがデフォルトフォルダのセッションを表示し続ける問題を修正した。
英語原文を表示
[VSCode] Fixed the session list keeping sessions from the default folder when CLAUDE_CONFIG_DIR is set in a settings file or the environmentVariables setting

変更前

CLAUDE_CONFIG_DIR が設定ファイルや environmentVariables 設定で指定されていても、VSCode 拡張のセッションリストは CLAUDE_CONFIG_DIR で指定されたフォルダではなく、デフォルトフォルダ(~/.claude)のセッションを表示し続けていた。

変更後

CLAUDE_CONFIG_DIR が設定ファイルや environmentVariables 設定で指定されているときに、VSCode 拡張のセッションリストがデフォルトフォルダのセッションを表示し続けていた。

ユーザーへの恩恵

設定ファイルで CLAUDE_CONFIG_DIR を設定した環境でも、セッションリストが正しいフォルダのセッションを表示するようになる。

関連ドキュメント

v2.1.268(2件)

Fixed
[VSCode] CLAUDE_CONFIG_DIR が設定ファイルや environmentVariables 設定で指定された場合に、セッション一覧、設定トグル、チャットタブが正しく動作しない問題を修正した
英語原文を表示
[VSCode] Fixed the session list, settings toggles, and chat tabs when CLAUDE_CONFIG_DIR is set in a settings file or the environmentVariables setting

変更前

CLAUDE_CONFIG_DIR を設定ファイルや environmentVariables 設定で指定すると、VS Code 拡張のセッション一覧、設定トグル、チャットタブの表示や動作が壊れていた

変更後

CLAUDE_CONFIG_DIR を設定ファイルや environmentVariables 設定で指定した場合でも、セッション一覧・設定トグル・チャットタブが正常に表示・操作できるようになった

ユーザーへの恩恵

カスタム設定ディレクトリを使う環境でも VS Code 拡張の UI を問題なく利用できるようになる

関連ドキュメント

Fixed
IDESettings
[VSCode] settings 経由で CLAUDE_CONFIG_DIR が設定されているときに、カスタムスタイルビルダーが CLI が読み取らないフォルダーに User レベルのスタイルを保存する問題を修正した。
英語原文を表示
[VSCode] Fixed the custom style builder saving a User level style in a folder the CLI does not read when CLAUDE_CONFIG_DIR is set through settings

変更前

CLAUDE_CONFIG_DIR を settings で設定した場合、VS Code 拡張のカスタムスタイルビルダーで作成した User レベルのスタイルが CLI が読み取らないフォルダーに保存されていました。

変更後

CLAUDE_CONFIG_DIR を settings で設定した場合、VS Code 拡張のカスタムスタイルビルダーで作成した User レベルのスタイルが CLI が読み取らないフォルダーに保存される不具合がありました。修正後は、CLI が読み取る CLAUDE_CONFIG_DIR 配下の output-styles フォルダーに正しく保存されます。

ユーザーへの恩恵

CLAUDE_CONFIG_DIR を設定していても、VS Code 拡張で作成したカスタムスタイルが CLI 側で正しく認識・利用できるようになります。

関連ドキュメント

v2.1.251(1件)

Changed
Settings
プロジェクトレベルの .claude/settings.json の env が CLAUDE_CONFIG_DIR、CLAUDE_CODE_TMPDIR、または TMPDIR/TMP/TEMP を設定するのをやめ、代わりにシェル、ユーザー、または管理設定で設定するように変更しました。
英語原文を表示
Changed project-level .claude/settings.json env to no longer set CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR, or TMPDIR/TMP/TEMP; set them in your shell, user, or managed settings instead

変更前

以前は、プロジェクトレベルの .claude/settings.json の env が CLAUDE_CONFIG_DIR、CLAUDE_CODE_TMPDIR、または TMPDIR/TMP/TEMP を設定していました。

変更後

現在は、プロジェクトレベルの .claude/settings.json の env が CLAUDE_CONFIG_DIR、CLAUDE_CODE_TMPDIR、または TMPDIR/TMP/TEMP を設定するのをやめ、代わりにシェル、ユーザー、または管理設定で設定するようになりました。

ユーザーへの恩恵

設定の優先順位が明確になり、環境変数の管理が容易になります。

関連ドキュメント

v2.1.208(1件)

Fixed
Settings
ワークフロー保存ダイアログにおいて、ユーザー指定の保存先が CLAUDE_CONFIG_DIR ではなく誤って ~/.claude/workflows/ と表示される問題を修正した。
英語原文を表示
Fixed the workflow save dialog showing ~/.claude/workflows/ instead of the CLAUDE_CONFIG_DIR location for user-scope saves

変更前

環境変数で設定ディレクトリの場所を変更していても、画面上のガイドでは常にデフォルトのパスが表示され、どこに保存されるのか混乱を招いていた。

変更後

ダイアログが表示される際、現在有効な CLAUDE_CONFIG_DIR のパスが正しく反映されるようになった。実際の保存先と表示が一致する。

ユーザーへの恩恵

設定ファイルを標準以外の場所に置いている場合でも、ワークフローの保存先を迷わず確信できるようになります。

関連ドキュメント

v2.1.136(1件)

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

変更前

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

変更後

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

ユーザーへの恩恵

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

関連ドキュメント

v2.1.111(1件)

Improved
Settings
/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