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

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

Правило llm-layer для Claude Code задаёт соглашения для кода провайдеров моделей в src/llm/**: интерфейс LLMProvider, конфиг, seat-based режим и учёт использования.

MIT ★ 1 319 обновлён 2026-09-24

Установить в Cursor · Вручную: положить файлы Все способы и платформы ↓
.cursor/rules/llm-layer.mdc
Открыть на GitHub

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

По шагам, с командами для каждой платформы: 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

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

Все правила IDE по теме «ИИ и ML» →
cost-aware-llm-pipeline affaan-m Скилл cost-aware-llm-pipeline для Claude Code маршрутизирует простые задачи к дешёвым моделям, отслеживает расходы на API и кэширует промпты, сохраняя качество на сложных запросах. CX Codex +1 6 400установок awesome-free-llm-apis reason-machines Скилл awesome-free-llm-apis для Claude Code перечисляет LLM-провайдеров с постоянным бесплатным тарифом, их лимиты, модели и подключение через OpenAI SDK. CX Codex +1 1 000установок instrument-llm-analytics PostHog Скилл instrument-llm-analytics для Claude Code добавляет в проект PostHog AI Observability для отслеживания вызовов языковых моделей. Запускается после реализации LLM-функций или при проверке PR. CX Codex +1 615установок pinme-llm glitternetwork Скилл pinme-llm подсказывает ИИ, как в TypeScript-Worker проекта PinMe вызывать модели OpenRouter через прокси платформы: чат, стриминг, веб-поиск. CX Codex +1 511установок llm-application-dev MoizIbnYousaf Скилл llm-application-dev для работы с большими языковыми моделями на Claude Code, Codex, Cursor и других платформах. CX Codex +1 467установок llm-gateway devops-skills Скилл llm-gateway помогает развернуть API-шлюз перед несколькими LLM: балансировка, лимиты, ключи, кеш и учёт расходов. CX Codex +1 370установок

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

Весь набор →
caliber-onboarding Правило caliber-onboarding для Claude Code и Codex, которое при запуске сессии проверяет, синхронизированы ли конфиги Caliber. Если синхронизация не установлена, предлагает запустить /setup-caliber одной командой. CX Codex +1 ★ 1 319звёзд репо testing Правило testing задаёт паттерны написания тестов на Vitest, изоляцию вызовов LLM и структуру тестовых файлов в проекте Caliber. CX Codex +1 ★ 1 319звёзд репо caliber-conventions Правило caliber-conventions задаёт соглашения для разработки CLI-проектов Caliber на TypeScript. Оно пригодится, чтобы агент учитывал требования проекта при работе с кодом и тестами. CX Codex +1 ★ 1 319звёзд репо testing-patterns Правило testing-patterns для Claude Code задаёт соглашения по Vitest: расположение тестов, работу с моками LLM и запуск одного теста. CX Codex +1 ★ 1 319звёзд репо scoring-patterns Правило scoring-patterns задаёт архитектурные правила для проверок скоринга в src/scoring/**. Помогает писать детерминированные тесты без сетевых вызовов и случайных значений. CX Codex +1 ★ 1 319звёзд репо llm-patterns Правило llm-patterns задаёт соглашения для LLM-провайдеров в коде проекта. Оно пригодится при работе с моделями, конфигурацией, потоками и ошибками CLI. CX Codex +1 ★ 1 319звёзд репо caliber-pre-commit Правило caliber-pre-commit на каждый коммит: проверяет хук Caliber и, если хука нет, синхронизирует конфиги агентов и добавляет их в индекс. CX Codex +1 ★ 1 319звёзд репо find-skills Скилл find-skills ищет готовые скиллы сообщества через реестр Caliber и подключает их прямо во время диалога с агентом. CX Codex +1 ★ 1 319звёзд репо

Ещё в каталоге

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

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