Claude Code не видит файлы: 3 причины и починка в 2026 году

Почему вообще так происходит: одна общая причина за тремя частными

Это не поисковик по всему твоему компьютеру. Представь его как помощника, которого посадили работать за одним конкретным столом: он прекрасно видит и трогает всё, что лежит на этом столе, но не видит ничего в соседней комнате, пока ты сам не принесёшь туда нужное

Этим "столом" становится точка, откуда ты запустил сессию в самом начале работы. Всё внутри неё - видно. Всё снаружи - нет, пока ты не скажешь явно "принеси ещё вот это тоже"

Причина 1: сессия стартовала не в том месте на диске

Это самая частая причина, и проверить её проще всего

Куда нажать: посмотри в окне помощника на путь к рабочему месту - обычно он написан вверху окна или виден в самом начале переписки. Сравни его с тем, где реально лежит нужное (посмотри в Finder или Проводнике, в каком именно каталоге оно находится)

Что увидишь: если путь в окне - это не то же самое место (и не уровень выше него), причина найдена

Что это даёт: ты сразу понимаешь, почему помощник "не видит" содержимое - он физически сидит за другим столом

Я проверил это на собственной машине: создал тестовый каталог с содержимым внутри, а команду на чтение подал из совершенно другого места. Результат - будто ничего не существует, хотя оно лежит на диске

По моему прогону: команда ls project-a, поданная с относительным именем не из той точки старта, вернула "No such file or directory" (код завершения 1), а то же самое обращение по полному пути cat /private/tmp/.../cc-demo/project-a/main.txt в той же сессии сработало и вывело содержимое без единой правки самого содержимого

Что делать: попроси помощника переоткрыть сессию с правильной точки старта, либо назови нужное полным путём прямо в сообщении - оба способа чинят эту причину без единой новой настройки

Причина 2: нужное лежит по соседству, а не внутри

Реже, но тоже часто: искомое существует, находится на том же компьютере, но лежит рядом с текущим рабочим местом, а не внутри него - например, в соседнем каталоге с общими картинками или документами для нескольких задач сразу

Куда нажать: если ты знаешь точный адрес соседнего каталога, попроси помощника расширить видимость на него - в переписке есть команда, которая так и называется, "добавить папку", и после неё туда открывается доступ на чтение

Что увидишь: после этой команды содержимое соседнего каталога становится доступным точно так же, как содержимое основного рабочего места - всё в нём читается без ошибок

Что это даёт: тебе не нужно переносить или копировать что-либо между каталогами, достаточно один раз назвать второе место "своим" тоже

Я проверил ту же логику на своей тестовой связке из двух каталогов: содержимое подпапки физически лежало на диске всё это время, но пока к нему не обратились явным путём, в общей картине работы оно не участвовало - как коробка на антресоли, которая никуда не делась, но про неё просто не вспомнили

Что делать: если знаешь точный адрес нужного каталога - назови его целиком. Если не уверен, где именно лежит содержимое - сначала найди его через обычный поиск по компьютеру (Spotlight на Mac, поиск в Проводнике на Windows), скопируй адрес и вставь в сообщение

Если такая путаница с расположением у тебя не разовая, а происходит на каждой новой задаче - возможно, стоит один раз навести порядок в самой структуре, а не решать вопрос заново каждый раз: структура проекта для Claude Code: папки и файл CLAUDE.md

Причина 3: правило версионирования прячет содержимое

Третья причина технически тоньше первых двух, но встречается у тех, кто уже какое-то время ведёт историю изменений через систему версий (когда снимки прогресса сохраняются автоматически)

У части содержимого - обычно это пароли, ключи доступа или временный мусор сборки - стоит специальная пометка "мимо истории". Представь её как стикер "не трогать" на коробке: коробка физически стоит на той же полке, но её сознательно обходят стороной при уборке

Помощник по умолчанию уважает эту пометку и не показывает такое содержимое в общем списке, даже если оно лежит прямо в текущем рабочем месте

Куда нажать: если подозреваешь, что дело в этой пометке - спроси у помощника напрямую: "это случайно не помечено правилом .gitignore?". Ответ покажет, стоит ли пометка

Что увидишь: если пометка есть, помощник это подтвердит и назовёт документ, который её задаёт (обычно это отдельный файл с именем .gitignore, где построчно перечислены такие правила)

Что это даёт: ты понимаешь, что ничего не потерялось и не сломалось, а просто попало под общее правило "мимо", которое можно снять точечно для одной позиции

Я специально создал тестовую позицию с такой пометкой и проверил командой, которая показывает всё, что пропускается - она честно отметила её отдельным флагом, в отличие от обычных соседей рядом

Если ищешь более общий разбор сбоев в работе Claude, а не только эту тему - у меня есть отдельная карточка троблшута: Claude не работает: что проверить сначала

