環境変数

CLAUDE_CODE_SHELL_PREFIX

Claude Code が起動するシェルコマンド（Bashツール、フック、MCPサーバー起動など）をラップするコマンドプレフィックスを指定します。

使い方・用途

  • 全てのコマンド実行をカスタムスクリプト経由にすることで、監査ログの記録やデバッグを可能にします。
  • スペースや特殊文字を含む複雑な引数も適切にクォーティングして MCP サーバーに渡せるよう改善されており、安定したラップ環境を提供します。
英語原文(公式ドキュメントより)

Command prefix that wraps shell commands Claude Code spawns: Bash tool calls, hook commands, and stdio MCP server startup commands. Useful for logging or auditing. Example: setting /path/to/logger.sh runs each command as /path/to/logger.sh <command>

hook MCP server

関連する変更履歴

v2.1.128 (1件)

Fixed
MCP
CLAUDE_CODE_SHELL_PREFIX 設定時に、引数にスペースやシェル特殊文字が含まれると MCP stdio サーバーが破損した引数を受け取ってしまう問題を修正
英語原文を表示
Fixed MCP stdio servers receiving corrupted arguments when CLAUDE_CODE_SHELL_PREFIX is set and an argument contains spaces or shell metacharacters

変更前

ロギングなどのためにシェルプレフィックスを使用している環境で、MCP サーバーを起動する際、スペースを含む複雑な引数が正しくエスケープされず、サーバーが正常に動作しないことがありました。

変更後

特殊文字を含む引数のクォーティング処理が改善され、プレフィックス使用時でも MCP サーバーへ正確に引数が渡されるようになります。

ユーザーへの恩恵

監査やデバッグのためにシェルをラップしている環境でも、MCP 連携を安定して利用できます。

関連ドキュメント

v1.0.61 (1件)

Added
Added CLAUDE_CODE_SHELL_PREFIX for wrapping Claude and user-provided shell commands run by Claude Code

関連ドキュメント