Раздел 03 из 08

Claude Code на практике: первые шаги

От теории к рукам. Claude Code — это agent в терминале: он работает внутри одной папки, читает файлы, пишет, считает, сверяет — но только то, что ты разрешишь. У тебя Windows и Claude Code уже установлен — так что сразу к делу: открываем терминал, проводим первый диалог по-русски, настраиваем permissions и даём агенту память проекта с твоими правилами.

📦 Шаг 1. Открыть терминал и проверить, что Claude на месте

Ставить ничего не надо — Claude Code у тебя уже стоит. Нужен только терминал. На Windows это Windows Terminal или PowerShell: нажми «Пуск» и набери название — приложение найдётся.

Что такое «терминал» Окно, где команды печатают текстом, а не кликают мышкой. Ничего страшного: на старте тебе хватит двух команд — claude --version (проверить) и claude (запустить агента).

Открой PowerShell и проверь, что всё на месте:

claude --version

Если в ответ пришёл номер версии — готово. Сам агент запускается командой claude, но сначала зайдём в нужную папку (Шаг 2).

📂 Шаг 2. Рабочая папка = что агент видит

Ключевое правило: Claude Code видит только ту папку, из которой запущен, и всё внутри неё. В соседние папки и по диску он не лезет. Где он запущен — то и его область видимости.

Поэтому под каждую задачу — своя папка. Сделай её в проводнике, например Documents\AI\payem. Чтобы открыть терминал сразу в этой папке: открой папку в проводнике, кликни по адресной строке, набери powershell и нажми Enter (или правый клик по папке → «Открыть в терминале»).

# терминал уже открыт в Documents\AI\payem
# проверяем, что Claude на месте
claude --version

# запускаем агента прямо здесь
claude
C:\Users\<ты>\Documents\AI\payem\    ← агент видит ВСЁ это
├── CLAUDE.md             ← память проекта (твои правила)
├── input\
│   └── payem-may.csv     ← выгрузка из PayEm
└── output\
    └── для-SAP\          ← сюда он кладёт результат

C:\Users\<ты>\Documents\личное\      ← агент НЕ видит (другая папка)
Папка под задачу Отдельная папка под каждую боль: Documents\AI\payem, Documents\AI\salary, Documents\AI\sap-import. Контексты не смешиваются, файлы не путаются.

💬 Шаг 3. Первый диалог

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

Три стартовых промпта под твою работу — копируй и подставляй свои файлы:

# 1. Знакомство: пусть осмотрит папку и расскажет, что видит
Осмотри эту папку. Опиши, какие файлы здесь есть
и что в них, не меняя ничего.

# 2. Анализ выгрузки PayEm (только чтение, без записи)
В файле input/payem-may.csv — транзакции по кредиткам PayEm.
Покажи: сколько строк, какие колонки, итоговую сумму,
и где встречаются пустые или странные значения.
Пока ничего не записывай — только отчёт.

# 3. Сверка зарплаты с прошлым месяцем
Сравни salary-may.csv и salary-april.csv.
Найди сотрудников, у кого сумма ניכויים изменилась
больше чем на 15%, и выведи их отдельным списком.
Объясни каждое расхождение.
Как формулировать Что за данные, что нужно на выходе, какие правила. Чем конкретнее ТЗ — тем меньше самодеятельности. «Пока только покажи, ничего не меняй» — удобный режим на старте.

🔐 Шаг 4. Permissions: кто что разрешает

Главная защита — permission system. Прежде чем записать файл, запустить команду или что-то изменить, агент по умолчанию спрашивает разрешение. Ничего не уходит без твоей подписи — как проводка.

Три режима:

РежимЧто делаетАналогияКому
спрашивать
(default)
Перед каждой записью файла и запуском команды — запрос «разрешить?» Стажёр приносит каждую проводку на подпись Тебе сейчас. Новичку — только это
план
(plan mode)
Только думает и составляет план. Не пишет и не запускает ничего вообще Стажёр пишет служебку «вот как я предлагаю сделать», но рук не прикладывает Когда хочешь сперва увидеть стратегию
авто
(bypass)
Делает всё сам, без вопросов Стажёр с правом подписи. Быстро, но опасно ⚠️ Только для проверенных задач на копии

Режим переключается прямо в чате по Shift+Tab (циклом), либо командой /permissions для тонкой настройки.

