ИИ-агенты• • 5 мин чтения

Claude Code: как пользоваться ИИ-агентом в терминале

Что такое Claude Code, как установить и запустить, зачем нужны режим планирования, CLAUDE.md, MCP и хуки. Ограничения, стоимость и доступность из России.

Claude Code — агент Anthropic для разработки. Он работает в терминале, редакторе, десктопном приложении и браузере: читает репозиторий, правит файлы, запускает команды и проверяет результат. Это не автодополнение, а исполнитель задач, которому вы даёте доступ к проекту.

Главное правило: чем больше прав, тем важнее контроль. Агент может сломать сборку, удалить файл или отправить данные наружу — не из злого умысла, а потому что не понял задачу.

Что умеет

  • Читать и объяснять чужой код.
  • Писать функции, тесты и миграции.
  • Исправлять ошибки по логу или описанию.
  • Запускать тесты, линтеры и сборку.
  • Делать коммиты, ветки и pull request.
  • Подключаться к внешним системам через MCP.
  • Работать по расписанию и в фоне.

Установка

Официальный способ — нативный установщик.

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Есть вариант через WinGet:

winget install Anthropic.ClaudeCode

После установки откройте новый терминал и проверьте:

claude --version

Если команда не найдена, установщик не прописал PATH. Перезапуск терминала обычно решает проблему; на Windows проверьте переменную Path.

Первый запуск

cd путь/к/проекту
claude

При первом запуске нужно войти: через подписку Claude или через аккаунт Anthropic Console с API-ключом. Ключ можно передать переменной ANTHROPIC_API_KEY, но тогда расход идёт по тарифам API.

Внутри сессии:

  • /init — проанализировать проект и создать CLAUDE.md;
  • /help — список команд;
  • /model — выбрать модель;
  • /clear — очистить контекст;
  • /compact — сжать историю;
  • /permissions — посмотреть и изменить права;
  • /mcp — управление MCP-серверами;
  • /cost — расход текущей сессии;
  • /resume — вернуться к прошлой сессии.

Режим планирования

Самая полезная привычка — сначала план, потом изменения. В режиме планирования агент исследует проект и предлагает шаги, но не трогает файлы. Переключение — Shift+Tab (проверьте подсказку в интерфейсе).

Порядок работы:

  1. Опишите задачу и критерий готовности.
  2. Включите режим планирования.
  3. Прочитайте план и поправьте его.
  4. Разрешите выполнение.
  5. Проверьте diff и тесты.

Добавь валидацию формы регистрации. Сначала изучи, как устроены другие формы в проекте, и предложи план. Не меняй файлы до подтверждения. Критерий: новые тесты проходят, старые не ломаются.

Такой промпт экономит больше времени, чем кажется.

CLAUDE.md

Файл CLAUDE.md в корне проекта читается в начале каждой сессии. В нём фиксируют:

  • стек и версии;
  • структуру проекта;
  • команды запуска и тестов;
  • правила стиля;
  • что нельзя трогать;
  • определения готовности.
# Проект

Python 3.13, без внешних зависимостей. Сборка: `python build.py`.
Тесты: `python tools/check.py`.

## Правила

- Не менять файлы в `dist/` — они генерируются.
- Новые страницы добавлять только через `src/`.
- Перед коммитом запускать check.py.
- Не добавлять зависимости без обсуждения.

Если в проекте уже есть AGENTS.md, Claude Code умеет читать его вместо CLAUDE.md. Это удобно, если вы используете несколько агентов.

Права и подтверждения

По умолчанию агент спрашивает разрешение на опасные действия. Настройки прав лежат в .claude/settings.json (проект) и пользовательских файлах.

Можно разрешить безопасные команды и запретить разрушительные:

{
  "permissions": {
    "allow": ["Bash(python tools/check.py)", "Bash(git status)"],
    "deny": ["Bash(rm -rf *)", "Read(.env)", "Bash(git push --force)"]
  }
}

