Параметры Claude Code

​

Области конфигурации

​

Доступные области

​

Когда использовать каждую область

• Политик безопасности, которые должны быть применены на уровне организации
• Требований соответствия, которые нельзя переопределить
• Стандартизированных конфигураций, развернутых IT/DevOps

• Личных предпочтений, которые вы хотите везде (темы, параметры редактора)
• Инструментов и plugins, которые вы используете во всех проектах
• Ключей API и аутентификации (хранятся безопасно)

• Параметров, совместно используемых командой (разрешения, hooks, MCP servers)
• Plugins, которые должна иметь вся команда
• Стандартизации инструментов между сотрудниками

• Личных переопределений для конкретного проекта
• Тестирования конфигураций перед совместным использованием с командой
• Параметров, специфичных для машины, которые не будут работать для других

​

Как области взаимодействуют

1. Managed (наивысший): не может быть переопределена ничем
2. Аргументы командной строки: временные переопределения сеанса
3. Local: переопределяет параметры проекта и пользователя
4. Project: переопределяет параметры пользователя
5. User (наименьший): применяется, когда ничто другое не указывает параметр

​

Что использует области

​

Файлы параметров

• Параметры пользователя определяются в ~/.claude/settings.json и применяются ко всем проектам.
• Параметры проекта сохраняются в каталоге вашего проекта:
  • .claude/settings.json для параметров, которые проверяются в системе управления версиями и совместно используются с вашей командой
  • .claude/settings.local.json для параметров, которые не проверяются, полезны для личных предпочтений и экспериментов. Когда Claude Code создает .claude/settings.local.json, он настраивает git на игнорирование файла. Если вы создаете файл самостоятельно, добавьте его в gitignore вручную. Поскольку этот файл принадлежит вам, а не репозиторию, его правила разрешения allow вступают в силу без этапа доверия рабочей области, который требуют правила разрешения .claude/settings.json. Если репозиторий предоставляет файл, например путем его фиксации, доверие рабочей области по-прежнему применяется.
• Управляемые параметры: Для организаций, которым требуется централизованное управление, Claude Code поддерживает несколько механизмов доставки управляемых параметров. Все используют один и тот же формат JSON и не могут быть переопределены параметрами пользователя или проекта:
  • Параметры, управляемые сервером: доставляются удаленно при входе либо с серверов Anthropic через консоль администратора claude.ai, либо с самостоятельно размещенного Claude apps gateway. См. параметры, управляемые сервером.
  • Политики MDM/OS-уровня: доставляются через встроенное управление устройствами на macOS и Windows:
    • macOS: домен управляемых предпочтений com.anthropic.claudecode. Ключи верхнего уровня plist отражают managed-settings.json, с вложенными параметрами как словари и массивы как plist массивы. Развертывание через профили конфигурации в Jamf, Iru (Kandji) или аналогичных инструментах MDM.
    • Windows: ключ реестра HKLM\SOFTWARE\Policies\ClaudeCode со значением Settings (REG_SZ или REG_EXPAND_SZ), содержащим JSON (развернуто через групповую политику или Intune)
    • Windows (уровень пользователя): HKCU\SOFTWARE\Policies\ClaudeCode (наименьший приоритет политики, используется только при отсутствии источника на уровне администратора)
  • На основе файлов: managed-settings.json и managed-mcp.json, развернутые в системные каталоги:
    • macOS: /Library/Application Support/ClaudeCode/
    • Linux и WSL: /etc/claude-code/
    • Windows: C:\Program Files\ClaudeCode\
    Устаревший путь Windows C:\ProgramData\ClaudeCode\managed-settings.json больше не поддерживается с версии v2.1.75. Администраторы, которые развернули параметры в этом местоположении, должны перенести файлы в C:\Program Files\ClaudeCode\managed-settings.json.
    Управляемые параметры на основе файлов также поддерживают каталог drop-in в managed-settings.d/ в том же системном каталоге рядом с managed-settings.json. Это позволяет отдельным командам развертывать независимые фрагменты политики без координации редактирования одного файла. Следуя соглашению systemd, managed-settings.json объединяется первым как база, затем все файлы *.json в каталоге drop-in сортируются в алфавитном порядке и объединяются сверху. Более поздние файлы переопределяют более ранние для скалярных значений; массивы объединяются и дедублицируются; объекты глубоко объединяются. Скрытые файлы, начинающиеся с ., игнорируются. Используйте числовые префиксы для управления порядком объединения, например 10-telemetry.json и 20-security.json.
  См. управляемые параметры и Управляемая конфигурация MCP для получения подробной информации. Этот репозиторий включает начальные шаблоны развертывания для Jamf, Iru (Kandji), Intune и Group Policy. Используйте их как отправные точки и адаптируйте их в соответствии с вашими потребностями.
  Управляемые развертывания также могут ограничивать добавления на marketplace plugins с помощью strictKnownMarketplaces. Для получения дополнительной информации см. Управляемые ограничения marketplace.
