Claude Code Cheat Sheet (Шпаргалка)

Быстрая справка для работы с Claude Code и промпт-инжинирингом. Проверено на Claude Code 2.1.289.

💡 Сисмодуль определяется автоматически — Mac- и Windows-специфичные команды показаны для неё. Переключи выше, если нужна другая.

⌨️ Горячие клавиши

Mac-специфичные клавиши:

Windows-специфичные клавиши:

🖥️ CLI: запуск и флаги

claude                          # Интерактивный режим
claude "запрос"                 # Запуск с начальным запросом
claude -p 'запрос'              # Pipe-режим: ответ в stdout и выход
claude -c                       # Продолжить последнюю сессию
claude -r <id>                  # Возобновить сессию по ID
claude update                   # Обновить Claude Code

# Полезные флаги
--model <модель>                # Указать модель при запуске
--permission-mode plan          # Запустить только в режиме чтения
--worktree / -w                 # Изолированный git worktree
--autocompact <auto|tokens>      # Режим авто-сжатия контекста; -n = --name
--add-dir <путь>                # Добавить папку в контекст
--output-format json|text|stream-json
--max-budget-usd <N>            # Бюджет сессии в долларах
--bare                          # Минимальный режим: без hooks, LSP, синхронизации плагинов, auto-memory

# Pipe-режим — удобно для скриптов:
cat error.log | claude -p 'объясни ошибку'

📋 Управление сессией

/clear                  # Полная очистка контекста
/compact [тема]         # Сжать контекст, сохранив суть
/context                # Показать заполненность контекста
/resume                 # Список последних сессий для возобновления
/rename <название>      # Переименовать сессию (удобно при /resume)
/branch                 # Создать ответвление сессии
/cost                   # Стоимость текущей сессии ($, токены)
/diff                   # Все изменения файлов за сессию
/copy                   # Скопировать последний ответ
/export                 # Экспорт диалога в Markdown

Дерево решений /clear vs /compact:

💡 CLAUDE.md (а с ним и подключённый @AGENTS.md) перезагружается автоматически после /compact и auto-compact — инструкции не теряются.

⚙️ Настройки

/config                         # Открыть settings.json в редакторе
/model <модель>                 # Переключить модель в сессии
/fast                           # Быстрый режим: та же модель, ответ быстрее
/effort low|medium|high         # Глубина анализа
/permissions                    # Просмотр и настройка разрешений
/vim                            # Включить vim-режим редактирования
/theme                          # Сменить цветовую тему

💡 Глубина рассуждения. Максимум — на план и проверку, на реализацию — уровнем ниже. У LangChain такой «сэндвич» дал 66,5 % в Terminal Bench 2.0, а «везде максимум» — 53,9 %: агент не укладывался во время.

Режимы разрешений:

🔧 Инструменты и расширения

/init               # Создать CLAUDE.md для проекта
/memory             # Открыть CLAUDE.md для редактирования
/mcp                # Управление MCP-серверами
/hooks              # Управление Hooks
/skills             # Управление навыками
/agents             # Управление агентами
/chrome             # Инструменты браузера через MCP
/reload-plugins     # Перезагрузить плагины без рестарта

🧩 Слэш-команды

/btw <текст>        # Добавить контекст не прерывая работу
/plan               # Создать markdown-план задачи
/loop               # Итеративный цикл до выполнения условия
/voice              # Голосовой ввод (Space = push-to-talk)
/doctor             # Диагностика: API-ключи, MCP, конфиги
/insights           # Отчёт: какие задачи и инструменты ты используешь чаще всего
/rc                 # Открыть ~/.claude/rc.ts (настройки запуска)
/remote-control     # Управление через API
/pr-comments        # Загрузить комментарии PR в контекст
/stickers           # 🥚

🧩 Плагины и Skills

/plugin marketplace add <name>  # Установить из маркетплейса
/plugin list                    # Список установленных
/plugin enable/disable <name>   # Вкл/выкл плагин
/simplify                       # Упростить код
/debug                          # Отладка: анализ ошибки
/batch                          # Массовое изменение файлов

