# Claude Code — чит-лист команд и порогов

> Одна страница для печати или быстрого референса. Все факты — из официальных Anthropic docs и Anthropic Academy. Источник у каждого пункта.
>
> Дата: 2026-05-29. Используется в курсе Mars AI Operator (модули 1, 4).

---

## Slash-команды (внутри сессии `claude`)

| Команда | Что делает | Когда нажимать | Источник |
|---------|-----------|----------------|----------|
| `/init` | Анализирует репу, создаёт `CLAUDE.md` с найденными конвенциями, build-командами, тестами. Если CLAUDE.md уже есть — предлагает улучшения, не перетирает. | Первый раз в проекте. После клонирования чужой репы. | docs/04 L48 |
| `/memory` | Список всех CLAUDE.md, CLAUDE.local.md, rules-файлов, загруженных в сессии. Тогл auto memory on/off. Открыть auto memory folder. | Когда хочешь убедиться что твой CLAUDE.md загрузился. Когда хочешь добавить инструкцию вручную. | docs/04 L88 |
| `/compact` | Суммаризует историю разговора, сохраняя ключевые решения. **Project-root `CLAUDE.md` re-инжектится после `/compact`** (читается заново с диска). Nested CLAUDE.md в подпапках — не автоматически. | Когда контекст заполнился до ~70-80% и агент начал «забывать» начало. До того как ответы стали плохие. | docs/04 L416, action/lesson-09 |
| `/clear` | Новая сессия с чистым контекстом. **Старая остаётся в истории** (можно вернуться). | После большого refactor'а — перед новой задачей. Чтобы агент не путал контексты двух задач. | action/lesson-09 |
| `/resume` | Вернуться в предыдущий разговор. | После `/clear` если понял что забыл что-то спросить. | action/lesson-09 |
| `/agents` | Управление sub-agents: list, create, edit, delete. Файлы лежат в `.claude/agents/<name>.md`. | Когда задача большая и хочется делегировать в чистый context. Sub-agent делает работу, возвращает condensed summary. | subagents/lesson-02 |
| `/hooks` | Управление hooks (lifecycle commands: PreToolUse, PostToolUse, и т.д.). Альтернатива редактированию `.claude/hooks.json` руками. | Когда хочешь автоматически запускать lint после edit'а, или блокировать опасные команды. | 101/llm-notes, action/lesson-13 |

### Команды, которых **нет** или они устарели

| Что-то | Статус | Что вместо |
|--------|--------|------------|
| `#` (старый shortcut для memory write-back) | **Устарел** | `/memory` |
| `Shift+Tab×2` для plan mode | **Не подтверждено** в Anthropic source-of-truth | Использовать UI Claude Code или явный prompt «сначала покажи план» |

---

## Клавиши прерывания

| Клавиша | Что делает |
|---------|-----------|
| `Escape` | Прервать текущий output агента |
| `Escape Escape` (двойной tap) | Откатить назад на несколько шагов в conversation. (action/lesson-09 упоминает как «double-tap escape» в общем разделе техник управления). |

---

## Иерархия памяти (4 scope)

Loaded в порядке. Более узкий scope **дополняет и при конфликте перебивает** более широкий.