⚠️ Работай на КОПИИ Не подпускай агента к единственному оригиналу выгрузки или к живой базе. Скопируй файлы в ~/work/... и работай там: если что-то пойдёт не так — испорчена копия, а не отчёт для מע״מ. И никакого прямого доступа к SAP/Michpal на запись, пока сама не проверишь результат глазами.

🧠 Шаг 5. CLAUDE.md — память проекта

Между сессиями агент ничего не помнит. Чтобы не объяснять каждый раз план счетов и правила категорий, кладёшь в папку файл CLAUDE.md — Claude Code читает его автоматически при каждом запуске в этой папке. Твой реестр правил, всегда под рукой.

Пример для папки PayEm — пиши простым языком, как инструкцию:

# Правила проекта PayEm → SAP

## Что я делаю
Обрабатываю выгрузку транзакций PayEm по кредиткам
и готовлю файл для импорта в SAP Business One.

## Категории по ключевым словам
- "Wolt", "Cibus", ресторан        → 5310 (питание сотрудников)
- "Google", "AWS", "Microsoft"     → 5420 (ПО и подписки)
- "Pango", "Dor Alon", заправка    → 5610 (транспорт)
- неизвестно                       → пометить ВРУЧНУЮ, не угадывать

## Формат FR (חשבונית מס)
- номер FR — обязателен, без него строку не проводить
- если FR пустой → вынести в отдельный список "на проверку"

## Особенности SAP
- дата в формате ДД/ММ/ГГГГ
- суммы с минусом для возвратов
- кодировка файла на импорт — UTF-8

## Чего НИКОГДА не делать
- не угадывать категорию, если нет совпадения по ключевым словам
- не писать напрямую в SAP, только готовить файл

Заготовку такого файла создаёт команда /init (см. ниже). Правила добавляешь сама, по одному, когда видишь пробел.

Здесь 90% качества Хороший CLAUDE.md превращает «AI как Google» в инструмент, который знает твой план счетов. Это накопленный реестр правил, работающий каждый день.

⌨️ Шаг 6. Slash-команды — пульт управления

Команды со слешем управляют самим агентом, а не ставят задачи. Минимум на старт:

/help

Список всех команд и подсказок

/clear

Очистить контекст — чистый старт. Делай между разными задачами, чтобы майская зарплата не мешалась с апрельской

/init

Создать заготовку CLAUDE.md: агент осмотрит папку и предложит черновик

Позже пригодятся: /permissions (режимы доступа), /cost (расход), /model (сменить модель), /memory (быстро отредактировать CLAUDE.md).

💳 Шаг 7. Стоимость, лимиты, какая модель работает

Claude Code работает на подписке Anthropic (план Max — для серьёзной ежедневной работы). Модель вручную выбирать не нужно: по умолчанию агент идёт на разумной модели (обычно семейство Sonnet), а на отдельных шагах сам подключает другие — Opus там, где надо подумать глубже, и быстрый Haiku на мелкие служебные операции. Это ориентир, а не строгая автоматика под каждую задачу; при желании переключишь сама через /model.

Как не упереться в лимит

  • У подписки есть недельные лимиты — проверяй актуальные, они меняются.
  • Тяжёлую задачу дроби: не «обработай весь год», а «май», потом «июнь». На огромных объёмах агент тратит контекст быстрее.
  • /cost показывает расход за сессию.

Маленькие задачи — маленькие модели

Opus на «посчитай сумму колонки» — перебор. Простой пересчёт и сверка — Sonnet/Haiku, быстрее и экономнее. Тонкие аномалии в зарплате — да, мощная модель.

🔌 Шаг 8. Альтернативные движки

Тот же интерфейс Claude Code можно подключить к другому AI-движку: рабочее место и команды те же, меняется только модель за ними. Обычно так делают ради экономии или своих coding-планов у других провайдеров.

Kimi (Moonshot)

Подключается заменой base-url и ключа, либо через их coding-план. Интерфейс Claude Code прежний.

GLM (Z.ai)

Аналогично — свой ключ и base-url или coding-подписка. Тот же терминал, другой движок.

Настройку покажет Олег на hands-on Это не на первый день. Сначала освойся на родном Claude, смену движка (переменные окружения с base-url и ключом) разберём вживую. Идея простая: интерфейс один, движок сменный.
План на первый день
  1. Открыть PowerShell, проверить: claude --version
  2. Завести папку Documents\AI\payem и положить туда копию выгрузки
  3. Запустить claude, оставить режим «спрашивать»
  4. Дать первый промпт «осмотри папку, ничего не меняй»
  5. Сделать /init и начать наполнять CLAUDE.md своими правилами