Настройки Claude Code

Claude Code предлагает множество настроек для конфигурации своего поведения в соответствии с вашими потребностями. Вы можете настроить Claude Code, выполнив команду /config при использовании интерактивного REPL.

​

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

Файл settings.json является нашим официальным механизмом для настройки Claude Code через иерархические настройки:

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

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

​

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

settings.json поддерживает ряд опций:

​

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

​

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

Настройки применяются в порядке приоритета:

1. Корпоративные политики (см. документацию IAM)
2. Аргументы командной строки
3. Локальные настройки проекта
4. Общие настройки проекта
5. Пользовательские настройки

​

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

Claude Code поддерживает следующие переменные окружения для управления своим поведением:

​

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

Мы находимся в процессе миграции глобальной конфигурации в settings.json.

claude config будет устаревшим в пользу settings.json

Для управления вашими конфигурациями используйте следующие команды:

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

По умолчанию config изменяет конфигурацию вашего проекта. Для управления глобальной конфигурацией используйте флаг --global (или -g).

​

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

Для установки глобальной конфигурации используйте claude config set -g <key> <value>:

​

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

Claude Code имеет доступ к набору мощных инструментов, которые помогают ему понимать и изменять вашу кодовую базу:

Правила разрешений могут быть настроены с помощью /allowed-tools или в настройках разрешений.

​

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

Вы можете запускать пользовательские команды до или после выполнения любого инструмента, используя хуки Claude Code.

Например, вы можете автоматически запускать форматировщик Python после того, как Claude изменит файлы Python, или предотвратить изменения в файлах конфигурации продакшена, блокируя операции Write для определенных путей.

​

См. также

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