Cursor path decryption key — это кастомный ключ в файле .cursor/keys (поле path_decryption_key), которым можно настроить шифрование путей файлов в слое Agent Search. Канон: FAQ «Can I customize path encryption?» в docs Agent Search.
Соседние темы: Indexing / Instant Grep, Ignore Files, Privacy Mode. Pillar: n8n для начинающих.
Для кого path decryption key
- Security review спрашивает, как устроено шифрование путей в search.
- Нужен явный workspace-level контроль через
.cursor/keys. - Разбираете Indexing/Search и хотите отделить path encryption от training/ZDR.
- Не хотите путать «пути зашифрованы» с «код никуда не уходит».
Как настроить за 5 минут
- Откройте корень workspace (тот же уровень, где обычно лежит
.cursor/). - Создайте файл
.cursor/keys. - Запишите JSON с полем
path_decryption_key(строка-ключ вашей политики). - Сохраните файл; убедитесь, что секреты не попали в публичный git без согласования.
- Вернитесь к работе Agent: Instant Grep и Explore работают как обычно — ключ про path encryption, не про «включить поиск».
{
"path_decryption_key": "your-custom-key-here"
}Пример из FAQ docs/agent/tools/search. Подставьте свой ключ; плейсхолдер из доки не копируйте в прод как есть.
| Механизм | Что делает | Источник |
|---|---|---|
| Path encryption (default) | Пути шифруются до серверов Cursor | docs/agent/tools/search |
| .cursor/keys → path_decryption_key | Кастомизация path encryption | FAQ Search |
| Code storage claim | Code content не в plaintext storage | docs/agent/tools/search |
| Instant Grep | Exact/regex поиск по кодовой базе | docs/agent/tools/search |
| Explore subagent | Параллельный поиск в отдельном контексте | docs/agent/tools/search |
| .cursorignore | Что Agent/Tab/@ не должны читать | docs/reference/ignore-file |
Сверка: docs/agent/tools/search (Privacy and security + FAQ), docs/reference/ignore-file (проверка 2026-09-07). Цены не применимы.
Path key vs соседние рычаги
| Рычаг | Задача | Не путать с |
|---|---|---|
| path_decryption_key | Кастом path encryption | Паролем от аккаунта Cursor |
| Privacy Mode | Training / ZDR | Шифрованием путей search |
| .cursorignore | Исключить файлы из AI-контекста | .cursor/keys |
| Max Mode | Размер context window | Криптографией путей |
Сильные стороны
- Явный ответ security: «можно ли кастомизировать path encryption» — да, через
.cursor/keys. - Документ Search связывает это с default path encryption и no-plaintext storage claim.
- Не ломает привычный поток Instant Grep / Explore.
Типичные ошибки
- Считать path decryption key заменой Privacy Mode или .cursorignore для секретов в промпте.
- Коммитить ключ в публичный репозиторий «для удобства команды» без политики секретов.
- Ждать, что ключ отключит LLM-запросы с фрагментами кода — docs про пути/storage search-пути.
- Путать с multi-root workspaces (соседний FAQ на той же странице Search).
FAQ: path decryption key
Что такое path decryption key в Cursor?
Path decryption key — поле path_decryption_key в файле .cursor/keys в корне workspace. В FAQ docs Agent Search оно отвечает на вопрос «Can I customize path encryption?»: пути файлов по умолчанию шифруются перед отправкой на серверы Cursor.
Как настроить .cursor/keys?
Создайте файл .cursor/keys в корне workspace со JSON: объект с ключом path_decryption_key и вашей строкой-ключом. Канон: docs/agent/tools/search, секция FAQ. Не коммитьте ключ в публичный репозиторий без необходимости.
Шифрует ли path encryption содержимое файлов?
В docs Search сказано: file paths шифруются перед отправкой; code content не хранится в plaintext. Это про пути и storage search-пути, а не про то, что фрагменты кода никогда не уходят в LLM-запросы Agent.
Чем path decryption key отличается от Privacy Mode?
Path decryption key кастомизирует шифрование путей в search-слое. Privacy Mode — training/ZDR на уровне аккаунта/команды. Это разные рычаги: см. лонгриды Privacy Mode и Indexing.
Нужен ли path decryption key каждому проекту?
По умолчанию path encryption уже включён. Кастомный ключ — опция из FAQ Search для тех, кому нужно управлять расшифровкой путей. Если нет требования security team — начните без .cursor/keys.
Вывод
Cursor path decryption key — точечная настройка path encryption через .cursor/keys. Сначала ignore + Privacy Mode по задаче, потом ключ — если security явно просит кастом. Дальше: Indexing и Privacy Mode.
Хотите нейросети под свои задачи, а не «для всех»?
Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Тех-pillar — n8n для начинающих.