claude                                  # открыть Claude Code

claude --dangerously-skip-permissions   # без запросов разрешений

--dangerously-skip-permissions — Claude не будет спрашивать «разрешить?» на каждое действие. Удобно для быстрой работы, но давай только в своём проекте.

free -h && df -h / && ps aux --sort=-%mem | head -10

free -h — оперативная память (всего / занято / свободно) · df -h / — диск · ps aux --sort=-%mem | head -10 — топ-10 процессов по RAM

! и @ работают только в начале строки. # — в любой момент.

Статусы карточек: ● needs input · ждёт ответа   ● working · думает   ● completed · готово   ● error · упал

.md — это обычный текстовый файл (Markdown). Вы пишете текст и пару значков, а файл «оживает»: где-то заголовок, где-то список, где-то жирное слово. Открывается где угодно, лёгкий, понятен и человеку, и ИИ.

CLAUDE.md — такой же Markdown, но с особым именем и ролью: это записка для ИИ-помощника о вашем проекте. Лежит в главной папке проекта, рядом с остальными файлами.

90% случаев: # для заголовков, - для списков, ** вокруг слова для жирного. Этого хватит на старте.

Без него ИИ каждый раз начинает «с чистого листа». С ним — работает как сотрудник, который уже в курсе дела.

Коротко и по делу — то, что рассказали бы новому помощнику:

• Что за проект — пара предложений.
• Как запускать — команды или шаги.
• Правила и стиль — язык, цвета, как оформлять.
• Чего избегать — что точно не нужно делать.

# Мой проект

Сайт-визитка для кофейни. Делаю в одиночку.

## Как запускать
- Открыть `index.html` двойным кликом — работает без установок.

## Стиль
- Тексты на русском, дружелюбно и просто.
- Цвета: бежевый фон, коричневый акцент.
- Только чистый HTML и CSS, без сложных библиотек.

## Чего избегать
- Без рекламы и всплывающих окон.
- Не усложнять код — он должен быть понятен новичку.

Чёткой схемы нет, но удачный файл обычно содержит блоки:

Переиспользуемый «рецепт»: как делать X (процесс, правила, чек-листы). Claude подгружает скилл только когда он нужен (по полю description), а не держит в контексте всегда — это экономит память.

Где: .claude/skills/<имя>/SKILL.md · Вызов: авто по смыслу или /имя

---
name: commit-style
description: Use when writing git commits — формат сообщений
---

# Стиль коммитов
1. Заголовок ≤ 50 символов, в повелительном наклонении.
2. Тело: что и зачем, не «как».

В этом портале скиллы дают superpowers (brainstorming, test-driven-development, systematic-debugging) и ui-ux-pro-max (стиль, палитра, шрифты под задачу).

Готовый шаблон запроса, который запускается командой /имя. Удобно для действий, которые повторяешь часто. Аргументы подставляются через $ARGUMENTS.

Где: .claude/commands/<имя>.md · Вызов: /имя аргументы

---
description: Ревью текущих изменений по чек-листу
argument-hint: [папка или файл]
allowed-tools: Read, Grep, Bash(git diff:*)
---

Проверь изменения в $ARGUMENTS на баги, безопасность,
читаемость. Дай список замечаний с приоритетами.

Отдельный «работник» со своим набором инструментов и чистым контекстом. Главный Claude поручает ему узкую задачу, тот выполняет и возвращает только результат — основной диалог не засоряется. Можно запускать несколько параллельно.

Где: .claude/agents/<имя>.md · Вызов: авто или явно «через субагента»

• Тяжёлый поиск по кодовой базе — субагент перелопачивает сотни файлов, главный контекст чист.
• Параллельные варианты — три субагента дают 3 наброска одновременно.
• Ограничение прав — ревьюеру дать только Read/Grep, он физически не сможет ничего изменить.

Shell-команды, которые сам Claude Code (не модель!) запускает на событие: старт сессии, перед/после вызова инструмента, остановка. Поэтому хуки — для гарантированных действий, которые должны срабатывать всегда.