• Другая конфигурация хранится в ~/.claude.json. Этот файл содержит ваш сеанс OAuth, конфигурации MCP server для областей пользователя и локальной области, состояние для каждого проекта (разрешенные инструменты, параметры доверия) и различные кэши. MCP servers с областью проекта хранятся отдельно в .mcp.json.

{
  "$schema": "https://json.schemastore.org/claude-code-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"
  },
  "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"
  ]
}

​

Когда изменения вступают в силу

• model: используйте /model для переключения в середине сеанса
• outputStyle: часть системного запроса, который перестраивается на /clear или перезагрузке

​

Недействительные записи в управляемых параметрах

• Интерактивные сеансы показывают диалог при запуске, перечисляющий недействительные записи.
• Headless запуски с -p выводят сводку в stderr.
• claude doctor перечисляет каждую недействительную запись с ее источником и полем.

​

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

​

Параметры глобальной конфигурации

​

Параметры Worktree

​

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

​

Синтаксис правила разрешения

​

Параметры Sandbox

​

Префиксы пути Sandbox

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker *"],
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org", "registry.yarnpkg.com"],
      "deniedDomains": ["uploads.github.com"],
      "allowUnixSockets": [
        "/var/run/docker.sock"
      ],
      "allowLocalBinding": true
    }
  }
}

• Параметры sandbox.filesystem (показаны выше): Контролируют пути на границе sandbox уровня ОС. Эти ограничения применяются ко всем командам подпроцесса (например, kubectl, terraform, npm), а не только к инструментам файлов Claude.
• Правила разрешений: Используйте правила разрешения Edit allow/deny для управления доступом инструмента файлов Claude, правила Read deny для блокировки чтения и правила WebFetch allow/deny для управления доменами сети. Пути из этих правил также объединяются в конфигурацию sandbox.

​

Параметры атрибуции

• Коммиты используют git trailers (например, Co-Authored-By) по умолчанию, которые можно настроить или отключить
• Описания pull request - это простой текст

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

