settings.json и settings.local.json: настройка поведения

📖 Теория

В этом уроке мы рассмотрим, как управлять поведением AI-агента Claude Code с помощью конфигурационных файлов. Эти файлы позволяют вам установить глобальные и локальные настройки, которые влияют на то, как Claude будет взаимодействовать с вами и вашими проектами.

settings.json и settings.local.json

• settings.json: глобальный файл настроек, который применяется ко всем проектам и пользователям. Он определяет общие параметры, такие как уровень логирования, предустановленные хуки и разрешения.
• settings.local.json: персональный файл настроек, который позволяет каждому пользователю настроить свое взаимодействие с Claude. Это может включать индивидуальные команды, предпочтения по безопасности и другие пользовательские настройки.
• .claude/settings.json: проектный файл настроек, который позволяет вам управлять поведением Claude в контексте конкретного проекта. Это полезно для настройки специфических задач или команд, которые требуются только в рамках данного проекта.

🛠 Практика

Шаг 1. Откройте терминал и создайте файл settings.json в вашем домашнем каталоге. Этот файл будет глобальным и будет применяться ко всем вашим проектам.

{
  "logLevel": "info",
  "hooks": {
    "auto-submit": true,
    "auto-accept": false
  },
  "permissions": {
    "access": ["read", "write"]
  }
}

Шаг 2. Теперь создайте файл settings.local.json в вашем домашнем каталоге для индивидуальных настроек.

{
  "customCommands": [
    "my-custom-command"
  ],
  "security": {
    "enableEncryption": true
  }
}

Шаг 3. Перейдите в ваш проект и создайте файл .claude/settings.json для проектных настроек.

{
  "projectSpecificSetting": "value",
  "hooks": {
    "customHook": "myCustomFunction"
  }
}

Шаг 4. После создания всех файлов, запустите Claude и проверьте, применяются ли ваши настройки. Для этого введите команду /settings в терминале.

/settings

📝 Домашнее задание

🎓 После урока вы умеете

• Создавать и редактировать файлы настроек для Claude Code, включая глобальные и локальные.
• Настраивать поведение AI-агента с помощью различных параметров.
• Использовать проектные настройки для оптимизации работы в конкретных проектах.
• Проверять применяемые настройки и вносить изменения по мере необходимости.