環境変数

CLAUDE_ENV_FILE

各Bashコマンドの実行前にClaude Codeが同じシェルプロセス内で実行するシェルスクリプトのパスを指定し、ファイル内のexportをコマンドから参照可能にします。

使い方・用途

  • direnvのようにディレクトリごとに環境変数を切り替えるツールをClaude Code内で正しく機能させるために使用します。
  • virtualenvやcondaの仮想環境のアクティベート状態を、セッション内の複数のコマンド間で永続化させたい場合に便利です。
  • Windows環境においても仮想環境の自動有効化などの高度なワークフローを構築する際に役立ちます。
英語原文(公式ドキュメントより)

Path to a shell script whose contents Claude Code runs before each Bash command in the same shell process, so exports in the file are visible to the command. Use to persist virtualenv or conda activation across commands. Also populated dynamically by SessionStart, Setup, CwdChanged, and FileChanged hooks

関連する変更履歴

v2.1.111 (1件)

Changed
Windowsにおいて CLAUDE_ENV_FILE および SessionStart フックで生成された環境変数が正しく適用されるようになりました。
英語原文を表示
Windows: CLAUDE_ENV_FILE and SessionStart hook environment files now apply (previously a no-op)

変更前

Windows環境ではこれらが機能しておらず、仮想環境の自動有効化やカスタム環境変数の永続化が動作していませんでした。

変更後

Linux/macOSと同様の動作がサポートされ、フックを利用した高度なワークフロー構築が可能になりました。

ユーザーへの恩恵

Windows開発者も、プロジェクト開始時にPythonの仮想環境を自動でアクティベートするといった効率化の恩恵を受けられます。

関連ドキュメント

v2.1.108 (1件)

Fixed
CLAUDE_ENV_FILE(例:~/.zprofile)が末尾に「#」コメント行で終わる場合にBashツールの出力が空になる問題を修正
英語原文を表示
Fixed Bash tool producing no output when CLAUDE_ENV_FILE (e.g. ~/.zprofile) ends with a # comment line

変更前

環境設定ファイルの末尾にコメントがあると、Claudeが実行するBashコマンドの結果が正常に捕捉されないバグがありました。

変更後

設定ファイルの記述内容に左右されず、Bashツールのコマンド実行結果が常に正しく取得されるようになりました。

ユーザーへの恩恵

特定のシェル設定環境下でツールが故障する原因が解消され、シェル環境の自由度が向上します。