Расположение Skillов:

• .claude/skills/ — Skills проекта
• ~/.claude/skills/ — глобальные Skills
• .claude/agents/ — агенты

Frontmatter Skill:

---
description: "Что делает навык"
allowed-tools: [Bash, Read, Write, mcp__github__*]
model: sonnet
effort: medium          # low | medium | high
context: fork           # изолированный контекст
---
# Тело навыка
Задача: $ARGUMENTS      # аргументы подставляются сюда

🤖 Параметры агентов

permissionMode: default|acceptEdits|plan|dontAsk|bypassPermissions
isolation: none|worktree    # worktree = отдельный git worktree
memory: path/to/MEMORY.md   # память между запусками
background: true            # фоновый запуск
maxTurns: 10                # лимит ходов

Когда какой агент:

🌀 Ultrathink

Активировать глубокое мышление — слова-триггеры в промпте:

think → think hard → think harder → ultrathink

Или клавиша Alt+T. Полезно для: архитектурных решений, сложных багов, неоднозначных ТЗ.

Паттерн Plan → Normal → Auto:

1. Plan mode   → только разведка, без изменений
2. Normal mode → реализация с подтверждением
3. Auto-accept → рутина без подтверждений (Shift+Tab)

🔄 Типичный день с Claude Code

9:00  [Ты] Думаешь над стратегией
      └─→ 30 мин раздумий, планирование

9:30  [Агент] Делает первый черновик
      └─→ Claude Code пишет код/текст

10:00 [Ты] Проверяешь результат
      └─→ Review, feedback, уточнения

10:15 [Агент] Доделывает на основе feedback
      └─→ Уточнённый результат

10:30 [Ты] Публикуешь/деплоишь
      └─→ Финальное решение

🏃 Быстрый старт (5 минут)

# 1. Создай и войди в проект
mkdir my-project && cd my-project

# 2. Создай файлы памяти
touch AGENTS.md TODO.md STATE.md
echo '@AGENTS.md' > CLAUDE.md

# 3. Заполни AGENTS.md вместе с агентом
claude
# «Изучи проект и заполни AGENTS.md: стек, как запустить, правила»

# 4. Или заполни вручную:
# Stack, как запустить, правила агенту

# 5. Дай первую задачу

# 1. Создай и войди в проект
mkdir my-project; cd my-project

# 2. Создай файлы памяти (PowerShell)
ni AGENTS.md, TODO.md, STATE.md -ItemType File
Set-Content CLAUDE.md '@AGENTS.md'

# 3. Заполни AGENTS.md вместе с агентом
claude
# «Изучи проект и заполни AGENTS.md: стек, как запустить, правила»

# 4. Или заполни вручную:
# Stack, как запустить, правила агенту

# 5. Дай первую задачу

💡 Альтернатива через WSL/Git Bash: mkdir my-project && cd my-project && touch AGENTS.md TODO.md STATE.md && echo '@AGENTS.md' > CLAUDE.md

📝 Четыре сдвига (Quick Ref)

📋 Структура хорошего промпта

## Роль
Ты - [описание + экспертиза]

## Задача
[Конкретная задача]

## Входные данные
[Входные данные]

## Ожидаемый результат
[Ожидаемый результат]

## Ограничения
[Ограничения]

Мнемоника CTID — см. 04/u2: Контекст · Задача · Инструкции · Данные.

🎯 Матрица делегирования

✅ Делегировать:

• Рутинные операции (форматирование, конвертация)
• Первый черновик (текст, код)
• Поиск информации
• Тесты
• Документирование

🧠 Решать самому:

• Архитектура
• Финальная оценка качества
• Стратегические решения
• Этические вопросы
• Неопределённые задачи

🔁 Процесс: план, проверка, ревью

