llm-patterns — правило для Claude Code: что делает и как установить
Правило llm-patterns задаёт соглашения для LLM-провайдеров в коде проекта. Оно пригодится при работе с моделями, конфигурацией, потоками и ошибками CLI.
MIT ★ 1 319 обновлён 2026-09-24
.claude/rules/llm-patterns.mdЧто делает llm-patterns
Правило применяется к файлам src/llm/**. Оно описывает общий контракт LLMProvider с методами call() и stream(), а также необязательным listModels(). Настройки берутся из переменных окружения и сохраняются через src/llm/config.ts в ~/.caliber/config.json.
Отдельные пункты посвящены провайдерам с seat-based авторизацией: для cursor и claude-cli проверка модели пропускается через isSeatBased(). Для Cursor используется запуск agent --print --trust --workspace /tmp, быстрая модель задаётся через getFastModel(), а ANTHROPIC_SMALL_FAST_MODEL действует для anthropic, vertex и claude-cli.
Правило также связывает восстановление после ошибки «модель не найдена» с src/llm/model-recovery.ts, учёт расхода с trackUsage(), разбор ошибок CLI с src/llm/seat-based-errors.ts, а обработку JSON с extractJson() и parseJsonResponse(). Для Codex способ установки через этот каталог не задан, поэтому путь установки нужно учитывать отдельно.
Какие задачи решает
- задать общий интерфейс LLM-провайдеров
- развести настройки моделей по источникам конфигурации
- обработать провайдеры с seat-based авторизацией
- восстановить работу после ошибки «модель не найдена»
- разобрать ошибки CLI и JSON-ответы
Примеры запросов агенту
- Проверь реализацию провайдеров в
src/llm/**по правилу проекта. - Добавь новый провайдер с методами
call()иstream()и учтиlistModels(). - Разбери ошибку провайдера и обработай JSON через
extractJson()иparseJsonResponse().
Как установить llm-patterns
Вручную: положить файлы
.claude/rules/llm-patterns.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/llm-patterns.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/llm-patterns.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/llm-patterns.mdВручную: положить файлы
.clinerules/llm-patterns.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о llm-patterns
Как установить llm-patterns в Claude Code?
Добавьте файл правила по пути .claude/rules/llm-patterns.md. Он применяется к файлам src/llm/**.
Что делает правило llm-patterns?
Оно задаёт паттерны для LLM-провайдеров: интерфейс LLMProvider, конфигурацию, выбор моделей, восстановление после ошибок, учёт использования и разбор JSON.
Как правило обрабатывает seat-based-провайдеров?
Функция isSeatBased() определяет такие провайдеры. Для cursor и claude-cli правило пропускает validateModel().
Исходный текст
llm-patterns.md · MIT
--- paths: - src/llm/** --- # LLM Provider Patterns - Providers implement `LLMProvider` from `src/llm/types.ts`: `call()`, `stream()`, optional `listModels()` - Config: env vars → `~/.caliber/config.json` via `src/llm/config.ts` - Seat-based: `isSeatBased()` in `src/llm/types.ts` — `cursor` and `claude-cli` skip `validateModel()` - Cursor: `agent --print --trust --workspace /tmp` in `src/llm/cursor-acp.ts` - Fast model: `getFastModel()` in `src/llm/config.ts` — `ANTHROPIC_SMALL_FAST_MODEL` scoped to anthropic/vertex/claude-cli - Model recovery: `src/llm/model-recovery.ts` handles not-found with interactive fallback - Usage: `trackUsage()` from `src/llm/usage.ts` - Errors: `src/llm/seat-based-errors.ts` parses stderr from CLI providers - JSON: `extractJson()`, `parseJsonResponse()` in `src/llm/utils.ts`
© caliber-ai-org · MIT · caliber-ai-org/ai-setup