Что делать: попроси убрать конкретную позицию из-под этой пометки, назвав её имя прямо. Снимать пометку со всей истории разом не стоит - обычно она стоит специально ради безопасности паролей и ключей

Путь коротким словом или путь целиком - в чём разница на практике

Во всех трёх причинах решение сводится к одному и тому же приёму: назвать адрес полностью, а не сокращённо. На своей же тестовой связке я специально прогнал одну и ту же команду двумя разными способами, чтобы увидеть разницу своими глазами, а не поверить на слово

Короткое имя вроде project-a работает только тогда, когда точка старта сессии - прямо рядом с ним, в той же папке. Стоит сессии стартовать хотя бы уровнем выше или в стороне - то же самое короткое имя превращается в пустоту, как будто его никогда не существовало. Полный адрес, начинающийся с самого корня диска (/Users/... на Mac или C:\... на Windows), работает из любой точки одинаково - потому что в нём уже названо, где именно искать, а не предполагается, что помощник сам додумает

Практический вывод простой: если сомневаешься, работает ли короткое имя из текущей точки - назови адрес целиком. Скопировать полный адрес нужного файла можно прямо из Finder (правый клик по файлу, зажать Option - появится пункт "Скопировать как путь") или из Проводника Windows (Shift + правый клик - "Копировать как путь")

Как проверить у себя за одну минуту

Три коротких вопроса помогают понять, какая из причин твоя, без единой лишней проверки

Что показал файл до и после у меня самого: до того, как я назвал полный путь, команда из чужой папки выдавала ошибку "файл не найден" в каждом из повторов. После того, как я указал путь целиком - тот же самый файл прочитался с первой попытки, без единой правки самого файла

Что говорит официальная документация Anthropic

Прежде чем нести читателю чужой список причин, я сверил его с официальной страницей документации самой компании, которая делает Claude Code, а не поверил источнику на слово

По умолчанию Claude видит файлы только в той папке, из которой его запустили. Эта папка остаётся основной рабочей папкой сессии, пока ты не перенесёшь сессию командой /cd. Расширить доступ можно так: во время запуска - аргументом --add-dir, во время сессии - командой /add-dir, а для постоянной настройки - добавлением папки в additionalDirectories в файле настроек

Перевод дословной цитаты с официальной страницы документации Anthropic, снятой живым запросом 06.09.2026

Что я не стал брать у источника на веру

Перед тем как нести читателю чужой разбор причин, я проверил каждую на слово, а не взял формулировки как есть

Причина про "переключить настройку в файле settings.json" - названа неточно у источника. Метка, которая прячет файлы под правилом .gitignore, переключается в другом месте, чем указал источник - переключатель называется "Respect .gitignore in file picker" и находится в общем меню настроек самого приложения, а не в файле правил доступа. Я проверил это по официальному описанию настроек и по открытым обсуждениям самих разработчиков - расхождение реальное, и я исправил его в разделе про причину 3 выше

"Файлы из подпапок подтягиваются по требованию" - точнее назвать поведением помощника, а не техническим ограничением. У меня получилось воспроизвести именно это: файл в подпапке никуда не делся и был доступен по прямому запросу, но пока никто не попросил его прочитать - он просто не участвовал в разговоре. Это не похоже на запрет, скорее на то, что помощник не читает бумаги в ящике стола, пока его не попросили открыть именно этот ящик

Процент "решаемости" одним универсальным способом - не гарантия для любого случая. У меня все три причины подтвердились и починились способами из этой статьи, но на более сложных проектах (общие сетевые диски, необычные настройки прав доступа) причина может быть глубже, чем три базовых случая

Если ни одна из трёх причин не подошла: два редких, но реальных случая

Три причины выше закрывают подавляющее большинство обращений. Но по официальной документации, которую я сверял для этой статьи (см. раздел выше), есть ещё два случая - реже, но встречаются у тех, кто уже настраивал права доступа вручную

Первый - явный запрет на чтение конкретной позиции. В настройках можно один раз прописать правило, которое навсегда закроет помощнику доступ к определённому файлу или маске файлов (например, ко всем файлам с паролями) - это ставится осознанно самим человеком или тем, кто настраивал компьютер, а не возникает само по себе. Если подозреваешь это - спроси помощника прямо: "у тебя стоит запрет на чтение этого файла?"

Второй - общий запрет на чтение чего угодно за пределами текущего рабочего места, поставленный на уровне всей системы. Это более строгий вариант первой причины из этой статьи: там ты просто не сказал помощнику про вторую папку, а здесь read-доступ за пределы текущего места физически заблокирован настройкой, и обычная команда "добавить папку" его не откроет - нужно менять саму настройку запрета

Оба случая встречаются заметно реже трёх основных и обычно стоят там, где над правами доступа уже кто-то работал специально - случайно они не появляются