• План по этапам, у каждого этапа — своя проверка. Не «сделай всё», а «этап 1 → тест → этап 2 → тест». Сломалось — видно где.
• Ревью свежим взглядом. Готовую работу отдай на проверку в новой сессии или другой модели (Claude ↔ Codex). Автор кода не видит своих ошибок; новый контекст их находит.
• Сначала пусть расспросит тебя. Перед работой попроси агента взять у тебя интервью: в Claude Code это инструмент AskUserQuestion, у любого другого — «задай мне 5 вопросов, прежде чем начать». Дешевле ответить на вопросы, чем переделывать.
• субагент — под один Skill. Не «универсальный QA-инженер», а «проверяет миграции БД» или «читает логи Chrome». Узкая роль с конкретным инструментом работает; широкая — размазывается.
• Набор своих примеров. 10–20 случаев с ожидаемым результатом — прогоняй после каждой правки промпта или кода.
• Сначала данные, потом интерфейс. Убедись, что pipeline собирает правильные данные, и только потом строй экран над ними: красивый интерфейс над пустой базой — самая дорогая ошибка новичка.
• Проси пресеты. Всё, что ты запускаешь чаще двух раз, — попроси агента вынести в типовую конфигурацию, а параметр, который может измениться, — в настройки, а не в код.
• Проект дольше одного вечера — возьми готовый процесс: Superpowers или Spec Kit (ссылки в «Материалах»).

📄 Обязательные файлы проекта

AGENTS.md

Один файл контекста и правил проекта для любого агента: Codex, Cursor, Copilot, Antigravity, Hermes читают его сами.

Где разместить:

• ./AGENTS.md — проект (коммитится в git)
• ./CLAUDE.md — одна строка @AGENTS.md: так его читает Claude Code
• ~/.claude/CLAUDE.md — личный (все проекты, только Claude Code)

Лимит: ~200 строк (важно для контекста)

Минимальная структура:

# AGENTS.md
## Моя роль
## Проект
## Стек
## Как запустить
## Правила
## Чего избегать

/init в Claude Code генерирует CLAUDE.md из существующего проекта. Перенеси полезное в AGENTS.md, а в CLAUDE.md оставь @AGENTS.md. Сгенерированный файл — черновик: исследование ETH Zurich (2026) показало, что файлы контекста в среднем не повышают успех агента, удорожают работу больше чем на 20 %, а обзор репозитория не помогает. Оставь то, чего агент не узнает сам: нестандартные правила, команды проверки, запреты.

TODO.md

# Tasks
## 🔴 КРИТИЧНО
## 🟡 ВАЖНО
## 🟢 ПОЗЖЕ
## ⏸️ БЛОКИРОВАНА
## ✅ ЗАВЕРШЕНО

STATE.md

# Состояние проекта
## Где мы сейчас
## Что сделано
## Что мешает
## Следующий шаг

⚠️ Типичные ошибки

💡 Быстрые подсказки

Когда что использовать

Для анализа кодовой базы:

Попроси агента: «исследуй кодовую базу» (субагент Explore)

Для создания плана большой работы:

/plan

Для быстрого добавления информации:

/btw Обнови контекст: [информация]

Для исследования конкретного файла:

Попроси агента: «исследуй кодовую базу и найди файлы, отвечающие за [X]» (субагент Explore)

🎯 Контроль качества промпта

Перед отправкой:

• Роль ясна?
• Задача конкретна?
• Данные полные?
• Output определён?
• Ограничения понятны?
• Нет дистракторов?
• Важное в начале/конце?

🔢 Токены

📖 Что такое токен, контекстное окно, температура, промпт и контекст, агент — простыми словами в юните «Азбука: шесть слов до старта».

1 токен ≈ 4 символа
1000 токен ≈ 750 слов

Стоимость:
- Input token = дешевле
- Output token = дороже (в 2-3 раза)

Оптимизация:
- Сжимай контекст
- Убирай лишнее
- Структурируй данные

🌍 Примеры промптов

Backend промпт

