Настройки 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/policies.json на macOS и /etc/claude-code/policies.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
• IAM и контроль доступа - Управление корпоративными политиками
• Устранение неполадок - Решения для распространенных проблем конфигурации