Claude Windows パス問題｜where claude と PATH 通し方

Windows で言う「パス」は 2 種類ある

Claude 周りでの「パス」相談は、ほぼ確実に次のどちらかに分類されます。

1. 環境変数 PATH — claude を叩いたとき、OS がどのディレクトリから実行ファイルを探すかのリスト。「claude は内部コマンドまたは外部コマンド…として認識されていません」というエラーはここの問題。
2. 設定ファイル内のファイルパス — claude_desktop_config.json や Claude Code の settings.json に書く、ワークスペース・実行コマンド・認証鍵などの絶対パス。MCP サーバーが failed で止まる原因はほぼここに集中。

この 2 つは根本的に別物で、対処手段も違います。本記事では前半で環境変数 PATH、後半で設定ファイル内のファイルパスを扱います。インストール手順そのものは Claude を Windows にインストール、MCP 全体の流れは Claude Windows MCP 設定 を先に読むと、本記事の各節がそのまま頭に入ります。

claude.exe の実体はインストール経路で決まる

claude が見つからないときは、まず実体ファイルがどこにあるかを把握します。公式 Setup ページに記載されたインストール経路ごとの典型パスは次のとおりです。

ネイティブインストールでは本体データが %USERPROFILE%\.local\share\claude\ に展開され、claude.exe はそれを呼び出す薄いラッパーです。npm 経由なら npm config get prefix の出力 + \claude.exe が実体になります。複数経路で重複インストールしていると PATH の並び順次第でどちらが優先されるかが変わり、片方を更新したつもりが古い claude.exe を使い続ける混乱が起きるため、後述の where claude で一度棚卸ししてから不要なものを削除しておくのが安全です。

where claude で実体と PATH 反映を確認する

「いま叩いている claude の実体はどれか」を調べるコマンドは Windows でも揃っています。

# 旧来からある where(複数ヒットも一覧表示される)
where claude

# PowerShell 標準。バージョンや拡張子も同時に取れる
Get-Command claude | Select-Object Source, Version

# どこから読み込まれた PATH かの全体像
$env:Path -split ';'

where claude が 何も返さない なら PATH が通っていないことが確定します。逆に 複数行ヒット したら PATH に並んだ順で先頭のものが使われるため、意図しない経路(古い npm グローバル等)が優先されていないか確認してください。Mac/Linux の which claude に相当する操作で、Windows でつまずく人はだいたいここで止まります。トラブル時にいきなり再インストールに走るより、まずこの 3 行で状態を把握するのが最短距離です。

PATH が通っていない時の永続追加手順

where claude が空振りした場合、実体は存在するのに PATH に登録されていない状態です。Windows ではユーザー環境変数に追加するのが基本で、手順は次のとおりです。

1. 実体ディレクトリを特定する(ネイティブなら %USERPROFILE%\.local\bin、npm なら npm config get prefix の出力)。エクスプローラーで開き claude.exe の実在を目視確認しておく。
2. 以下を 管理者権限なしの PowerShell で実行してユーザー PATH 先頭に追加する。
3. 既存のターミナル・VS Code を すべて閉じてから開き直す(環境変数は新セッションで初めて反映される)。
4. where claude を再実行し、想定位置がヒットすることを確認する。

$Path = [Environment]::GetEnvironmentVariable('Path', 'User')
$NewPath = "$env:USERPROFILE\.local\bin;$Path"
[Environment]::SetEnvironmentVariable('Path', $NewPath, 'User')

GUI から追加する場合は、Win + X →「システム」→「詳細情報」→「システムの詳細設定」→「環境変数」で、ユーザー環境変数の Path を編集し新規行に実体ディレクトリを追加します。システム環境変数(Machine) は管理者権限が要り影響範囲も広いため、共有 PC で全員に使わせる場合だけ選択してください。複数バージョンを使い分けたい・特定の claude.exe を必ず呼びたい用途なら、PATH を触らず PowerShell プロファイル($PROFILE)に Set-Alias -Name claude -Value "$env:USERPROFILE\.local\bin\claude.exe" -Force を書く方法も使えます。

OneDrive 配下のホームで起きる「同じパスのはずなのに失敗」

Windows 11 を Microsoft アカウントでセットアップすると、Documents や Desktop が C:\Users\<name>\OneDrive\Documents などに自動リダイレクトされています。エクスプローラーの「Documents」からドラッグして得たパスと、実体パスがずれていることが、MCP のフォルダ指定で頻発するつまずきです。

