Настройки Claude Code

​

Файлы настроек

• Пользовательские настройки определяются в ~/.claude/settings.json и применяются ко всем проектам.
• Настройки проекта сохраняются в директории вашего проекта:
  • .claude/settings.json для настроек, которые включаются в систему контроля версий и делятся с вашей командой
  • .claude/settings.local.json для настроек, которые не включаются в систему контроля версий, полезно для личных предпочтений и экспериментов. Claude Code настроит git на игнорирование .claude/settings.local.json при его создании.
• Для корпоративных развертываний Claude Code мы также поддерживаем корпоративные управляемые настройки политики. Они имеют приоритет над пользовательскими настройками и настройками проекта. Системные администраторы могут развертывать политики в:
  • macOS: /Library/Application Support/ClaudeCode/managed-settings.json
  • Linux и WSL: /etc/claude-code/managed-settings.json
  • Windows: C:\ProgramData\ClaudeCode\managed-settings.json

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

​

Доступные настройки

​

Настройки разрешений

​

Приоритет настроек

1. Корпоративные управляемые политики (managed-settings.json)
   • Развертываются IT/DevOps
   • Не могут быть переопределены
2. Аргументы командной строки
   • Временные переопределения для конкретной сессии
3. Локальные настройки проекта (.claude/settings.local.json)
   • Личные настройки конкретного проекта
4. Общие настройки проекта (.claude/settings.json)
   • Настройки проекта, общие для команды в системе контроля версий
5. Пользовательские настройки (~/.claude/settings.json)
   • Личные глобальные настройки

​

Ключевые моменты о системе конфигурации

• Файлы памяти (CLAUDE.md): Содержат инструкции и контекст, которые Claude загружает при запуске
• Файлы настроек (JSON): Настраивают разрешения, переменные окружения и поведение инструментов
• Слэш-команды: Пользовательские команды, которые могут быть вызваны во время сессии с помощью /command-name
• MCP серверы: Расширяют Claude Code дополнительными инструментами и интеграциями
• Приоритет: Конфигурации более высокого уровня (Корпоративные) переопределяют конфигурации более низкого уровня (Пользователь/Проект)
• Наследование: Настройки объединяются, при этом более специфичные настройки добавляются к более широким или переопределяют их

​

Доступность системного промпта

​

Исключение чувствительных файлов

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Read(./build)"
    ]
  }
}

​

Конфигурация субагентов

• Пользовательские субагенты: ~/.claude/agents/ - Доступны во всех ваших проектах
• Субагенты проекта: .claude/agents/ - Специфичны для вашего проекта и могут быть переданы вашей команде

​

Переменные окружения

​

Опции конфигурации

• Список настроек: claude config list
• Посмотреть настройку: claude config get <key>
• Изменить настройку: claude config set <key> <value>
• Добавить к настройке (для списков): claude config add <key> <value>
• Удалить из настройки (для списков): claude config remove <key> <value>

​

Глобальная конфигурация

​

Инструменты, доступные Claude

​

Расширение инструментов с помощью хуков

​

См. также

• Управление идентификацией и доступом - Узнайте о системе разрешений Claude Code
• IAM и контроль доступа - Управление корпоративными политиками
• Устранение неполадок - Решения для общих проблем конфигурации