env-vars.md +1 −1
357| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | `1` に設定すると、GitHub の `owner/repo` 短縮形のソースを SSH ではなく HTTPS でクローンします。プラグインのインストールと更新、および `/plugin marketplace add` と `update` に適用されます。CI ランナー、コンテナ、または `github.com` 用の SSH キーが設定されていない環境で便利です |357| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | `1` に設定すると、GitHub の `owner/repo` 短縮形のソースを SSH ではなく HTTPS でクローンします。プラグインのインストールと更新、および `/plugin marketplace add` と `update` に適用されます。CI ランナー、コンテナ、または `github.com` 用の SSH キーが設定されていない環境で便利です |
358| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 1 つ以上の読み取り専用プラグインシードディレクトリへのパス。Unix では `:`、Windows では `;` で区切ります。事前に用意したプラグインディレクトリをコンテナイメージにバンドルするために使用します。Claude Code は起動時にこれらのディレクトリからマーケットプレイスを登録し、事前にキャッシュされたプラグインを再クローンせずに使用します。[コンテナ向けにプラグインを事前に用意する](/docs/ja/plugins/org#seed-containers-and-ci) を参照してください |358| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 1 つ以上の読み取り専用プラグインシードディレクトリへのパス。Unix では `:`、Windows では `;` で区切ります。事前に用意したプラグインディレクトリをコンテナイメージにバンドルするために使用します。Claude Code は起動時にこれらのディレクトリからマーケットプレイスを登録し、事前にキャッシュされたプラグインを再クローンせずに使用します。[コンテナ向けにプラグインを事前に用意する](/docs/ja/plugins/org#seed-containers-and-ci) を参照してください |
359| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | `1` に設定すると、ツール呼び出し、フック、ステータスラインのコマンドのために PowerShell を起動する際に Claude Code が `-ExecutionPolicy Bypass` を渡すのをやめ、代わりにマシンの実効的な実行ポリシーを尊重します。デフォルトでは、Claude Code はプロセススコープで実行ポリシーを迂回するため、デフォルトで Restricted の Windows 環境でも `.ps1` スクリプトやモジュールのインポートが動作します。プロセススコープの迂回は、この設定に関係なく、グループポリシーの `MachinePolicy` や `UserPolicy` を上書きすることはありません |359| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | `1` に設定すると、ツール呼び出し、フック、ステータスラインのコマンドのために PowerShell を起動する際に Claude Code が `-ExecutionPolicy Bypass` を渡すのをやめ、代わりにマシンの実効的な実行ポリシーを尊重します。デフォルトでは、Claude Code はプロセススコープで実行ポリシーを迂回するため、デフォルトで Restricted の Windows 環境でも `.ps1` スクリプトやモジュールのインポートが動作します。プロセススコープの迂回は、この設定に関係なく、グループポリシーの `MachinePolicy` や `UserPolicy` を上書きすることはありません |
360360| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | `-p` フラグを使用した [非対話モード](/docs/ja/headless#background-tasks-at-exit) で、最後のターンの後にバックグラウンドのサブエージェントとワークフローをアイドル状態で待機する時間の上限(ミリ秒)。Claude がバックグラウンドの結果を処理するためにターンを実行するたびに、アイドル待機はやり直しになります。デフォルト: `600000`、つまり 10 分。アイドル待機が上限に達すると、Claude Code は残りのバックグラウンドタスクの待機をやめて終了します。無期限に待機するには `0` に設定します。この上限は、通常のバックグラウンドシェルに適用される 5 秒の猶予期間とは別のものです。Claude Code v2.1.182 以降が必要です || `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | `-p` フラグを使用した [非対話モード](/docs/ja/headless#background-tasks-at-exit) で、最後のターンの後にサブエージェントやワークフローなどのバックグラウンド作業をアイドル状態で待機する時間の上限(ミリ秒)。Claude がバックグラウンドの結果を処理するためにターンを実行するたびに、アイドル待機はリセットされます。デフォルト: `600000`、つまり 10 分。アイドル待機が上限に達すると、Claude Code は残りのバックグラウンドタスクの待機をやめて終了します。`0` に設定すると無期限に待機します。この上限は、通常のバックグラウンドシェルに適用される 5 秒の猶予期間とは別のものです。Claude Code v2.1.182 以降が必要です |
361| `CLAUDE_CODE_PROCESS_WRAPPER` | [エージェントビュー](/docs/ja/agent-view) セッションをホストするバックグラウンドサービスなど、Claude Code が自身のバイナリから起動するプロセスを、`/opt/corp/launcher` のような argv プレフィックスとして指定した企業のランチャーを通じて起動します。切り離されたバックグラウンドサービスが継承できるように、シェルでのエクスポートではなく、ユーザー設定または [管理設定](/docs/ja/managed-settings) の `env` ブロックで設定してください。プロジェクト設定とローカル設定ではこれを設定できません。[`processWrapper` 設定](/docs/ja/settings-reference#processwrapper) と同等で、この設定には Claude Code v2.1.210 以降が必要です。両方が設定されている場合はこの変数が優先されます。VS Code 拡張機能は、独自の `claudeProcessWrapper` 設定を通じて別途ランチャーを構成します。Windows では無視されます。値の形式、ランチャーが対象とする範囲、ランチャーが満たす必要のある要件については、[企業のランチャーの背後で Claude Code を実行する](/docs/ja/corporate-launcher) を参照してください。Claude Code v2.1.208 以降が必要です |361| `CLAUDE_CODE_PROCESS_WRAPPER` | [エージェントビュー](/docs/ja/agent-view) セッションをホストするバックグラウンドサービスなど、Claude Code が自身のバイナリから起動するプロセスを、`/opt/corp/launcher` のような argv プレフィックスとして指定した企業のランチャーを通じて起動します。切り離されたバックグラウンドサービスが継承できるように、シェルでのエクスポートではなく、ユーザー設定または [管理設定](/docs/ja/managed-settings) の `env` ブロックで設定してください。プロジェクト設定とローカル設定ではこれを設定できません。[`processWrapper` 設定](/docs/ja/settings-reference#processwrapper) と同等で、この設定には Claude Code v2.1.210 以降が必要です。両方が設定されている場合はこの変数が優先されます。VS Code 拡張機能は、独自の `claudeProcessWrapper` 設定を通じて別途ランチャーを構成します。Windows では無視されます。値の形式、ランチャーが対象とする範囲、ランチャーが満たす必要のある要件については、[企業のランチャーの背後で Claude Code を実行する](/docs/ja/corporate-launcher) を参照してください。Claude Code v2.1.208 以降が必要です |
362| `CLAUDE_CODE_PROJECT_DIR_NAME` | `CLAUDE_CONFIG_DIR` と一緒に設定し、Claude Code がそのセッションのトランスクリプトと自動メモリを保存する `projects/` ディレクトリの名前を、作業ディレクトリのパスから導出される名前の代わりに選択します。たとえば、`CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` で Claude Code を起動すると、それらは `/srv/tenant-a/projects/work/` の下に保存されます。`CLAUDE_CONFIG_DIR` が未設定の場合、Claude Code はこの変数を無視します。また、この変数は `claude` を起動した環境からのみ読み取られ、[設定ファイルの `env` ブロック](#in-settings-files) からは読み取られません。[プロジェクトディレクトリに自分で名前を付ける](/docs/ja/sessions#name-the-project-directory-yourself) を参照してください。Claude Code v2.1.234 以降が必要です |362| `CLAUDE_CODE_PROJECT_DIR_NAME` | `CLAUDE_CONFIG_DIR` と一緒に設定し、Claude Code がそのセッションのトランスクリプトと自動メモリを保存する `projects/` ディレクトリの名前を、作業ディレクトリのパスから導出される名前の代わりに選択します。たとえば、`CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` で Claude Code を起動すると、それらは `/srv/tenant-a/projects/work/` の下に保存されます。`CLAUDE_CONFIG_DIR` が未設定の場合、Claude Code はこの変数を無視します。また、この変数は `claude` を起動した環境からのみ読み取られ、[設定ファイルの `env` ブロック](#in-settings-files) からは読み取られません。[プロジェクトディレクトリに自分で名前を付ける](/docs/ja/sessions#name-the-project-directory-yourself) を参照してください。Claude Code v2.1.234 以降が必要です |
363| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Claude Code が受け付ける唯一の値である `5m` または `1h` を設定して、メインの会話(対話、`-p`、SDK のターンと、それらとインラインで実行されるヘルパー)の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択します。`promptCacheTtl` 設定と `ENABLE_PROMPT_CACHING_1H` より優先され、`FORCE_PROMPT_CACHING_5M` によって上書きされます。API は 1 時間のキャッシュ書き込みをより高い料金で請求します。Claude Code v2.1.242 以降が必要です |363| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Claude Code が受け付ける唯一の値である `5m` または `1h` を設定して、メインの会話(対話、`-p`、SDK のターンと、それらとインラインで実行されるヘルパー)の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択します。`promptCacheTtl` 設定と `ENABLE_PROMPT_CACHING_1H` より優先され、`FORCE_PROMPT_CACHING_5M` によって上書きされます。API は 1 時間のキャッシュ書き込みをより高い料金で請求します。Claude Code v2.1.242 以降が必要です |