| Scope | Путь | Когда использовать | Источник |
|-------|------|--------------------|----------|
| **Managed** | задаётся организацией | Mars-wide policy в будущем (через managed config) | docs/04 |
| **User** | `~/.claude/CLAUDE.md` | Про **тебя** как ментора: язык работы, стиль, общие конвенции | docs/04 |
| **Project** | `./CLAUDE.md` (или `./.claude/CLAUDE.md`) | Про **этот проект**: возраст детей, стек, конвенции | docs/04 |
| **Local** | `./CLAUDE.local.md` | Личные настройки для проекта (gitignore'нутые). `/init --personal` добавляет в `.gitignore` за тебя. | docs/04 L? |

`CLAUDE.md` **загружается полностью**, независимо от длины. Но короче = агент лучше следует.

`MEMORY.md` (entrypoint auto memory directory `~/.claude/projects/<project>/memory/`) — только **первые 200 строк или 25KB** at session start. Остальное Claude читает по требованию через `/memory`.

---

## Что **survives** `/compact`

| Сохраняется | Не сохраняется |
|-------------|----------------|
| Project-root `CLAUDE.md` (re-инжектится с диска) | Conversation history (заменяется summary) |
| User `~/.claude/CLAUDE.md` (загружается каждую сессию) | Tool calls и их сырые outputs |
| Auto memory files (читаются по требованию) | Локальные открытые файлы |
| Краткое summary разговора, написанное `/compact` | Nested CLAUDE.md из подпапок (re-load когда Claude следующий раз читает файл из той папки) |

Источник: docs/04 L416 + blog/01 (context-engineering).

---

## Эмпирические пороги (приблизительные, варьируются по моделям)

| Метрика | Значение | Источник |
|---------|----------|----------|
| Context window Sonnet 4.6 | 1M tokens | docs/10-models-overview |
| Context window Opus 4.7 | 1M tokens | docs/10-models-overview |
| Context window Haiku 4.5 | 200K tokens | docs/10-models-overview |
| Когда обычно пора `/compact` | ~70-80% использования context | действует эмпирически, не из docs |
| Лимит "comfortable" размера CLAUDE.md | ~200 строк / 25KB до session start | docs/04 L367 (это для MEMORY.md; CLAUDE.md formal-лимита нет, но agents работают лучше с короткими) |
| Возврат типичного sub-agent | 1,000-2,000 tokens condensed summary | blog/01 (context-engineering) |

⚠️ **Важно**: деградация контекста — **continuous gradient**, не cliff. Нет «жёсткого порога 50K» — это миф. Подробнее в blog/01 «attention budget» и М4 курса.

---

## Built-in sub-agents

| Имя | Что делает | Когда уместен | Источник |
|-----|-----------|---------------|----------|
| **Explorer** (или Explore) | Ищет файлы по описанию, возвращает paths + ключевые цитаты | Большая repo, не знаешь где код. Альтернатива всем `grep`/`find` через main context. | subagents/lesson-01 |
| **Plan** | Составляет план изменений до того как редактировать | Большая задача с risk'ом сломать. До того как `Edit` начал писать. | subagents/lesson-01 |
| **general-purpose** | Универсальный sub-agent для произвольных задач | Когда нужно «отдай в чистый контекст и верни итог» | subagents/lesson-01 |

⚠️ Built-in sub-agents **не имеют доступа к Agent Skills**. Если нужны skills — создавать custom subagent в `.claude/agents/`. Источник: skills/lesson-05.

---

## Custom sub-agent — структура

Файл: `.claude/agents/homework-checker.md`

```markdown
---
description: Проверяет домашние работы учеников Mars — читает все .py файлы в указанной папке, выдаёт одну строку summary на ученика
tools: Read, Bash
model: claude-haiku-4-5
---

Ты — проверяющий ДЗ ментор Mars. На вход получишь путь к папке с ДЗ группы.

Для каждого `.py` файла в папке:
1. Прочитай файл
2. Проверь: запускается ли (`python3 -m py_compile`)
3. Найди 1 главную ошибку или 1 главную хорошую вещь
4. Выдай одну строку: `<имя_ученика>: <вердикт>`

В конце — общий вердикт группы (одна фраза) и рекомендация что повторить на следующем занятии.
```

Источник: subagents/lesson-02, формат подтверждён.

---

## Agent Skill — структура

Папка: `.claude/skills/pygame-starter/`, файл `SKILL.md`:

```markdown
---
name: pygame-starter
description: Создаёт starter pygame-проект для группы Mars (возраст-зависимый, простой шаблон с детальными комментариями на русском)
---

# Pygame starter для детских групп Mars

## Когда использовать
- Ментор готовит шаблон для нового занятия по pygame
- Возраст ученика 7-12, первый раз делает игру

## Что внутри
- `main.py` — минимальный playable game loop (window, render, input)
- `assets/` — заглушки картинок
- `README.md` для ребёнка — "что эта программа делает" одной фразой
```

Загружается только **name + description** в каждой сессии. Тело `SKILL.md` — когда Claude решает что skill применим. Файлы в папке — когда Claude явно их Read. Это **progressive disclosure** — главная идея Skills.

Источник: blog/02 (agent-skills verbatim), skills/lesson-01.

---

## Surfaces (где может работать Claude Code)

| Surface | Когда удобно |
|---------|--------------|
| Terminal CLI (`claude` в любой папке) | Дефолт, самое мощное |
| VS Code / Cursor extension | Когда уже сидишь в IDE и хочешь diff-вью |
| Desktop app | Без терминала |
| Web (`claude.ai/code`) | С чужого компа без установки |
| JetBrains extension | PyCharm, IntelliJ users |

Одна и та же `CLAUDE.md` / `settings.json` / MCP-config работает во всех. Источник: docs/03.

---

## MCP (Model Context Protocol)

Краткое: **open standard для подключения внешних data sources** к Claude (Google Drive, Jira, Slack, кастом). Подключается через `.mcp.json` в проекте или global config.

Когда нужен: agent должен читать/писать в систему которая не файлы (тикеты, чаты, базы).

Подробно: docs/07-claude-code-mcp, mcp_intro Academy course.

---

## Команды, которых здесь нет (не во всех версиях / не в docs нашего source-of-truth)

- `/cost` — упоминается в продакшен интерфейсе Claude Code, в docs точной спецификации не нашли. Используем как мониторинг, но без обещаний клиенту.
- `/transcript` — не подтверждено в source-set.
- `/model` — переключение модели, обычно есть в UI.

---

## Где смотреть оригиналы

- `docs/03-claude-code-overview.md`, `docs/04-claude-code-memory.md` — основа hierarchy, /memory, /init, /compact
- `academy/claude-code-in-action/lesson-09-controlling-context.md` — точные форулировки `/clear`, `/compact`
- `academy/claude-code-in-action/lesson-10-custom-commands.md` — кастомные slash-команды
- `academy/introduction-to-subagents/lesson-02-creating-a-subagent.md` — /agents и .claude/agents/
- `academy/introduction-to-agent-skills/lesson-01..05.md` — Skills
- `blog/01-context-engineering-VERBATIM.md` — теория attention budget, compaction, sub-agents
- `blog/02-agent-skills-VERBATIM.md` — progressive disclosure

Все файлы лежат в `/Users/rus/mars/ai-operator/lessons/_sources/anthropic/`.
