Два файла настроек
Claude Code имеет серьёзные возможности по настройке своего поведения - как он должен обрабатывать те или иные ситуации, как себя вести. За это отвечают два файла: settings.json и settings.local.json. По сути это обычные текстовые файлы, которые хранят настройки в формате JSON.
settings.json и settings.local.json
settings.json - это настройки, которые включаются в git-репозиторий. Здесь много разных настроек, которые могут пригодиться при переносе с компьютера на компьютер, поэтому их удобно вести в репозитории.
А файл settings.local.json важно НЕ включать в git-репозиторий (добавить в .gitignore). Это стандартная практика: локальные настройки - вне репозитория, а общий файл - в репозитории. При этом settings.local.json имеет больший приоритет перед обычным settings.json.
Что можно настроить
Всё поведение Claude Code настраивается в этих файлах. Открыть их можно в любом текстовом редакторе - внутри вы увидите настройки в формате JSON. Настроек очень много. Если перейти в документацию, в раздел Settings, можно посмотреть все доступные настройки для файла settings.json:
- какую модель использовать;
- настройки агентов;
- настройки разрешений (permissions) - для каких операций спрашивать разрешение, для каких не спрашивать;
- и многое другое - с описанием каждой настройки и значением по умолчанию.
Например, в разделе Permissions в документации есть таблица с возможными значениями - что разрешено, что не разрешено. По сути, в файле хранится объект настроек в виде ключ-значение, которые вы можете посмотреть в документации и выставить под себя. Рекомендую почитать эту инструкцию в документации и попробовать применить настройки.