llm-layer — правило для Claude Code: что делает и как установить
Правило llm-layer для Claude Code задаёт соглашения для кода провайдеров моделей в src/llm/**: интерфейс LLMProvider, конфиг, seat-based режим и учёт использования.
MIT ★ 1 319 обновлён 2026-09-24
.cursor/rules/llm-layer.mdcЧто делает llm-layer
Правило задаёт соглашения для кода в src/llm/** — той части проекта, где живут провайдеры моделей. Каждый провайдер реализует интерфейс LLMProvider из src/llm/types.ts: методы call(), stream() и необязательный listModels(). Настройки берутся из переменных окружения, а если их нет — из ~/.caliber/config.json через src/llm/config.ts.
Отдельно описаны seat-based провайдеры, cursor и claude-cli: их различает isSeatBased(), а validateModel() к таким вариантам не применяется. Cursor запускается командой agent --print --trust --workspace /tmp в src/llm/cursor-acp.ts. Дальше по списку: getFastModel() для быстрой модели, восстановление в src/llm/model-recovery.ts, ошибки в src/llm/seat-based-errors.ts, trackUsage() из src/llm/usage.ts.
В шапке правила стоит globs: src/llm/**, поэтому на остальной код оно не распространяется. Правку в другом месте репозитория агент по нему сверять не будет.
Какие задачи решает
- добавить нового провайдера, не сломав остальные
- проследить, откуда берётся настройка: env или
~/.caliber/config.json - отличить seat-based провайдера от обычного
- подключить учёт использования через
trackUsage() - починить восстановление модели после ошибки провайдера
Примеры запросов агенту
- Добавь провайдера
openrouterвsrc/llm/: реализуйLLMProviderсcall()иstream() - Почему
validateModel()не трогает cursor? Посмотриsrc/llm/types.ts - Подключи
trackUsage()в новом провайдере
Как установить llm-layer
Вручную: положить файлы
.cursor/rules/llm-layer.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.claude/rules/llm-layer.mdПоле paths во frontmatter ограничивает файлы: globs из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.github/instructions/llm-layer.instructions.mdПоле applyTo задаёт, к каким файлам применять: globs из источника → applyTo
Вручную: положить файлы
.devin/rules/llm-layer.mdВручную: положить файлы
.clinerules/llm-layer.mdПо шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules
Вопросы о llm-layer
Как установить llm-layer в Claude Code?
Положи файл правила по пути .claude/rules/llm-layer.md.
Что делает llm-layer?
Фиксирует, как устроены провайдеры в src/llm/**: интерфейс LLMProvider, источники конфига, обработку seat-based режима и учёт использования.
Проверяется ли модель у seat-based провайдеров?
Нет, validateModel() к ним не применяется. Признак задаёт isSeatBased() в src/llm/types.ts; в правиле так помечены cursor и claude-cli.
Исходный текст
llm-layer.mdc · MIT
--- description: LLM provider implementation patterns globs: src/llm/** --- - 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, claude-cli) - Cursor: `agent --print --trust --workspace /tmp` in `src/llm/cursor-acp.ts` - Fast model: `getFastModel()` in `src/llm/config.ts` - Model recovery: `src/llm/model-recovery.ts` · Errors: `src/llm/seat-based-errors.ts` - Usage: `trackUsage()` from `src/llm/usage.ts` - `validateModel()` skips seat-based providers
© caliber-ai-org · MIT · caliber-ai-org/ai-setup