環境変数

CLAUDECODE

Claude Code が起動するサブプロセス(Bash ツールと PowerShell ツール、tmux セッション、hook コマンド、ステータスラインコマンド、stdio MCP サーバーのサブプロセス)内で 1 に設定される。IDE 拡張機能も統合ターミナル内でこの値を設定する。スクリプトが Claude Code が起動したサブプロセス内で実行されているかを検出するのに使用する。現在のプロセスが stdio MCP サーバー(Claude Code が起動したもの)の内部ではなく、ツール呼び出しや hook から直接起動されたものかを確認するには、代わりに CLAUDE_CODE_CHILD_SESSION を使用する。

使い方・用途

  • Claude Code が起動したサブプロセス内でスクリプトが動作しているかどうかを検出したいときに使える。
  • Claude Code が直接起動したプロセスかどうかを判定する CLI ツール側の出力制御で、人が端末から直接実行した場合に特定のタグやヒントを出さないようにするために使える。
英語原文(公式ドキュメントより)

Set to 1 in subprocesses Claude Code spawns (Bash and PowerShell tools, tmux sessions, hook commands, status line commands, stdio MCP server subprocesses). IDE extensions also set this in their integrated terminals. Use to detect when a script is running inside a subprocess spawned by Claude Code. To check whether the current process was spawned directly by a tool call or hook, rather than inside a stdio MCP server that Claude Code started, use CLAUDE_CODE_CHILD_SESSION instead

関連ドキュメント

関連する変更履歴

v2.1.154(1件)

Changed
Stdio MCPサーバーのサブプロセスに、環境変数CLAUDE_CODE_SESSION_IDとCLAUDECODE=1が渡されるようになりました。
英語原文を表示
Stdio MCP server subprocesses now receive CLAUDE_CODE_SESSION_ID and CLAUDECODE=1 in their environment

変更後

MCPサーバー側でセッションごとのログを記録したり、Claude Codeからの呼び出し時のみ特定の挙動をさせたりといった、より高度なインテグレーションが可能になります。

関連ドキュメント