К основному содержанию
правило CX Codex

7-auth — правило для Claude Code: что делает и как установить

Правило 7-auth задаёт правила чтения и сохранения токенов в коде: ленивый поиск GitHub-токена, жёсткие права на файлы и обработку ошибок авторизации.

MIT ★ 571 обновлён 2026-10-29

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/7-auth.md
Открыть на GitHub

Что делает 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 и 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

Похожие правила IDE

Все правила IDE по теме «Безопасность» →
vtex-io-auth-tokens-and-context vtex Скилл vtex-io-auth-tokens-and-context помогает решить, какой токен VTEX IO должен стоять за запросом из бэкенд-приложения: приложение, покупатель или админ. CX Codex +1 1 200установок better-auth-security-best-practices better-auth Скилл better-auth-security-best-practices настраивает защиту Better Auth: ограничивает частоту запросов, проверяет происхождение, шифрует токены и защищает пользовательские сессии. CX Codex +1 52 200установок hunt-auth-bypass Sachin Sharma Скилл hunt-auth-bypass для Claude Code помогает искать обходы аутентификации в SSO, SAML и связанных потоках токенов. Подключается при проверке точек входа, порталов и старых протокольных эндпоинтов. CX Codex +1 ★ 16 193звёзд репо convex-auth convex Добавляет аутентификацию через Convex Auth в новые и существующие проекты на Convex. Настраивает компоненты входа и связи клиентов. CX Codex +1 44 200установок adding-auth spencerpauly Скилл adding-auth проводит агента по шагам добавления аутентификации в веб-приложение на NextAuth.js: провайдеры OAuth, сессии и защищённые маршруты. CX Codex +1 417установок api-auth-key-management Samuel Berthe Скилл api-auth-key-management помогает спроектировать систему API-ключей для внешних клиентов сервиса. Пригодится при настройке ротации без простоя и разграничении сервисных доступов. CX Codex +1 10 500установок

Из того же набора80

Весь набор →
1-comments Правило 1-comments для ИИ-агента: писать комментарий только там, где молчат код и имена, и не ссылаться на тикеты, PR и даты. CX Codex +1 ★ 571звёзд репо 01-ticket-info Скилл 01-ticket-info находит задачу в настроенном трекере и выводит её поля прямо в диалог с ассистентом. CX Codex +1 ★ 571звёзд репо 0-shared-modules Правило 0-shared-modules помогает решить, когда модуль действительно пора выносить в shared/. Оно пригодится при разборе структуры src/contexts/ и перемещении кода между областями приложения. CX Codex +1 ★ 571звёзд репо 01-hello Скилл 01-hello для Claude Code запускает действие greet и подтверждает, что плагин aidd-ui загружен. Он проверяет доступность плагина. CX Codex +1 ★ 571звёзд репо 0-error-handling Правило 0-error-handling задаёт единый путь обработки ошибок в TypeScript-коде: исключение поднимается до командного слоя и ловится там. CX Codex +1 ★ 571звёзд репо 00-onboard Скилл 00-onboard ведёт проект по маршруту AIDD: сканирует репозиторий, решает, какой шаг следующий, показывает экран и выполняет ваш ответ. CX Codex +1 ★ 571звёзд репо 04-skill-generate Скилл 04-skill-generate для Claude Code создаёт маршрутизируемые скиллы для ИИ-инструментов проекта по этапам планирования и валидации. Превращает рабочий процесс в скилл или переписывает существующий. CX Codex +1 ★ 571звёзд репо 03-context-generate Скилл 03-context-generate направляет запрос на создание скилла, правила, субагента, команды или хука к нужному генератору. Если тип не назван, он уточнит его. CX Codex +1 ★ 571звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой