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

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

Правило llm-patterns задаёт соглашения для LLM-провайдеров в коде проекта. Оно пригодится при работе с моделями, конфигурацией, потоками и ошибками CLI.

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

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

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

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

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →
llm-app-patterns davila7 Скилл llm-app-patterns для Claude Code разбирает архитектуры приложений с LLM, включая RAG и агентов. Подключается при проектировании таких систем и настройке наблюдаемости. CX Codex +1 129установок llm-application-dev MoizIbnYousaf Скилл llm-application-dev для работы с большими языковыми моделями на Claude Code, Codex, Cursor и других платформах. CX Codex +1 467установок llm-tuning-patterns parcadei Скилл llm-tuning-patterns для Claude Code подсказывает параметры LLM — температуру и лимит токенов — под формальные доказательства, генерацию кода и творческие задачи. CX Codex +1 ★ 3 951звёзд репо pinme-llm glitternetwork Скилл pinme-llm подсказывает ИИ, как в TypeScript-Worker проекта PinMe вызывать модели OpenRouter через прокси платформы: чат, стриминг, веб-поиск. CX Codex +1 511установок llm-dark-patterns waitdeadai Плагин llm-dark-patterns для Claude Code проверяет исходящие ответы и блокирует лесть, ложные отчёты об успехе и выдуманные цифры. ★ 22звёзд репо llm-input-output-guardrail-middleware-development W4L33Dx Скилл llm-input-output-guardrail-middleware-development для Claude Code помогает проектировать защитное ПО-посредник для LLM-агентов. Он включается при настройке проверок входных данных, вызовов инструментов и исходящего содержимого. CX Codex +1 ★ 73звёзд репо

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

Весь набор →
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звёзд репо caliber-pre-commit Правило caliber-pre-commit на каждый коммит: проверяет хук Caliber и, если хука нет, синхронизирует конфиги агентов и добавляет их в индекс. CX Codex +1 ★ 1 319звёзд репо find-skills Скилл find-skills ищет готовые скиллы сообщества через реестр Caliber и подключает их прямо во время диалога с агентом. CX Codex +1 ★ 1 319звёзд репо save-learning Скилл save-learning сохраняет правила и предпочтения пользователя для следующих сессий проекта. Он пригодится, когда вы хотите, чтобы агент помнил договорённости между запусками. CX Codex +1 ★ 1 319звёзд репо setup-caliber Скилл setup-caliber доводит проект до рабочего Caliber: ставит CLI, включает синхронизацию конфигов агентов на коммите и создаёт недостающие файлы. CX Codex +1 ★ 1 319звёзд репо

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

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