Шпаргалка: что сказать помощнику под каждую причину

Три причины разные, но у каждой есть одна короткая фраза, с которой стоит начать разговор с помощником, чтобы не тратить время на объяснения по кругу

Ни одна из трёх фраз не требует технического жаргона сверх того, что здесь написано - назвать причину своими словами и дать точный адрес

Тонкая грань: своя папка "Заметки" и общий проект - разные вещи

Если ты используешь Claude Code не только для кода, но и для того, чтобы попросить его создать документ Word или таблицу Excel прямо в переписке - это отдельная функция, никак не связанная с видимостью файлов на твоём диске. Она разобрана отдельно: Claude создаёт файлы Word и Excel: 4 формата без установки. Если тебе нужно именно ЭТО - сгенерировать документ внутри чата, а не дать Claude Code увидеть уже существующий файл на компьютере - тебе туда, а не сюда

Похожие сбои того же корня

"Не видит файлы" - только один из класса сбоев, где Claude Code ведёт себя не так, как ждёшь. У остальных свои причины и свои разборы, если попал именно туда

Если Claude Code, наоборот, СНОВА и снова перечитывает один и тот же файл проекта без явной просьбы - это обратная сторона той же темы про рабочую папку, разобрана отдельно: Claude Code перечитывает проект: 3 причины и карта на 4 строки. Если он делает не то, что ты просил, хотя файл нашёл правильно - смотри Claude делает не то, что просил: 6 причин и как исправить. Если вместо ответа он засыпает уточняющими вопросами - вот отдельная строка в CLAUDE.md, которая это лечит: Claude достал вопросами: 1 строка в CLAUDE.md, 3 прогона

Если проблема не с файлами, а с самим доступом - просит войти заново или упирается в лимит сообщений - это уже не про видимость файлов, а про сессию и подписку: Claude просит войти заново: 9 причин и что делать в 2026, Лимит сообщений в Claude: как работать весь день без стопа

Если ты только начал ставить Claude Code и файлы не видны с самого первого запуска - вероятно, дело в самой установке, а не в папках: Claude Code установка из России: скачать, оплатить подписку Pro и Max, для Windows отдельно - Claude Code Windows: одна команда установки, разбор 7 ошибок

Что почитать дальше про Claude Code

• Настройка Claude Code бесплатно: запуск с нуля - если Claude Code у тебя ещё не установлен
• Claude создаёт файлы Word и Excel: 4 формата без установки - если нужно не найти существующий файл, а создать новый прямо в переписке
• Claude не работает: что проверить сначала - более общий разбор сбоев, если дело не в файлах
• CLAUDE.md: памятка для ИИ, 4 прогона и замок на важное - как закрепить постоянные правила проекта, чтобы Claude Code сам их помнил
• Как экономить токены в Claude: рабочие приёмы и настройки - если после починки доступа хочешь ещё и ускорить саму работу
• Команды Claude Code: 4 добавки, чтобы он делал с первого раза - если хочешь формулировать задачи точнее
• Агент Claude разбирает почту: 5 правил безопасности в 2026 году - другой пример того, как Claude Code получает доступ к внешним данным по явному разрешению
• Claude MCP: как подключить свой первый сервис за 10 минут - если хочешь расширить возможности Claude Code сервисами
• Cursor или Claude Code в 2026 году: разница в 6 раз на тесте - если сравниваешь инструменты между собой
• Claude Artifacts: 4 шага до своего калькулятора со ссылкой - другой способ показать готовый результат без файлов на диске
• Claude Code с телефона: включаем Remote Control за 3 шага - если хочешь работать с тем же проектом не с компьютера
• Авторежим Claude Code с 14 августа: что изменилось и как выключить - если после обновления поведение агента вообще изменилось
• Claude Code в 2026 году: 8 обновлений за неделю, что включить - если давно не проверял, что нового появилось в самом инструменте
• Тема: Claude Code - больше разборов про доступ, установку и настройку Claude Code

Источники

Anthropic - официальная документация, снята живым запросом 06.09.2026; собственный прогон автора на трёх причинах в тестовой песочнице, 06.09.2026; открытые обсуждения разработчиков Anthropic про настройку видимости файлов

• Anthropic: Configure permissions - официальная документация, раздел про рабочие папки
• Anthropic: Working directories - тот же документ, раздел про working directory boundary дословно
• Anthropic: Claude Code settings - официальная документация про файлы настроек и additionalDirectories
• GitHub Anthropic: доступ к файлам под .gitignore - открытое обсуждение разработчиков про эту настройку
• GitHub Anthropic: баг настройки "Respect .gitignore in file picker" - подтверждение, где реально живёт эта настройка

Памятка перед следующей жалобой "не вижу файл"

Три вопроса, которые стоит держать перед глазами

Частые вопросы