Как пользоваться Claude Code: гайд для начинающих — команды и режимы

Как пользоваться Claude Code: короткий ответ

Claude Code — это агент для программирования от Anthropic, который работает в терминале (а также в VS Code, JetBrains и десктоп-приложении). Он сам читает файлы проекта, запускает команды, правит код и объясняет, что сделал. Пользоваться им — значит не копировать куски кода в чат, а ставить задачу целиком и контролировать результат.

Базовый цикл работы выглядит так: открыть терминал в папке проекта, запустить claude, выполнить /init, чтобы появился файл CLAUDE.md с правилами проекта, а дальше давать задачи обычным языком. Сложные изменения сначала обсуждаются в режиме планирования, простые — делаются сразу. Контекст между задачами очищается командой /clear, а неудачную правку можно откатить через /rewind.

Ниже — всё, что нужно начинающему: как сформулировать задачу, какие режимы разрешений бывают, какие команды используются каждый день и как устроена «память» проекта. Установку мы здесь не повторяем — она подробно разобрана в отдельной статье.

• Шаг 1: cd в папку проекта и запуск claude.
• Шаг 2: /init — Claude изучит код и создаст CLAUDE.md.
• Шаг 3: задача обычным языком с указанием файлов через @.
• Шаг 4: для крупных изменений — plan mode (Shift+Tab), затем одобрение плана.
• Шаг 5: проверка diff, тесты, коммит; между задачами — /clear.

Подробнее: Установка и подключение Claude Code в России

Первая сессия в проекте: /init и CLAUDE.md

Запускайте Claude Code из корня репозитория: он работает с текущей папкой и её подпапками. При первом запуске в новом каталоге инструмент спросит, доверяете ли вы этой папке, — это защита от чужих конфигураций, которые могут лежать в репозитории.

Первой командой в новом проекте стоит выполнить /init. Claude проанализирует кодовую базу и создаст CLAUDE.md: команды сборки и тестов, структуру проекта, найденные соглашения. Если CLAUDE.md уже есть, /init не перезапишет его, а предложит улучшения. Этот файл Claude читает в начале каждой сессии, поэтому потраченные на него пять минут окупаются в каждой следующей задаче.

Дальше полезно задать пару вопросов на понимание — это одновременно проверка того, что Claude правильно «увидел» проект, и быстрый онбординг для вас самих.

cd ~/projects/my-app
claude

> /init
> Объясни архитектуру проекта: где точка входа, как устроены роуты и где бизнес-логика
> Какие команды запускают тесты и линтер?

Как формулировать задачи: промпты для Claude Code

Главное правило — давать контекст и критерий готовности. «Почини баг» заставит агента гадать, а «после логина редиректит на /404, воспроизводится в тесте auth.spec.ts, исправь и прогони тесты» — это задача, которую можно выполнить и проверить.

Указывайте файлы через @: набираете @ и начало пути, Claude Code подсказывает варианты автодополнением, и файл попадает в контекст сразу, без поиска по проекту. Для команд оболочки есть префикс ! — строка выполняется напрямую, а её вывод добавляется в сессию, чтобы Claude мог на него отреагировать.

• Что сделать и зачем: «добавь пагинацию в список заказов, сейчас API отдаёт 5000 строк и страница тормозит».
• Где: конкретные файлы через @ или модуль, в котором искать.
• Ограничения: «не меняй публичный API», «без новых зависимостей», «следуй стилю соседних компонентов».
• Как проверить: «прогони npm test», «добавь тест на пустой список», «покажи diff перед коммитом».
• Большую задачу разбивайте: сначала исследование и план, потом реализация по шагам.

> В @src/api/orders.ts добавь пагинацию (limit/offset, по умолчанию 50).
  Не меняй формат ответа для старых клиентов. Добавь тесты и прогони npm test.

> !git status

> Посмотри вывод выше и предложи, как разбить эти изменения на два коммита

Режимы Claude Code: Manual, accept edits, plan и auto

Режим разрешений определяет, что Claude может делать без вашего подтверждения. Переключаются режимы клавишами Shift+Tab прямо в сессии — текущий режим показан в строке состояния. Задать режим при запуске можно флагом --permission-mode, а постоянный режим по умолчанию — параметром permissions.defaultMode в файле настроек.

Plan mode — самый полезный режим для новичка. В нём Claude читает файлы и исследует проект, но не правит код, а пишет план. Вы читаете план, просите поправить или одобряете — и только тогда начинается редактирование. Для одной задачи план можно включить префиксом /plan перед промптом.

Auto mode доступен не всегда: он зависит от версии Claude Code, модели и провайдера. Если в цикле Shift+Tab его нет, для «автопринятия» правок используйте accept edits. Режим bypassPermissions (флаг --dangerously-skip-permissions) отключает все проверки — документация рекомендует его только для изолированных контейнеров и виртуальных машин.

# Запуск сразу в режиме планирования
claude --permission-mode plan

# Постоянный режим для проекта: .claude/settings.json
{
  "permissions": {
    "defaultMode": "plan"
  }
}

Главные команды Claude Code

Внутри сессии команды начинаются со слеша. Наберите / — появится список с автодополнением, а /help покажет всё доступное в вашей версии. Для ежедневной работы хватает десятка команд из таблицы ниже.

Отдельно запомните клавиши: Esc прерывает Claude посреди работы (контекст при этом сохраняется, можно поправить курс), двойной Esc очищает черновик или открывает откат, Ctrl+R ищет по истории ваших запросов, Shift+Enter переносит строку в большинстве современных терминалов.

Подробнее: Какую модель выбрать в /model · Как расходуются токены и что показывает /usage · Что такое effort и адаптивное мышление

CLAUDE.md: память проекта и настройка Claude Code

Каждая сессия начинается с чистого контекста, поэтому всё, что Claude должен знать постоянно, пишется в CLAUDE.md. Это обычный Markdown-файл с инструкциями: как собирать и тестировать проект, какие соглашения по коду, чего делать нельзя. Чем конкретнее и короче правила, тем стабильнее Claude им следует.

Файлы памяти бывают нескольких уровней, и все найденные загружаются вместе. Если в репозитории уже есть AGENTS.md для других агентов, свежие версии Claude Code умеют читать его, когда CLAUDE.md отсутствует. Кроме того, по умолчанию включена auto memory — Claude сам записывает заметки о ваших исправлениях и предпочтениях; управляется она через /memory.

Для больших проектов инструкции можно разложить по отдельным файлам в .claude/rules/ (например, testing.md и api-design.md), а в CLAUDE.md подключать другие файлы синтаксисом @путь/к/файлу.

• ~/.claude/CLAUDE.md — личные правила для всех ваших проектов.
• ./CLAUDE.md или ./.claude/CLAUDE.md — общие правила проекта, коммитятся в git.
• ./CLAUDE.local.md — личные настройки для этого проекта, добавьте в .gitignore.
• CLAUDE.md в подпапках подгружается, когда Claude работает с файлами в этой подпапке.

# CLAUDE.md

## Команды
- Сборка: npm run build
- Тесты: npm test (перед коммитом обязательно)
- Линтер: npm run lint

## Правила
- TypeScript strict, без any
- Новые компоненты — в src/components, по образцу соседних
- Не трогать папку legacy/ без явной просьбы

## Подробнее
@docs/architecture.md

Работа с git и откат изменений

Claude Code хорошо работает с git: смотрит diff, пишет сообщения коммитов, разбивает изменения на логические коммиты, готовит описание pull request и разбирает конфликты слияния. Просто попросите — «закоммить изменения с понятным сообщением» или «сравни эту ветку с main и опиши, что поменялось».

Параллельно с git у Claude Code есть собственные контрольные точки. Если правка пошла не туда, /rewind (или двойной Esc) вернёт код и диалог к состоянию до неудачного шага. Это не замена git — контрольные точки нужны для быстрых откатов внутри сессии, а долговременная история по-прежнему живёт в коммитах.

Хорошая привычка: начинать задачу с чистого рабочего дерева или отдельной ветки. Тогда весь результат работы агента — это один понятный diff, который легко проверить или выбросить.

> Создай ветку feature/orders-pagination
> Посмотри git diff и раздели изменения на два коммита: рефакторинг и новая функция
> Подготовь описание pull request: что сделано, как проверить, риски

Хуки и headless-режим claude -p

Хуки — это shell-команды, которые Claude Code запускает сам в определённые моменты: до или после вызова инструмента, при уведомлении, в начале сессии. В отличие от инструкций в CLAUDE.md, хук срабатывает гарантированно. Типичный пример — прогонять форматтер после каждой правки файла. Хуки описываются в .claude/settings.json, а посмотреть настроенные можно командой /hooks.

Headless-режим — это запуск без интерактивной сессии: claude -p «задача». Ответ печатается в stdout, поэтому Claude Code встраивается в скрипты и CI: можно передать лог через пайп, получить JSON через --output-format json, заранее разрешить нужные инструменты флагом --allowedTools. Для продолжения разговора есть --continue и --resume.

// .claude/settings.json — Prettier после каждой правки
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }
        ]
      }
    ]
  }
}

# Headless-режим
claude -p "Что делает модуль auth?"
cat build-error.txt | claude -p "кратко объясни причину ошибки сборки" > output.txt
claude -p "Прогони тесты и исправь падения" --allowedTools "Bash,Read,Edit"

Подробнее: Хуки, скиллы, субагенты и MCP подробнее

Рабочий процесс, который стоит взять за основу

Новички чаще всего теряют время по двум причинам: дают агенту слишком размытую задачу и держат одну бесконечную сессию, в которой контекст забит старыми файлами и логами. Обе проблемы решаются простой дисциплиной.

Если Claude дважды не справился с одной и той же правкой, не продолжайте спорить в забитом контексте: сделайте /clear и переформулируйте задачу с учётом того, что узнали. Свежая сессия с точным промптом почти всегда работает лучше длинной переписки.

• Исследуйте: «прочитай модуль платежей и объясни, как он устроен» — без правок.
• Планируйте: plan mode, обсуждение и одобрение плана.
• Реализуйте: по шагам, в accept edits или с ручным подтверждением.
• Проверяйте: тесты, линтер, просмотр diff — лучше попросить Claude самого прогнать проверки.
• Фиксируйте: коммит, а удачные правила — в CLAUDE.md, чтобы не повторять их каждый раз.
• Одна задача — одна сессия: /clear между несвязанными задачами, /compact при длинной работе.
• Следите за расходом: /usage и /context показывают, во что обходится текущая сессия.

Как это работает из России

Сам Claude Code бесплатен и ставится одной командой, но ему нужен доступ к моделям Claude, а Anthropic не принимает российские карты. Рабочий вариант — совместимый шлюз: в переменной ANTHROPIC_BASE_URL указывается адрес https://claude-gateway.ru/api, в ANTHROPIC_AUTH_TOKEN — токен из личного кабинета. Всё, что описано в этом гайде, — команды, режимы, CLAUDE.md, хуки — работает так же, как с официальным API, а идентификаторы моделей для /model совпадают с Anthropic.

claude-gateway.ru — независимый сервис, не связанный с Anthropic: оплата в рублях, тарифы от 150 ₽ и пробный доступ на 1 день, чтобы проверить Claude Code на своём проекте. Пошаговая установка, переменные окружения для Windows, macOS и Linux и типичные ошибки подключения разобраны в отдельных материалах.

Подробнее: Claude Code без VPN — страница подключения · Пошаговая установка Claude Code в России · API-ключ и прокси для Claude Code · Ошибки подключения и блокировки