Где: .claude/hooks/ + регистрация в settings.json · События: SessionStart, PreToolUse, PostToolUse, Stop…

"hooks": {
  "PostToolUse": [{
    "matcher": "Edit|Write",
    "hooks": [{ "type": "command",
      "command": "npx prettier --write \"$CLAUDE_FILE_PATHS\"" }]
  }]
}

Меняют манеру и тон ответов Claude, не трогая логику работы. Один запрос можно получить «по-инженерному кратко» или «как от наставника с пояснениями».

Где: .claude/output-styles/<имя>.md · Вызов: команда /output-style

---
name: Наставник
description: Объясняет каждый шаг простыми словами
---

Перед действием говори ЧТО и ЗАЧЕМ делаешь.
После — что получилось и как проверить.

Главный конфиг поведения: права (что можно без спроса, что спросить, что запретить), переменные окружения, регистрация хуков и тумблеры MCP. Личное (не для репозитория) выносят в settings.local.json (в .gitignore).

{
  "permissions": {
    "allow": ["Read", "Bash(git diff:*)"],
    "ask":   ["Bash(git push:*)"],
    "deny":  ["Read(./.env)"]
  },
  "enabledMcpjsonServers": ["figma", "pencil"]
}

MCP (Model Context Protocol) — стандарт, по которому Claude подключается к внешним «серверам инструментов». Каждый сервер добавляет реальные действия: Figma — дизайн, Playwright — браузер, Context7 — свежая документация. Конфиг проекта — .mcp.json (коммитится, шарится на команду).

{
  "mcpServers": {
    "figma": {
      "command": "npx",
      "args": ["-y", "figma-developer-mcp", "--stdio"],
      "env": { "FIGMA_API_KEY": "${FIGMA_API_KEY}" }
    }
  }
}

1. Получить токен. Figma → Settings → Security → Personal access tokens.
2. Положить токен в окружение. В ~/.zshrc: export FIGMA_API_KEY="figd_…", перезапустить терминал.
3. Описать сервер в .mcp.json (блок как выше).
4. Разрешить сервер — добавить имя в enabledMcpjsonServers в settings.json.
5. Перезапустить Claude Code и проверить статус командой /mcp (должен быть connected).

На вкладке Проекты в строке проекта нажми иконку «Публикация» (стрелка вверх ↥). Откроется окно настроек.

• Опубликовать приложение — поставь галочку, чтобы включить.
• Кто может смотреть — «Только я и админ», «Все залогиненные сотрудники» или «Публично» (внешние пользователи без входа — например, чтобы показать клиенту).
• Авто-засыпание — если включено, приложение засыпает вместе с контейнером через 30 минут простоя и само поднимается при следующем заходе. Выключи, если приложение должно работать постоянно.

Нажми Сохранить. Появится ссылка вида vibe.paav.ru/<твой-логин>/<проект>/ — её можно скопировать и открыть.

Если ты изменил код приложения — открой окно публикации и нажми «Деплой». Это перезапустит приложение с новой версией кода. Заодно деплой поднимет приложение, если оно «спит».

• Приложение запускается прямо в твоём контейнере (как и VS Code) — отдельный сервер не нужен.
• Node-проекты (есть package.json) и PHP-проекты (папка www/) поднимаются автоматически — настраивать ничего не надо.
• Подключай стили и скрипты относительным путём (css/style.css, а не /css/style.css) — приложение живёт под адресом /<логин>/<проект>/.
• По умолчанию ссылка работает только для вошедших в портал. Вариант «Публично» открывает приложение всем по ссылке (без входа) — удобно показать клиенту, но не публикуй так черновики и ничего с секретами.

Скилл — это markdown-файл, который превращает отлаженный промпт в вызываемую slash-команду. Вместо того чтобы вспоминать точную формулировку, пишешь одно имя: /review-pr, /frontend-design, /mcp-builder.

Claude подгружает скилл только когда он нужен (по полю description), а не держит в контексте постоянно — это экономит токены.

Три разных механизма. Главное отличие — кто и когда запускает.

---
name: review-pr
description: Use when reviewing a pull request
argument-hint: "<pr-number>"
allowed-tools: Read, Bash(gh pr:*)
---

Просмотри PR #$ARGUMENTS.
Проверь: логика, edge cases, безопасность, читаемость.
Дай структурированный отчёт: Critical / Warning / Suggestion.

Совет: Скиллы версионируются в git вместе с кодом — это инфраструктура команды, а не одноразовые заметки.

1. Открой Claude Code в папке проекта, напиши и отладь промпт.
2. Скажи: «Преврати эту логику в переиспользуемый скилл /review-pr, принимающий номер PR как аргумент».
3. Claude сохранит файл в .claude/commands/ или .claude/skills/.
4. Добавь файл в git — теперь он у всей команды.

Установлены в контейнере каждого сотрудника. Кликни на карточку — откроется репозиторий для установки.

• apidocs.bitrix24.ru — справочник REST API
• CRM widgets — встраивание в карточки CRM
• OAuth tokens — токены и обновление

• vibecode.bitrix24.tech — главная
• Quickstart
• llms-full.txt — справочник для AI

• docs.claude.com
• obra/superpowers
• ui-ux-pro-max-skill
• claude-memory-skill

GigaAM v3 от Сбера — лучшая на сегодня модель распознавания русской речи: знаки препинания, цифры, латиница. ~225 МБ, работает на CPU. Ставится прямо из Handy:

• Открой Handy → Settings (иконка шестерёнки).
• В разделе Models найди в списке GigaAM v3 и выбери его.
• Модель скачается автоматически при первом запуске (~225 МБ, интернет нужен один раз) — дальше работает офлайн.
• Проверь, что у карточки модели горит статус «Активный» — значит распознавание идёт через неё.

Битрикс24 Вайбкод — платформа для создания приложений, чат-ботов и автоматизаций поверх Битрикс24 с помощью ИИ. Запущена в апреле 2026 года.

Главная идея: ты описываешь задачу на человеческом языке → ИИ-инструмент (Claude Code, Cursor) читает документацию, пишет код и сам разворачивает готовое приложение на сервере. Знать программирование при этом не обязательно.

• Приложения-надстройки поверх Битрикс24 (дашборды, аналитика, формы)
• Чат-боты в мессенджере Битрикс24
• Автоматизации: синхронизация данных, обработка сделок, рассылки
• Интеграции с внешними системами и AI-моделями

Для работы нужны два платных компонента:

Система вайбов: 1 вайб = 1 рубль — внутренняя валюта платформы.

Ключ — пропуск, который позволяет ИИ-инструменту работать с платформой от твоего имени. Создаётся в личном кабинете Вайбкод.

Ключ передаётся в заголовке каждого запроса:

X-Api-Key: vibe_api_твой_ключ

Пример промпта для ИИ:

Мой Вайбкод ключ: vibe_api_xxx
Документация: https://vibecode.bitrix24.tech/docs
Задача: создай дашборд со статистикой открытых сделок по стадиям

ИИ сам прочитает документацию, напишет код и задеплоит приложение.

AI Router — маршрутизатор AI-моделей с единым интерфейсом, совместимым с OpenAI. Любой инструмент для OpenAI заработает и здесь.

Базовый адрес: https://vibecode.bitrix24.tech/v1

• Классификация лидов и сделок по тексту переписки
• Генерация описаний товаров и коммерческих предложений
• Суммаризация переписок, извлечение данных из комментариев
• Генерация отчётов по данным CRM
• Распознавание речи из записей звонков

Entity API — универсальный интерфейс для чтения и изменения любых данных Битрикс24. 300+ методов для всех сущностей системы.

Шесть стандартных операций — одинаковые для каждой сущности (пример на сделках):

• Агрегация: сумма, среднее, min/max — например, общая сумма сделок за месяц
• Пакетные операции: до 500 записей одним запросом
• Лимит: 10 запросов в секунду на портал

