Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

モデルがリポジトリフォルダをパスから省略した場合にパス修正を提案するようにファイルが見つからないエラーを修正しました。

原文（英語） ​

Fixed file-not-found errors to suggest corrected paths when the model drops the repo folder

概要 ​

Claudeがファイルパスを指定する際にリポジトリのルートフォルダを省略してしまい、ファイルが見つからないエラーが発生するケースがありました。この修正により、ファイルが見つからない場合に正しいパスの候補を提案するようになります。例えば、src/utils.ts を指定すべきところを utils.ts と指定してしまった場合に、正しいパスを自動的に提示します。

基本的な使い方 ​

この修正は自動的に適用されます。ファイルが見つからない場合に、Claudeが修正パスを提案します。

bash
claude

# Claudeがパスを省略してファイルが見つからない場合の例
> utils.ts の関数一覧を教えて

# 修正前:
# エラー: ファイル 'utils.ts' が見つかりません

# 修正後:
# ファイル 'utils.ts' が見つかりません。
# もしかして: 'src/utils/utils.ts' または 'lib/utils.ts' でしょうか？

実践例 ​

ユースケース1: ネストされたディレクトリのファイルアクセス ​

深いディレクトリ構造でフォルダ名を省略してしまった場合。

bash
# リポジトリ構造:
# my-app/
# ├── src/
# │   └── components/
# │       └── Button.tsx

claude

# フォルダ名を省略したリクエスト
> Button.tsx コンポーネントのpropsを確認して

# 修正後の動作:
# 'Button.tsx' が見つかりません。
# 候補: 'src/components/Button.tsx'
# → Claudeが正しいパスを使って処理を続行

ユースケース2: モノレポでのファイルアクセス ​

モノレポ構成でパッケージ名を省略した場合。

bash
# モノレポ構造:
# monorepo/
# ├── packages/
# │   ├── api/
# │   │   └── src/
# │   │       └── index.ts
# │   └── web/
# │       └── src/
# │           └── index.ts

claude

> index.ts のエクスポートを確認して
# → 'index.ts' が複数の候補と共に見つかりました:
#   1. packages/api/src/index.ts
#   2. packages/web/src/index.ts
# → Claudeが文脈から適切なファイルを選択または確認

ユースケース3: テストファイルへのアクセス ​

テストディレクトリのパスを省略した場合。

bash
# プロジェクト構造:
# project/
# ├── __tests__/
# │   └── auth.test.ts
# ├── src/
# │   └── auth.ts

claude

> auth.test.ts を確認して最新のテストを把握したい
# → '__tests__/auth.test.ts' と 'src/__tests__/auth.test.ts' などの候補を提案
# → Claudeが正しいパスを特定して処理を続行

注意点 ​

  • この修正はClaudeがファイルパスを推測する際に適用されます。ユーザーが直接ファイルパスを指定した場合は影響しません。
  • パスの修正提案は、リポジトリ内の実際のファイル構造に基づいています。
  • 同名のファイルが複数存在する場合は、文脈から最も適切なファイルを選択するか、確認を求める場合があります。
  • この改善により、パス指定ミスによる作業の中断が減り、よりスムーズな作業体験が期待できます。

関連情報 ​