Настройки 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 мы также поддерживаем настройки корпоративной управляемой политики. Они имеют приоритет над пользовательскими настройками и настройками проекта. Системные администраторы могут развертывать политики в:
  • 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"
  }
}

​

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

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

​

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

​

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

Настройки применяются в порядке приоритета (от высшего к низшему):

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 дополнительными инструментами и интеграциями
• Приоритет: Конфигурации более высокого уровня (Корпоративные) переопределяют конфигурации более низкого уровня (Пользователь/Проект)
• Наследование: Настройки объединяются, при этом более специфичные настройки добавляются к более общим или переопределяют их

​

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

​

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

Чтобы предотвратить доступ Claude Code к файлам, содержащим чувствительную информацию (например, API ключи, секреты, файлы окружения), используйте настройку permissions.deny в вашем файле .claude/settings.json:

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

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

​

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

Claude Code поддерживает пользовательских AI субагентов, которые могут быть настроены как на уровне пользователя, так и на уровне проекта. Эти субагенты хранятся как Markdown файлы с YAML frontmatter:

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

Файлы субагентов определяют специализированных AI помощников с пользовательскими промптами и разрешениями инструментов. Узнайте больше о создании и использовании субагентов в документации по субагентам.

​

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

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

​

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

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

• Список настроек: 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 и контроль доступа - Управление корпоративными политиками
• Устранение неполадок - Решения для распространенных проблем конфигурации