Точный синтаксис зависит от версии — сверяйтесь с документацией. Смысл не в копировании примера, а в том, чтобы опасные команды требовали подтверждения.

Важно

Флаг --dangerously-skip-permissions отключает проверки. Используйте его только в одноразовом контейнере без доступа к реальным данным, ключам и сети. На рабочей машине это способ потерять проект.

Git и проверка результата

Агент работает с git, но ответственность за коммит остаётся на вас.

  1. Создайте ветку.
  2. Дайте задачу.
  3. Посмотрите git diff.
  4. Запустите тесты и линтер.
  5. Проверьте, нет ли лишних файлов и секретов.
  6. Сделайте коммит осознанно.

Просите агента не коммитить без вашего подтверждения. И проверяйте, что он не добавил в репозиторий .env, ключи и дампы.

MCP

Model Context Protocol — открытый стандарт подключения инструментов и данных. Через MCP агент может читать задачи в трекере, документацию, базу данных или внутренний API.

claude mcp add имя-сервера -- команда-запуска

Список серверов и права на них проверяйте в /mcp. Каждый сервер — это дополнительный доступ. Не подключайте то, что не готовы отзывать.

Хуки, субагенты и навыки

  • Хуки запускают команды до или после действий: форматирование после правки, линтер перед коммитом.
  • Субагенты выполняют отдельные подзадачи параллельно: один исследует, другой пишет тесты.
  • Навыки упаковывают повторяемые сценарии вроде /review-pr или /deploy-staging.

Начинать стоит с CLAUDE.md и планирования. Хуки и субагенты нужны, когда процесс уже стабилен.

Автоматизация

CLI умеет работать без интерактивного интерфейса:

claude -p "объясни, почему падает тест" --output-format json
tail -200 app.log | claude -p "найди аномалии и опиши их"

Это удобно для CI и скриптов. Но автоматические запуски должны иметь ограниченные права и понятный список задач.

Сколько это стоит

Есть два пути: подписка Claude (лимиты зависят от тарифа) и API (плата за токены). Агентские задачи расходуют много токенов: он читает файлы, повторяет шаги и анализирует вывод команд. Один большой рефакторинг может стоить заметно дороже обычного чата.

Следите за расходом через /cost и ставьте лимиты в консоли провайдера. Не запускайте длинные автономные задачи без потолка.

Доступность из России

Anthropic официально не предоставляет сервис в России. Для работы нужны зарубежный аккаунт, оплата и, как правило, VPN. Это не только техническое, но и договорное ограничение: условия сервиса могут запрещать доступ из отдельных регионов.

Если нужен агент без этих ограничений, смотрите OpenCode — он работает с локальными моделями и разными провайдерами.

Риски

  • Разрушительные команды. Агент может выполнить rm, git reset или перезаписать файл.
  • Утечка секретов. .env, токены и клиентские данные попадают в контекст.
  • Prompt injection. Инструкция может прийти из README, issue или веб-страницы.
  • Ложная уверенность. Код запускается — не значит, что он правильный.
  • Расход. Длинная сессия с большим контекстом стоит денег.
  • Зависимость. Чем меньше вы понимаете код, тем сложнее проверить результат.

Практика

Первый день. Установите, запустите /init, попросите объяснить структуру проекта. Ничего не меняйте.

Первый код. Небольшая задача с тестом. План → подтверждение → diff → тесты.

Первый рефакторинг. Ветка, ограниченный модуль, проверка тестов. Не давайте агенту весь репозиторий без плана.

Автоматизация. Только после того, как научились проверять diff. Начните с линтера и форматтера, а не с деплоя.

Итог

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

Правило простое: сначала ветка и бэкап, потом агент. Если результат нельзя проверить тестом или глазами — не запускайте.

Редакция НейроСеть. Инструкции проверены на практике. Характеристики моделей и требования к железу меняются — сверяйтесь с документацией проекта и карточкой модели. Если заметили ошибку — напишите нам.

Другие гайды раздела