Claude Codeでファイルが見つからない｜Windowsのパスを確認する順番

Claude Codeで「ファイルが見つからない」と言われたら、まず対象が本当に存在する場所と、処理を実行している場所をそろえます。日本語のフォルダー名やOneDriveを使っているという理由だけでは、原因は確定しません。移動や名前変更の前に、読み取りだけで切り分けましょう。

相対パスの起点を確認する

「資料/議事録.txt」のような指定は、通常、その処理の作業フォルダーを基準に解決されます。エディターで開いている場所と、コマンドの起点が違う場合もあります。実行した端末でGet-Locationを確認し、対象を絶対パスで指定した場合にも失敗するかを調べます。

Get-Location
$targetFile = 'C:\Work\sample folder\memo.txt'
Test-Path -LiteralPath $targetFile -PathType Leaf
Get-Item -LiteralPath $targetFile | Select-Object Name,Length,Attributes

ここにあるパスは説明用です。自分が読み取りを許可されている検証ファイルへ置き換えます。LiteralPathは指定をワイルドカードとして解釈しないため、角括弧などを含む名前をそのまま扱いたいときに役立ちます。Falseなら、まだファイル本文やAIの指示内容を調べる段階ではありません。

症状を四つに分ける

観測した状態	次の確認
絶対パスなら見つかる	実行フォルダーと相対パスの起点
存在するが読み取りで拒否される	アクセス権、アプリの許可範囲、実行ユーザー
空白の手前でパスが切れる	使っているシェルに合う引用符
同期アプリでは見えるが処理で開けない	ローカルで開ける状態か、同期エラーがないか

同期フォルダーの属性だけで故障を断定することはできません。まずエクスプローラーからそのファイルを開けるか、同期アプリにエラーが出ていないかを確かめます。必要なら、機密情報を含まない一つのサンプルを別の作業フォルダーへコピーして比較します。元のフォルダーを丸ごと移動する前に、変更の影響を小さくできます。

PowerShell・Git Bash・WSLを混ぜない

公式セットアップでは、Claude CodeはWindowsネイティブとWSLで利用できます。同じWindows PCでも、WSL内ではLinux側のパス表記を使う場面があります。Windowsのドライブ表記をそのままLinuxのコマンドへ渡すなど、別環境の書き方を混ぜていないか確認してください。

手順を共有するときは「Windowsだから」だけでなく、実際に使用したシェル名を添えます。スペースを含むパスを扱う例も、PowerShell用とBash用を一つのコード欄に混ぜない方が再現しやすくなります。この記事の確認コマンドはPowerShell用です。

原因が分かったら、業務の入口を固定する

毎回違うフォルダーから実行する運用なら、起動手順に対象プロジェクトの場所を明記します。入力フォルダー、出力フォルダー、一時ファイルの置き場も分けておくと、AIが作った成果物を探す手間を減らせます。これは文字コードやモデルの変更とは別の改善です。

対象業務：
実行するシェル：
開始するフォルダー：
入力ファイルの指定方法：
出力の保存先：
存在確認の結果：
読み取り確認の結果：
変更した点／まだ不明な点：

「別フォルダーでは成功した」という結果から分かるのは、環境差が関係する可能性までです。日本語、同期、権限、相対パスのどれが原因かは追加確認が必要です。断定せず記録を残す方法は、エラーログの共有テンプレートで整理できます。

確認に使った資料

• Anthropic：Claude CodeのWindowsセットアップ
• Microsoft：環境変数とプロセス