## Роль
Ты - опытный backend разработчик с 10 лет опыта.
Знаешь Node.js, PostgreSQL, микросервисы.

## Задача
Создай REST API endpoint для получения списка пользователей.

## Input
- Нужны поля: id, name, email, created_at
- Поддержка pagination (page, limit)
- Фильтрация по email

## Output
- Express route handler
- TypeScript типы
- Примеры curl запросов

## Constraints
- Используй PostgreSQL query builder (knex.js)
- Максимум 50 строк кода
- Добавь валидацию query параметров

Frontend промпт

## Роль
Ты - фронтенд разработчик, специалист по доступности.

## Задача
Создай React компонент для фильтра товаров.

## Input
- Фильтры: категория (checkbox), цена (range), рейтинг (radio)
- Примеры данных в data.json

## Output
- React компонент Filter.tsx
- Tailwind CSS стили
- WCAG AA доступность

## Constraints
- TypeScript
- Без UI библиотек (pure CSS)
- Keyboard navigation (Tab, Enter, Escape)

Research промпт

## Роль
Ты - UX researcher с опытом в user interviews.

## Задача
Проанализируй interview.txt и найди основные user pain points.

## Input
- Файл interview.txt с записью интервью

## Output
- Top 5 проблем пользователей
- Для каждого: описание, цитата, возможное решение

## Constraints
- Максимум 1 страница
- Только прямые цитаты из интервью
- Приоритизировать по частоте упоминания

🔐 Git команды (быстро)

Одинаковы на обеих сисмодулях — Git одинаковый везде:

git status                          # Статус
git add AGENTS.md CLAUDE.md TODO.md STATE.md # Добавить перечисленные файлы
git commit -m "Описание"            # Коммит
git push origin main                # Пуш
git pull origin main                # Пул

🖥️ Различия Mac / Windows

Где команды реально расходятся (остальное — одинаково):

💡 Совет для Windows-разработчиков: установи WSL2 + Git Bash для bash-команд из туториалов. PowerShell тоже подходит, но многие AI-блоги пишут под bash.

💡 Совет для Mac: используй iTerm2 или Warp вместо штатного Terminal — лучше работают с Claude Code (паттерны, цвета, hotkeys).

📊 Контроль результата

# Результат хороший если:
- ✅ Код работает без исправлений
- ✅ Структура понятна
- ✅ Есть примеры использования
- ✅ Закрыты edge cases
- ✅ Performance приемлемо

# Результат плохой если:
- ❌ Нужно доделывать руками
- ❌ Потеря деталей из промпта
- ❌ Галлюцинации в коде
- ❌ Много лишнего кода

🎓 Дальнейшее обучение

1. Пройди все упражнения на странице [/exercises/](/exercises/)
2. Создай свой prompt-template
3. Используй в реальных проектах
4. Записывай хорошие промпты
5. Делись опытом с командой

📞 Быстрая помощь

claude --help       # Все CLI-флаги
/doctor             # Диагностика установки
/context            # Заполненность контекста
/cost               # Стоимость сессии
/btw                # Добавить контекст не прерывая
/plan               # Режим планирования

🔭 Где подсмотреть реализации

Когда нужен не совет, а рабочий пример: два открытых каталога приложений на LLM — от простых ботов до мультиагентных систем. Оба на английском, оба живые (коммиты идут еженедельно), код можно читать и забирать.

awesome-llm-apps      github.com/Shubhamsaboo/awesome-llm-apps
                      Apache-2.0 · RAG, ИИ-агенты, мультиагентные команды, MCP, голосовые агенты

awesome-ai-apps       github.com/Arindam200/awesome-ai-apps
                      MIT · практические примеры, руководства и рецепты: от чат-бота до агента

Смотри там не «что скопировать», а как чужие решения устроены: где границы агента, что вынесено в инструменты, чем меряется результат.

Проверено на Claude Code 2.1.289, 2026-10-04

Используй эту шпаргалку для быстрого старта и справки.