Claude Code ガイド

Appearance

[VSCode] Windowsでのgit-bash偽陽性エラーの修正 ​

原文（日本語に翻訳） ​

[VSCode] CLAUDE_CODE_GIT_BASH_PATH が設定されているか、Git がデフォルトの場所にインストールされている場合に Windows で表示される「git-bash が必要です」という偽陽性エラーを修正しました。

原文（英語） ​

[VSCode] Fixed false-positive "requires git-bash" error on Windows when CLAUDE_CODE_GIT_BASH_PATH is set or Git is installed at a default location

概要 ​

Windows の VSCode 統合ターミナルで Claude Code を使用している場合、Git for Windows が正しくインストールされているにもかかわらず「git-bash が必要です」というエラーが表示される問題が修正されました。CLAUDE_CODE_GIT_BASH_PATH 環境変数を設定している場合や、Git がデフォルトのパス（C:\Program Files\Git\bin\bash.exe など）にインストールされている場合に発生していた偽陽性エラーが解消されます。

基本的な使い方 ​

この修正適用後は、以下の条件のいずれかを満たしていれば、エラーなしに Claude Code が動作するようになります。

powershell
# 方法 1: CLAUDE_CODE_GIT_BASH_PATH 環境変数を設定
# Windows の設定 → システム → 詳細設定 → 環境変数 で設定
CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe

# 方法 2: Git for Windows をデフォルトの場所にインストール
# デフォルトインストールパス: C:\Program Files\Git\
# インストール後、VSCode で Claude Code を起動

実践例 ​

Git for Windows のデフォルトインストールでの使用 ​

Git for Windows をデフォルト設定でインストールしている場合、追加設定なしに Claude Code が動作するようになります。

powershell
# Git のデフォルトインストールパスを確認
where git
# 出力例: C:\Program Files\Git\cmd\git.exe

# VSCode のターミナルで Claude Code を起動
claude
# 修正前: "requires git-bash" エラーが表示される場合があった
# 修正後: エラーなしに起動する

CLAUDE_CODE_GIT_BASH_PATH を使ったカスタムパスの指定 ​

Git を非標準のパスにインストールしている場合は、環境変数でパスを指定します。

powershell
# PowerShell でユーザー環境変数を設定
[System.Environment]::SetEnvironmentVariable(
    "CLAUDE_CODE_GIT_BASH_PATH",
    "D:\Tools\Git\bin\bash.exe",
    "User"
)

# VSCode を再起動して環境変数を反映
# その後 Claude Code を起動
claude
# 修正後: カスタムパスが正しく認識されてエラーなしに動作

VSCode の settings.json での設定 ​

VSCode の統合ターミナルの設定で環境変数を追加する方法もあります。

json
// .vscode/settings.json または ユーザー設定
{
  "terminal.integrated.env.windows": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

問題が解決しない場合の確認手順 ​

修正後も問題が発生する場合は、以下を確認してください。

powershell
# 1. Git for Windows がインストールされているか確認
git --version
# 出力例: git version 2.43.0.windows.1

# 2. bash.exe のパスを確認
Get-Item "C:\Program Files\Git\bin\bash.exe"
# または
Get-Item "C:\Program Files (x86)\Git\bin\bash.exe"

# 3. 環境変数が正しく設定されているか確認
$env:CLAUDE_CODE_GIT_BASH_PATH

注意点 ​

  • この修正は Windows 上の VSCode 統合ターミナルでの使用に限定されます。macOS や Linux には適用されません。
  • Git for Windows のインストール後、VSCode の再起動が必要な場合があります。
  • 会社のポリシーで Git のインストール先が制限されている場合は、CLAUDE_CODE_GIT_BASH_PATH で正確なパスを指定してください。
  • WSL（Windows Subsystem for Linux）上で Claude Code を実行している場合は、この問題の影響を受けません。

関連情報 ​