🤖 Generated with [Claude Code](https://claude.com/claude-code)

{
  "attribution": {
    "commit": "Generated with AI\n\nCo-Authored-By: AI <ai@example.com>",
    "pr": ""
  }
}

​

Параметры предложения файлов

{
  "fileSuggestion": {
    "type": "command",
    "command": "~/.claude/file-suggestion.sh"
  }
}

{"query": "src/comp"}

src/components/Button.tsx
src/components/Modal.tsx
src/components/Form.tsx

#!/bin/bash
query=$(cat | jq -r '.query')
# Замените your-repo-file-index на вашу собственную команду поиска файлов
your-repo-file-index --query "$query" | head -20

​

Значки ссылок нижнего колонтитула

{
  "footerLinksRegexes": [
    {
      "type": "regex",
      "pattern": "\\b(?<key>PROJ-\\d+)\\b",
      "url": "https://issues.example.com/browse/{key}",
      "label": "{key}"
    }
  ]
}

​

Конфигурация Hook

• Управляемые hooks и SDK hooks загружаются
• Hooks из plugins, принудительно включенных в управляемых параметрах enabledPlugins, загружаются. Это позволяет администраторам распространять проверенные hooks через организационный marketplace, блокируя все остальное. Доверие предоставляется по полному ID plugin@marketplace, поэтому plugin с тем же именем из другого marketplace остается заблокированным
• Пользовательские hooks, проектные hooks и все остальные plugin hooks блокируются

{
  "allowedHttpHookUrls": ["https://hooks.example.com/*", "http://localhost:*"]
}

{
  "httpHookAllowedEnvVars": ["MY_TOKEN", "HOOK_SECRET"]
}

​

Вычислить управляемые параметры с помощью помощника политики

{
  "managedSettings": {
    "permissions": { "deny": ["Read(//etc/secrets/**)"] }
  },
  "claudeMd": "# Organization context\n...",
  "appendSystemPrompt": "Always cite the internal style guide."
}

​

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

1. Управляемые параметры (управляемые сервером, политики MDM/OS-уровня или управляемые параметры)
   • Политики, развернутые IT через доставку сервера, профили конфигурации MDM, политики реестра или файлы управляемых параметров
   • Не могут быть переопределены никаким другим уровнем, включая аргументы командной строки
   • В пределах управляемого уровня приоритет: policyHelper вывод, который при настройке является единственным используемым управляемым источником > удаленный (параметры, управляемые сервером claude.ai или Claude apps gateway-доставленные) > политики MDM/OS-уровня > на основе файлов (managed-settings.d/*.json и managed-settings.json, объединенные вместе) > реестр HKCU (только Windows). Используется только один управляемый источник; источники не объединяются в разных уровнях, с одним исключением: ключи блокировки sandbox sandbox.network.allowManagedDomainsOnly и sandbox.filesystem.allowManagedReadPathsOnly, с их связанными списками разрешений, allowAllClaudeAiMcps и пути двоичных файлов sandbox sandbox.bwrapPath и sandbox.socatPath учитываются, когда любой управляемый источник, контролируемый администратором, их устанавливает; уровень HKCU, доступный для записи пользователем, исключен.
   • Хосты встраивания, такие как Claude Desktop, могут предоставлять политику через опцию SDK managedSettings. По умолчанию это игнорируется, когда присутствует любой управляемый источник, развернутый администратором: параметры, управляемые сервером, политика MDM или OS-уровня, или файл управляемых параметров. Резервный реестр HKCU, доступный для записи пользователем, не считается управляемым источником, развернутым администратором. Администраторы могут согласиться, установив parentSettingsBehavior на "merge". Значения встраивателя отфильтрованы, чтобы они могли ужесточить управляемую политику, но не ослабить ее.
2. Аргументы командной строки
   • Временные переопределения для конкретного сеанса. JSON, переданный через --settings <file-or-json>, объединяется с параметрами на основе файлов, используя те же правила, что и другие уровни: ключ, установленный здесь, переопределяет тот же ключ в локальных, проектных или пользовательских параметрах, и пропуск ключа оставляет значение нижнего уровня на месте
3. Локальные параметры проекта (.claude/settings.local.json)
   • Личные параметры, специфичные для проекта
4. Общие параметры проекта (.claude/settings.json)
   • Параметры проекта, совместно используемые командой в системе управления версиями
5. Параметры пользователя (~/.claude/settings.json)
   • Личные глобальные параметры

​

Проверить активные параметры

​

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

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

​

Системный запрос

​

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

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

​

Конфигурация Subagent

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

​

Конфигурация Plugin

​

Параметры Plugin

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

​

enabledPlugins

• Параметры пользователя (~/.claude/settings.json): Личные предпочтения plugins
• Параметры проекта (.claude/settings.json): Plugins, специфичные для проекта, совместно используемые с командой
• Локальные параметры (.claude/settings.local.json): Переопределения для каждой машины, не зафиксированные, когда Claude Code их создает
• Управляемые параметры (managed-settings.json): Переопределения организационной политики, которые блокируют установку на всех уровнях и скрывают plugin из marketplace

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

​

pluginConfigs

{
  "pluginConfigs": {
    "deployer@acme-tools": {
      "options": {
        "api_endpoint": "https://api.example.com"
      }
    }
  }
}

​

extraKnownMarketplaces

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

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

• github: Репозиторий GitHub (использует repo)
• git: Любой URL git (использует url)
• directory: Путь локальной файловой системы (использует path, только для разработки)
• hostPattern: Шаблон regex для сопоставления хостов marketplace (использует hostPattern)
• settings: встроенный marketplace, объявленный непосредственно в settings.json без отдельного размещенного репозитория (использует name и plugins)

{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "settings",
        "name": "team-tools",
        "plugins": [
          {
            "name": "code-formatter",
            "source": {
              "source": "github",
              "repo": "acme-corp/code-formatter"
            }
          }
        ]
      }
    }
  }
}

​

strictKnownMarketplaces

• macOS: /Library/Application Support/ClaudeCode/managed-settings.json
• Linux и WSL: /etc/claude-code/managed-settings.json
• Windows: C:\Program Files\ClaudeCode\managed-settings.json

• Доступно только в управляемых параметрах (managed-settings.json)
• Не может быть переопределено параметрами пользователя или проекта (наивысший приоритет)
• Применяется ДО операций сети/файловой системы (заблокированные источники никогда не выполняются)
• Использует точное сопоставление для спецификаций источников (включая ref, path для источников git), кроме hostPattern и pathPattern, которые используют сопоставление regex

• undefined (по умолчанию): Без ограничений - пользователи могут добавить любой marketplace
• Пустой массив []: Полная блокировка - пользователи не могут добавить новые marketplaces
• Список источников: Пользователи могут добавить только marketplaces, которые точно совпадают

1. Репозитории GitHub:

{ "source": "github", "repo": "acme-corp/approved-plugins" }
{ "source": "github", "repo": "acme-corp/security-tools", "ref": "v2.0" }
{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }

2. Репозитории Git:

{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }
{ "source": "git", "url": "https://bitbucket.org/acme-corp/plugins.git", "ref": "production" }
{ "source": "git", "url": "ssh://git@git.example.com/plugins.git", "ref": "v3.1", "path": "approved" }

3. Marketplaces на основе URL:

{ "source": "url", "url": "https://plugins.example.com/marketplace.json" }
{ "source": "url", "url": "https://cdn.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }

4. Пакеты NPM:

{ "source": "npm", "package": "@acme-corp/claude-plugins" }
{ "source": "npm", "package": "@acme-corp/approved-marketplace" }

5. Пути файлов:

{ "source": "file", "path": "/usr/local/share/claude/acme-marketplace.json" }
{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }

6. Пути каталогов:

{ "source": "directory", "path": "/usr/local/share/claude/acme-plugins" }
{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }

7. Сопоставление шаблона хоста:

{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }
{ "source": "hostPattern", "hostPattern": "^gitlab\\.internal\\.example\\.com$" }

• github: всегда сопоставляется с github.com
• git: извлекает имя хоста из URL (поддерживает форматы HTTPS и SSH)
• url: извлекает имя хоста из URL
• npm, file, directory: не поддерживается для сопоставления шаблона хоста

8. Сопоставление шаблона пути:

{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }
{ "source": "pathPattern", "pathPattern": ".*" }

{
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "acme-corp/approved-plugins"
    },
    {
      "source": "github",
      "repo": "acme-corp/security-tools",
      "ref": "v2.0"
    },
    {
      "source": "url",
      "url": "https://plugins.example.com/marketplace.json"
    },
    {
      "source": "npm",
      "package": "@acme-corp/compliance-plugins"
    }
  ]
}

{
  "strictKnownMarketplaces": []
}

{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}

• repo или url должны совпадать точно
• Поле ref должно совпадать точно (или оба быть не определены)
• Поле path должно совпадать точно (или оба быть не определены)

// Это РАЗНЫЕ источники:
{ "source": "github", "repo": "acme-corp/plugins" }
{ "source": "github", "repo": "acme-corp/plugins", "ref": "main" }

// Это также РАЗНЫЕ:
{ "source": "github", "repo": "acme-corp/plugins", "path": "marketplace" }
{ "source": "github", "repo": "acme-corp/plugins" }

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "acme-corp/plugins" }
  ]
}

{
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": { "source": "github", "repo": "acme-corp/plugins" }
    }
  }
}

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "acme-corp/plugins" }
  ],
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": { "source": "github", "repo": "acme-corp/plugins" }
    }
  }
}

• Ограничения проверяются ДО любых запросов сети или операций файловой системы
• При блокировке пользователи видят четкие сообщения об ошибках, указывающие, что источник заблокирован управляемой политикой
• Ограничение применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin. Marketplace, добавленный до установки политики, не может быть использован для установки или обновления plugins после того, как его источник больше не совпадает со списком разрешений
• Управляемые параметры имеют наивысший приоритет и не могут быть переопределены

​

strictPluginOnlyCustomization

{
  "strictPluginOnlyCustomization": ["skills", "hooks"]
}

​

Управление Plugins

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

​

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

​

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

​

См. также

• Permissions: система разрешений, синтаксис правил, шаблоны, специфичные для инструментов, и управляемые политики
• Authentication: настройка доступа пользователей к Claude Code
• Debug your configuration: диагностика причин, по которым параметр, hook или MCP сервер не вступают в силу
• Troubleshoot installation and login: установка, аутентификация и проблемы платформы