Параметры 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
• Корпоративные развертывания также могут настраивать управляемые серверы MCP, которые переопределяют серверы, настроенные пользователем. См. Конфигурация MCP предприятия:
  • macOS: /Library/Application Support/ClaudeCode/managed-mcp.json
  • Linux и WSL: /etc/claude-code/managed-mcp.json
  • Windows: C:\ProgramData\ClaudeCode\managed-mcp.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"
  },
  "companyAnnouncements": [
    "Welcome to Acme Corp! Review our code guidelines at docs.acme.com",
    "Reminder: Code reviews required for all PRs",
    "New security policy in effect"
  ]
}

​

Доступные параметры

​

Параметры разрешений

​

Параметры изоляции

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker"],
    "network": {
      "allowUnixSockets": [
        "/var/run/docker.sock"
      ],
      "allowLocalBinding": true
    }
  },
  "permissions": {
    "deny": [
      "Read(.envrc)",
      "Read(~/.aws/**)"
    ]
  }
}

• Правила отказа Read блокируют чтение файлов в изоляции
• Правила разрешения Edit разрешают запись файлов (в дополнение к значениям по умолчанию, например текущему рабочему каталогу)
• Правила отказа Edit блокируют запись в разрешенные пути

• Правила разрешения WebFetch разрешают сетевые домены
• Правила отказа WebFetch блокируют сетевые домены

​

Приоритет параметров

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

​

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

​

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

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

​

Конфигурация подагента

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

​

Конфигурация плагинов

​

Параметры плагинов

{
  "enabledPlugins": {
    "formatter@company-tools": true,
    "deployer@company-tools": true,
    "analyzer@security-plugins": false
  },
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": "github",
      "repo": "company/claude-plugins"
    }
  }
}

​

enabledPlugins

• Параметры пользователя (~/.claude/settings.json): Личные предпочтения плагинов
• Параметры проекта (.claude/settings.json): Плагины, специфичные для проекта, совместно используемые с командой
• Локальные параметры (.claude/settings.local.json): Переопределения для каждой машины (не зафиксированы)

{
  "enabledPlugins": {
    "code-formatter@team-tools": true,
    "deployment-tools@team-tools": true,
    "experimental-features@personal": false
  }
}

​

extraKnownMarketplaces

1. Членам команды предлагается установить маркетплейс при доверии папке
2. Затем членам команды предлагается установить плагины из этого маркетплейса
3. Пользователи могут пропустить нежелательные маркетплейсы или плагины (сохранено в параметрах пользователя)
4. Установка соблюдает границы доверия и требует явного согласия

{
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": {
        "source": "github",
        "repo": "company-org/claude-plugins"
      }
    },
    "security-plugins": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/security/plugins.git"
      }
    }
  }
}

• github: Репозиторий GitHub (использует repo)
• git: Любой URL git (использует url)
• directory: Путь локальной файловой системы (использует path, только для разработки)

​

Управление плагинами

• Просмотрите доступные плагины из маркетплейсов
• Установите/удалите плагины
• Включите/отключите плагины
• Просмотрите детали плагина (предоставляемые команды, агенты, hooks)
• Добавьте/удалите маркетплейсы

​

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

​

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

​

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

​

См. также

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