実体は PowerShell で確実に取得できます。

# Documents の実体パス
[Environment]::GetFolderPath('MyDocuments')

# 任意フォルダの実体(シンボリックリンク・OneDrive リダイレクトを解決)
Resolve-Path "$env:USERPROFILE\Documents"

claude_desktop_config.json や settings.json に貼り付けるパスは、この出力をそのままコピーしてください。さらに OneDrive の ファイルオンデマンド が有効だと、見えているだけで実体は雲の上 — このとき MCP サーバーはファイルを開けず失敗します。対象フォルダを右クリックし「このデバイス上で常に保持する」に切り替えると解消します。

設定ファイル内の Windows パスは \\ か / で書く

claude_desktop_config.json の MCP サーバー定義や、Claude Code の settings.json(位置は %USERPROFILE%\.claude\settings.json)に Windows パスを書くとき、JSON エスケープの崩壊がよく起きます。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\YourName\\Projects"
      ]
    }
  },
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

ポイントは 2 つです。1 つめは バックスラッシュは必ず \\ の 2 個重ね(JSON 仕様)。\U や \P などはエスケープエラーになります。2 つめは 空白を含むパスはそのままで OK で、JSON 文字列の中ではダブルクォートで括られているため C:\\Program Files\\... を引用符で囲い直す必要はありません。/ 区切りでも Windows API は受け付けるため、可読性を上げたいなら "C:/Users/YourName/Projects" でも問題なく動きます。OneDrive 配下を渡すときは前節の Resolve-Path 出力をベースに \\ 化するのが事故が起きにくい流儀です。

CLAUDE_CODE_GIT_BASH_PATH は Git for Windows の bash.exe を Claude Code に明示する設定で、自動検出に失敗した場合のみ追加します。Git for Windows が未インストールなら自動で PowerShell がシェルになるため、本設定は不要です。

claude doctor でまとめて健全性チェック

ここまでのパス周り全般を一発で点検できるのが claude doctor です。

claude doctor

このコマンドは claude.exe の実体位置と PATH 反映状況、認証トークン(%USERPROFILE%\.claude\ 配下)、依存ツール(ripgrep 等)の解決、shell の種類(PowerShell / Git Bash / CMD)とバージョンを一覧で出してくれます。where claude で実体が確認できているのに動作がおかしいときは、claude doctor の出力を最初に見ると、認証切れや依存欠落など PATH 以外の真因に短時間でたどり着けます。claude doctor が「command not found」になる時点で PATH が通っていないので、前出の「PATH が通っていない時の永続追加手順」に戻ってください。

よくある質問(FAQ)

Q. claude と claude.exe のどちらで叩く? A. PowerShell でも CMD でも、PATH に通っていれば拡張子なしの claude で動きます。claude.exe と書いても等価で、エイリアスを別途設定したい場合のみ Set-Alias で実体ファイルを指してください。

Q. インストール経路を変えたら古い claude が残ってしまった。 A. where claude で複数ヒットしたら、不要な経路をアンインストールするのが最短です。npm 経由なら npm uninstall -g @anthropic-ai/claude-code、ネイティブ残骸なら Remove-Item "$env:USERPROFILE\.local\bin\claude.exe" で実体を消し、PATH からも該当ディレクトリを外します。

Q. WSL の claude と Windows ネイティブの claude を同居させたい。 A. 同居自体は可能です。WSL 内の claude は WSL の $PATH、Windows 側は前述の Windows PATH と独立しているため衝突しません。VS Code から呼ぶ場合のみ、ターミナルが WSL か PowerShell かで挙動が変わる点に注意してください。

関連記事

• Claude を Windows にインストール｜Desktop と Code の選び方
• Claude Code Windows の使い方｜WSL・WinGet 3 経路の設定方法
• Claude Windows MCP 設定｜config.json と OneDrive 対策の手順

出典

• Anthropic Claude Code Setup(%USERPROFILE%\.local\bin\claude.exe 等のインストール先、claude doctor、CLAUDE_CODE_GIT_BASH_PATH): https://code.claude.com/docs/en/setup
• Microsoft Learn — $PROFILE PowerShell プロファイル: https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_profiles
• Microsoft Learn — Environment.GetFolderPath メソッド(OneDrive リダイレクト対応): https://learn.microsoft.com/en-us/dotnet/api/system.environment.getfolderpath