7-auth — правило для Claude Code: что делает и как установить
Правило 7-auth задаёт правила чтения и сохранения токенов в коде: ленивый поиск GitHub-токена, жёсткие права на файлы и обработку ошибок авторизации.
MIT ★ 571 обновлён 2026-10-29
.claude/rules/7-auth.mdЧто делает 7-auth
Правило регламентирует работу с токенами в путях src/runtime/auth/**/*.ts и src/contexts/*/application/**/*.ts. Модель опирается на метод AuthReaderAdapter.resolve(), который опрашивает переменную AIDD_TOKEN, проектный .aidd/auth.json и пользовательский auth.json. Результат кэшируется после первого совпадения, поэтому вызов gh происходит максимум один раз. Вариант method: "external" вызывает gh auth token при чтении, а отдельного метода "gh" в схеме нет.
Файлы с ключами требуют безопасного сохранения: права 0600 на POSIX-системах и вызов icacls /inheritance:r на Windows. Если ограничить доступ к файлу не удалось, код обязан сразу выбросить ошибку.
Команды не должны падать заранее из-за отсутствующего токена. Ошибка авторизации CatalogFetchAuthError возникает только при получении ответа 401, а локальному пути токен вообще не требуется.
Какие задачи решает
- настроить безопасное сохранение токенов с правами 0600 или icacls
- реализовать ленивую загрузку GitHub-токена без лишних вызовов gh
- прописать обработку 401 через исключение CatalogFetchAuthError
- задать приоритет источников авторизации в AuthReaderAdapter
Примеры запросов агенту
- Добавь чтение токена через AuthReaderAdapter.resolve() с учётом переменных окружения
- Напиши сохранение токена в auth.json с ограничением прав доступа на POSIX и Windows
- Проверь обработку ошибки 401 при обращении к каталогу
Как установить 7-auth
Вручную: положить файлы
.claude/rules/7-auth.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/7-auth.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/7-auth.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/7-auth.mdВручную: положить файлы
.clinerules/7-auth.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о 7-auth
Как установить 7-auth в Claude Code?
Сохраните правило в файл .claude/rules/7-auth.md внутри вашего репозитория.
Что делает правило 7-auth?
Оно инструктирует ассистента правильно искать, мемоизировать и сохранять токены авторизации без предварительных блокирующих проверок.
Что произойдёт, если токен не найден?
Команды не прерывают выполнение заранее: ошибка авторизации проявляется как CatalogFetchAuthError только при реальном ответе 401.
Исходный текст
7-auth.md · MIT
--- description: Apply when a token is read, stored or checked; one GitHub token, resolved once, never checked eagerly. paths: - "src/runtime/auth/**/*.ts" - "src/contexts/*/application/**/*.ts" --- # Auth ## Resolution - `AuthReaderAdapter.resolve()`: `AIDD_TOKEN`, project `.aidd/auth.json`, user `auth.json`. - First hit wins; memoized, so `gh` spawns at most once. - `method: "stored"` holds the token. - `method: "external"` runs `gh auth token` at read time, at its own level. - No `"gh"` method exists. ## Storage - Write a credential `0600` on POSIX, `icacls /inheritance:r` on win32. - Throw when the restriction fails. ## Not checked - No command refuses for a missing token. - Authorization surfaces as `CatalogFetchAuthError` on a 401. - A local framework path needs no token. - Full contract: `aidd_docs/memory/auth.md`.
© ai-driven-dev · MIT · ai-driven-dev/framework