環境変数

CLAUDE_CODE_SHELL

Bash ツールコマンドを実行するために Claude Code が使うシェルを設定する。例えば /opt/homebrew/bin/bash のような bash または zsh バイナリのパスを受け付ける。fish など他のシェルはサポートされない。値が動作する bash または zsh のパスでない場合、Claude Code はそれを無視して自動検出にフォールバックする。自動検出は、$SHELL が bash または zsh を指していればそれを使い、そうでなければ PATH および標準的なインストール場所で最初に見つかった動作する zsh、次に bash を選ぶ。

使い方・用途

  • ログインシェルと実際に作業で使うシェルが異なる環境で、Bash ツールが使用するシェルを明示的に指定したい場合に使う
  • 自動検出が意図しないシェルを選ぶ環境で、Homebrew などでインストールした bash や zsh へのパスを指定してシェルを固定したい場合に使う
英語原文(公式ドキュメントより)

Set the shell Claude Code uses to run Bash tool commands. Accepts a path to a bash or zsh binary, for example /opt/homebrew/bin/bash. Other shells such as fish are not supported. If the value is not a working bash or zsh path, Claude Code ignores it and falls back to auto-detection. Auto-detection uses your $SHELL when it points to bash or zsh, otherwise it picks the first working zsh then bash found on your PATH and standard install locations

関連する変更履歴

v2.1.128(1件)

Fixed
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 連携を安定して利用できます。

関連ドキュメント

v2.0.65(1件)

Added
Added CLAUDE_CODE_SHELL environment variable to override automatic shell detection (useful when login shell differs from actual working shell)

関連ドキュメント

v1.0.61(1件)

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

関連ドキュメント