Когда приложению нужна серверная логика (фоновые задачи, боты), оно запускается на сервере Black Hole — изолированном облачном сервере, невидимом снаружи.

Управление доступом: одним кликом — только ты, конкретные сотрудники, отдел, весь портал или публично.

Боты живут в мессенджере Битрикс24: отвечают на сообщения, выполняют slash-команды, участвуют в чатах. Публичного сервера не нужно — бот сам периодически опрашивает платформу о новых событиях.

• Отправлять, редактировать, удалять сообщения
• Форматировать текст: [B]жирный[/B], [I]курсив[/I]
• Кнопки-действия прямо в сообщении
• Индикатор «печатает…», создавать чаты, управлять участниками
• Slash-команды: /report, /help и любые другие
• Прикреплять файлы

33 эндпоинта: боты (5), сообщения (9), чаты (10), интерфейс (5), команды (5), файлы (2).

Приложение Вайбкод — надстройка над Битрикс24, встраивается прямо в его интерфейс: боковая панель, карточка сделки, страница CRM.

Цикл: Создать → Задеплоить код → Задать адрес → Опубликовать

• Командный ключ (vibe_app_…) выдаётся один раз — сохрани сразу
• Скоуп placement нужно добавить при создании — после нельзя, нужно пересоздать
• Статичные HTML/JS-приложения не требуют сервера вообще

MCP (Model Context Protocol) — стандартный протокол, через который внешние AI-инструменты могут читать и изменять данные Битрикс24.

Адрес: https://mcp.bitrix24.tech/mcp/

• ChatGPT — данные Битрикс24 как источник в диалоге
• Yandex AI Studio — интеграция с ЯндексGPT
• Cursor — IDE с AI, которая видит данные CRM
• n8n — автоматизация между Битрикс24 и другими системами

Полная карта компонентов и потоков данных. Читай диаграммы последовательно — от общего к частному.

① Полная карта платформы

② Путь запроса к данным Битрикс24 — шаг за шагом

GET /v1/deals    X-Api-Key: vibe_api_xxx

{"success":true,"data":[{"id":1,"title":"Сделка #1",...}]}

③ Туннель Black Hole — как невидимый сервер принимает запросы

④ Жизненный цикл чат-бота (polling loop)

После шага ⑤ — снова ②. Цикл работает, пока сервер запущен.

⑤ AI Router — маршрутизация к нужной модели

BYOK = Bring Your Own Keys — подключаешь свой аккаунт у провайдера, платишь напрямую ему.

⑥ Жизненный цикл OAuth-приложения

Без сервера (только HTML/JS)

• Дашборд по сделкам — графики и статистика CRM в интерфейсе Битрикс24
• Расширенная карточка клиента — дополнительные поля и визуализация
• Кастомная форма создания — только нужные поля, без лишнего

С сервером (Black Hole)

• Ночная синхронизация — каждую ночь обновляет данные из 1С или Google Sheets в CRM
• AI-классификатор лидов — при создании нового лида автоматически определяет приоритет
• Напоминалка по задачам — каждое утро пишет сотруднику список задач на день

Чат-боты

• HR-бот — отвечает на вопросы об отпусках, льготах и политике компании
• Бот-аналитик — по команде /report присылает сводку продаж за день
• Бот для заявок — принимает заявку через чат и создаёт задачу в CRM

AI-интеграции

• Суммаризатор встреч — берёт текст активности из CRM, делает краткое резюме
• Генератор КП — по данным клиента из CRM генерирует коммерческое предложение
• Анализатор переписки — определяет тональность общения с клиентом, ставит метку

• Quickstart — официальный старт
• AI Router — модели и эндпоинты
• Bot API — 33 эндпоинта для чат-ботов
• Entity API — данные Битрикс24
• Infra API — серверы и деплой
• Apps API — OAuth-приложения
• Black Hole — про серверы
• Pricing — тарифы и вайбы
• llms-full.txt — справочник для AI (дать Claude Code)