Что такое Claude Code и как работает AI-агент
Claude обозначает семейство моделей Anthropic, а Claude Code связывает модель с файлами проекта и терминалом. ИИ-агент пишет код, находит ошибки и запускает проверки. Вы задаёте цель и проверяете результат.
Обычный чат-бот отвечает на сообщение и присланные фрагменты. Здесь диалог связан с действиями в рабочей папке. При этом агент не обязательно читает весь проект целиком: для задачи он ищет подходящие файлы и собирает контекст.
Агентный цикл состоит из сбора контекста, действия и проверки. Например, при экспорте заказов в CSV сначала нужно найти модель заказа. Затем агент добавляет выгрузку и запускает тест. Если проверка обнаружит ошибку, он может исправить код и повторить запуск. Успешный тест не исключает ошибок в требованиях.
| Задача | Что поручить | Что проверить самому |
|---|---|---|
| Знакомство с репозиторием | Описать структуру проекта и точки входа | Совпадает ли объяснение с реальными связями модулей |
| Новая функция | Добавить обработку конкретного сценария | Сохранено ли существующее поведение |
| Исправление бага | Найти причину и предложить минимальную правку | Воспроизводилась ли ошибка до исправления |
| Тестирование | Написать проверки для выбранного модуля | Проверяют ли тесты требования пользователя |
| Рефакторинг | Упростить выбранный участок без смены поведения | Не изменились ли формат данных и публичный API |
Сколько стоит доступ: подписка и API
На сентябрь 2026 года Claude Code включён в Pro и Max, доступен для Team и Enterprise. Также предусмотрен аккаунт Anthropic Console с оплатой использования API. Перед входом проверьте выбранный способ расчёта расходов.
На официальной странице Pro указан за 20 долларов при помесячной оплате. При годовой оплате списывают 200 долларов сразу. Отметка 17 долларов в месяц на сайте является округлённым представлением годовой цены.
Max начинается от 100 долларов в месяц и предлагает варианты Max 5x и Max 20x с повышенными лимитами относительно Pro. Это ограниченный объём использования, а не безлимит. Применимые налоги не включены в указанные цены.
В API расходы зависят от модели и числа входных и выходных токенов. Длинная история и повторные попытки увеличивают затраты. Токен представляет часть обрабатываемого текста, а не отдельное сообщение. Подписка тоже имеет лимиты: одинаковое число задач может расходовать разный объём использования.
Кому подойдёт инструмент
Начните с задачи, результат которой можете проверить. Разработчику подойдут тест или разбор ошибки. Новичку полезнее попросить объяснение кодовой базы. Основной критерий выбора: понимаете ли вы полученное решение.
Владельцу сайта стоит сформулировать ожидаемое поведение: что видит посетитель, какие данные вводит и какой ответ получает. Техническую проверку лучше поручить разработчику. Наличие работающего экрана ещё не подтверждает правильность расчётов, прав доступа или сохранения данных.
Если нужен сайт для бизнеса, перейдите к услуге «Разработка сайтов»: /uslugi/razrabotka-sajtov/. В seosite1 делаем сайты с 2009 года и работаем удалённо по России. Итоговую цену и сроки называем после брифа. Проект ведёт руководитель, решения и цифры проверяет человек.
Как установить Claude Code на Windows, macOS и Linux
Официально Claude Code в России недоступен: страны нет в списке поддерживаемых территорий Anthropic. Для задач с текстом и кодом можно рассмотреть российские модели GigaChat или YandexGPT. Инструкция ниже относится к работе из поддерживаемых стран.
На сентябрь 2026 года поддерживаются macOS 13.0 и новее, Windows 10 от версии 1809, Windows Server от 2019 года. Для Linux перечислены Ubuntu от 20.04, Debian от 10 и Alpine Linux от 3.19.
Нужны от 4 ГБ оперативной памяти, процессор x64 или ARM64 и интернет. В Alpine дополнительно нужны bash, curl, libgcc, libstdc++ и ripgrep; настройте USE_BUILTIN_RIPGREP=0. После установки откройте новый терминал и выполните claude --version. CLI означает интерфейс командной строки.
На Windows Git for Windows необязателен: без него инструмент использует PowerShell, с ним доступен Bash. Нативная установка обновляется автоматически. Варианты через Homebrew и WinGet обновляйте соответствующим менеджером пакетов.
| Среда | Как установить |
|---|---|
| macOS, Linux, WSL | curl -fsSL https://claude.ai/install.sh | bash |
| Windows PowerShell | irm https://claude.ai/install.ps1 | iex |
| Homebrew | brew install --cask claude-code |
| WinGet | winget install Anthropic.ClaudeCode |
Первый запуск: от папки проекта до проверенной правки
Подготовьте учебный проект или отдельную ветку репозитория. Сохраните текущие изменения, чтобы отличить их от правок помощника.
- Шаг 1. Перейдите в папку проекта и запустите claude. Следуйте подсказкам входа через браузер и выберите аккаунт с нужной подпиской либо Console. После авторизации вернитесь в терминал.
- Шаг 2. Попросите описать структуру проекта без изменений файлов. Сверьте найденные точки входа с документацией репозитория.
- Шаг 3. Выберите одну понятную ошибку. Укажите путь к файлу, условия воспроизведения и ожидаемый результат.
- Шаг 4. Попросите предложить план и объяснить, какие участки будут затронуты. Уточните ограничения перед редактированием.
- Шаг 5. После правки попросите запустить тесты и показать их вывод. Затем проверьте поведение вручную.
- Шаг 6. Посмотрите разницу файлов и удалите изменения, которые не относятся к задаче. Только потом принимайте результат.
Пример первого запроса
«Найдите обработчик формы обратной связи. Сейчас пустое поле телефона проходит проверку. Сначала объясните причину, затем предложите исправление и тест. Дизайн формы и формат ответа API менять нельзя».
Такой промпт описывает проблему, границы и критерий завершения. Формулировка «сделайте сайт лучше» оставляет слишком много решений на усмотрение модели.
Как выбрать модель Sonnet или Opus
В настройках доступны названия моделей и короткие обозначения. В документации sonnet предназначен для повседневного программирования, opus для сложных рассуждений. Конкретная версия зависит от поставщика доступа и настроек аккаунта.
Откройте /model, чтобы посмотреть доступный выбор. Переключение на Claude Sonnet выполняется через /model sonnet, на Opus через /model opus. Поле model в настройках позволяет закрепить выбор. Доступность проверяйте в своей сессии.
Сравните модели на одинаковом задании: оцените правильность решения и объём доработки. Ускоренный режим включается через /fast. Перед включением проверьте его стоимость и доступность для своего аккаунта.
Терминал, редактор, приложение и браузер
Claude Code доступен через терминал, интеграции с IDE, настольное приложение Claude и веб-интерфейс. Выбирайте площадку по тому, где находится код и как удобнее просматривать правки. Набор настроек и доступных инструментов нужно проверять для выбранной среды.
Для передачи задачи из Slack предусмотрено упоминание @Claude в настроенной интеграции. Сообщение без подключённого репозитория не даёт доступа к коду.
| Вариант | Когда удобен | Что уточнить перед работой |
|---|---|---|
| Терминал | Вы уже используете оболочку и локальные инструменты | Правильную папку, окружение и разрешения |
| Расширение VS Code или интеграция JetBrains | Нужно читать код и обсуждать изменения рядом с редактором | Порядок установки интеграции из документации |
| Настольное приложение | Предпочитаете отдельное окно для заданий | Какой проект открыт и где выполняются действия |
| Браузер | Нужен доступ через веб-интерфейс | Доступность репозитория и окружения для проверки |
CLAUDE.md: инструкции и память проекта
Файл CLAUDE.md содержит постоянные инструкции, которые агент читает при начале сессии. В нём полезно хранить правила работы, которые нельзя надёжно вывести из самого кода. Проверяйте содержание после изменений процесса разработки.
Запишите, как проверять результат, где находятся требования и какие решения нельзя менять без обсуждения. Для большого репозитория отделите общие правила от указаний для конкретных каталогов. Не превращайте файл в копию всей документации.
AGENTS.md поддерживается с версии 2.1.277, но по умолчанию уступает CLAUDE.md и CLAUDE.local.md в рабочей папке и выше. Если общий файл не загрузился, импортируйте его строкой @AGENTS.md в CLAUDE.md. Прямая поддержка также зависит от настроек встроенного плагина. Сведения сверены на сентябрь 2026 года.
Автоматическая память сохраняет полезные заметки между сессиями. Просматривайте её содержание и исправляйте неверные выводы. Она помогает повторно использовать договорённости, но не гарантирует правильного понимания новой задачи.
- Назначение сайта: кто им пользуется и какие операции выполняет.
- Ограничения: какие публичные методы, данные и настройки нельзя менять.
- Проверка: как запускать тесты, сборку и анализ кода; какие библиотеки разрешено добавлять.
- Приёмка: какие результаты и пояснения вы ожидаете после работы.
Основные команды и управление контекстом
Обычное задание вводите текстом. Служебные команды начинаются с косой черты и управляют сессией. Через /help можно посмотреть справку, а через /context оценить заполнение контекста.
Просмотрите правила через /permissions: настройки определяют, какие действия требуют подтверждения. Просьба «не меняйте файлы» в диалоге не заменяет ограничений инструментов. Для предварительного разбора используйте /plan и проверьте предложенный план перед выполнением.
| Ввод | Назначение | Когда использовать |
|---|---|---|
| /help | Показать справку | Нужно найти доступную функцию |
| /model | Выбрать модель | Меняется сложность работы |
| /context | Посмотреть использование контекста | Диалог стал длинным |
| /compact | Сжать историю разговора | Продолжаете ту же задачу |
| /clear | Начать разговор с пустым контекстом | Переходите к другой задаче |
| /diff | Посмотреть изменения файлов | Готовитесь принять результат |
| claude doctor | Диагностика установки из терминала | Нужно проверить локальную настройку |
| /permissions | Настроить разрешённые, запрещённые и требующие подтверждения действия | Перед работой с важными файлами |
Как сократить лишние запросы
Контекст ограничен: в него попадают сообщения, прочитанные данные и результаты действий. Передавайте относящиеся к задаче сведения. Вместо огромного журнала пришлите воспроизводимый пример и участок с ошибкой.
После /compact уточните цель и оставшиеся вопросы. /clear очищает историю разговора, но сохраняет память проекта. Для другой задачи передайте новые исходные данные и проверьте постоянные инструкции.
Если ответ не подходит, укажите неверное условие или пример ошибки. Повтор того же запроса не добавляет модели сведений.
Практика: написание кода, отладка и рефакторинг
Заранее опишите ожидаемый результат и проверку. Ниже учебные задания, которые можно адаптировать к своему проекту.
Добавить функцию в существующий сайт
Допустим, нужен фильтр каталога по наличию. Укажите источник остатков и поведение при отсутствии данных. Попросите найти похожий фильтр и использовать существующий подход.
Проверьте сочетания фильтров, сброс выбора и пустую выдачу. Сравните запросы API до и после правки: сортировка и адреса страниц должны сохраниться.
Найти ошибку по сообщению
Передайте ошибку, действия для воспроизведения, язык и точку входа, например TypeScript и app.js. Замените учебное имя реальным путём. Попросите отделить подтверждённые причины от предположений.
Если проблема проявляется только на сервере, сравните настройки и зависимости с локальной средой. Не принимайте удаление проверки как исправление. Сначала выясните, какое условие она защищала и почему сработала.
Упростить сложный модуль
Попросите найти дублирование и упростить один участок без изменения интерфейса. Повторите цикл: правка, тест, просмотр разницы. Только затем переходите к следующему участку.
В расчёте скидки проверьте нулевую сумму, возврат и несовместимые акции. Комментарий должен объяснять причину ограничения, а не пересказывать код.
Создать приложение с нуля
Сначала опишите пользовательский путь и минимальный набор экранов. Затем согласуйте структуру данных и критерии готовности. Попросите реализовать один сквозной сценарий: ввод, обработку и показ результата.
Начните с тестового JSON с товарами. Проверьте первый экран перед генерацией следующего. Перед запуском оцените безопасность и права доступа.
MCP, навыки и хуки для повторяемых задач
MCP связывает AI-инструменты с внешними источниками данных и действиями. Для Claude Code это способ подключать документацию, задачи и другие сервисы. Само упоминание сервиса в запросе не предоставляет доступ к нему.
Перед подключением определите, какие данные нужны для задачи. Начните с чтения, если изменение записей не требуется. Проверьте поставщика сервера и права учётной записи. Для теста используйте отдельные данные, по которым легко заметить ошибку.
Навыки задают повторяемый порядок работы. Подагент получает отдельную задачу и собственный контекст, затем возвращает результат основному агенту. Например, ему можно поручить поиск вызовов функции. Полученные выводы нужно сверить с исходным заданием.
Хуки запускают действия при заданных событиях, например форматирование после редактирования файла. Укажите событие и команду, затем проверьте её на учебном проекте.
Проверьте журнал запуска хука и код завершения. Обязательные проверки закрепите также в процессе сборки.
Что автоматизировать в первую очередь
Начните с проверки формата файлов: запустите её вручную и определите признаки ошибки. Затем настройте автоматический запуск. Проверьте журнал и поведение при неуспехе, прежде чем применять сценарий к рабочему сайту.
Как создать собственного подагента
На сентябрь 2026 года /agents больше не открывает мастер создания. Попросите Claude создать файл .claude/agents/code-reviewer.md для текущего проекта. В начале Markdown-файла нужны поля YAML name и description. В поле tools ограничьте инструменты значением Read, Grep, Glob.
Пример задания: «Создайте подагента code-reviewer. Он читает код, ищет ошибки обработки пустых данных и возвращает пути, причины и примеры. Изменять файлы и выполнять команды нельзя». Проверьте созданную конфигурацию, затем начните новую сессию и попросите использовать этого подагента.
Проверьте, что tools содержит только разрешённые инструменты. Ограничение записи без запрета оболочки не делает помощника доступным только для чтения. Для повторного использования в разных проектах предусмотрена личная папка ~/.claude/agents/.
Git и проверка результата перед публикацией
Claude Code работает с Git: готовит коммиты и запросы на слияние изменений, pull request. Для GitHub и GitLab можно автоматизировать разбор задач и проверку кода через CI. Сначала настройте доступ к нужному репозиторию.
Сначала посмотрите изменения целиком. Затем проверьте рискованные места: авторизацию, расчёты, удаление данных и обработку ошибок. Если тесты не запускались, результат нельзя описывать как прошедший тестирование.
Пример запроса: «Разберите задачу GitHub, воспроизведите ошибку, добавьте исправление и тест. Подготовьте pull request с описанием проверки». При миграции библиотеки сначала найдите зависимые модули, затем меняйте их частями. После каждого этапа проверяйте совместимость интерфейсов.
- Сверьте правки с исходным заданием: нет ли посторонних изменений.
- Проверьте успешный сценарий, неверный ввод и отказ внешнего сервиса.
- Убедитесь, что тест действительно запускается и проверяет нужное поведение.
- Посмотрите, не попали ли в изменения секреты, журналы или временные файлы.
- Подготовьте способ возврата к предыдущему состоянию до публикации.
Частые ошибки и ограничения
Агент может неверно понять требования или пропустить побочный эффект. Делите сложную работу на проверяемые части. Локальная установка требует связи с API поставщика моделей. Не отправляйте секреты и рабочие данные без разрешения их владельца.
Выбирайте AI-помощника по задачам и условиям доступа. Для объяснения хватит чата, для правок нужен доступ к репозиторию. Оцените, сможете ли вы проверить код и поддерживать его после генерации.
| Ошибка | Почему мешает | Как исправить |
|---|---|---|
| Слишком общее задание | Непонятен ожидаемый результат | Опишите вход, выход и ограничения |
| Лишние файлы в контексте | Труднее выделить важные сведения | Укажите нужный каталог и пример |
| Несколько несвязанных задач | Сложнее проверить причину изменения | Разберите задачи последовательно |
| Слепое принятие тестов | Проверка может повторять ошибочную реализацию | Сопоставьте условия теста с требованиями |
| Устаревшие инструкции | Помощник получает неверные ориентиры | Обновите правила и удалите противоречия |
| Неограниченный доступ | Ошибка затронет лишние данные | Выдайте права для конкретной работы |