settings.json в Claude Code: где лежит и что писать

Где лежит файл и почему его может не быть

Запрос «claude нету settings.json» описывает штатную ситуацию: файл не появляется сам. Пока вы ничего не настраивали, его просто нет, и это не поломка

1. Личные настройки, действуют во всех проектах:

   ~/.claude/settings.json

2. Настройки проекта, едут в репозиторий вместе с кодом:

   .claude/settings.json

3. Локальные настройки проекта, в репозиторий не попадают:

   .claude/settings.local.json

На Windows домашняя папка ~/.claude разворачивается в %USERPROFILE%\.claude. Отсюда и запрос про указание модели в settings.json на Windows: путь другой, содержимое то же

Порядок, в котором файлы перебивают друг друга

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

1. Управляемые настройки организации (перекрыть нельзя)
2. Аргументы командной строки
3. .claude/settings.local.json
4. .claude/settings.json
5. ~/.claude/settings.json

Что в него писать

Ключей верхнего уровня немного, и половину вы не тронете никогда. Рабочий минимум выглядит так

{
  "model": "sonnet",
  "permissions": {
    "allow": ["Bash(npm run lint)"],
    "deny": ["Read(.env)"]
  },
  "env": { "MY_VAR": "1" },
  "hooks": { }
}

model задаёт модель по умолчанию, permissions разрешает и запрещает конкретные действия, env добавляет переменные окружения сессии, hooks подключает скрипты на события

Поправить одну настройку можно не открывая файл: /config key=value работает начиная с версии 2.1.181, а просто /config открывает настройки списком

Для ориентира: в моём личном файле сейчас 11 ключей верхнего уровня и 6 разных событий в блоке хуков. Это уже сильно больше среднего, начинать стоит с двух-трёх

Связанные гайды