Claude Code
Claude Code: полный гайд по установке и работе
Claude Code — терминальный ИИ-агент, который работает прямо в вашей среде разработки, а не в отдельном веб-чате. Он видит проект, редактирует файлы, запускает команды и выполняет многошаговые задачи. Разберём, что это, как его установить и как выстроить работу так, чтобы результат был под контролем.
1. Что понадобится (требования)
Перед установкой проверьте, что готово:
- ОС — macOS, Linux или Windows (с поддержкой терминала и виртуализации).
- Node.js — актуальная версия; npm для установки пакета.
- Аккаунт Anthropic — доступ к модели Claude и API-ключ (или подписка).
- Редактор/терминал — любой, где удобно выполнять команды: VS Code, JetBrains или нативный терминал.
- Вычислительная база — базовая станция или сервер, если работаете с тяжёлыми контекстами и локальными моделями. Варианты есть в каталоге серверов и программном обеспечении.
Если работаете локально и следите за производительностью — сразу оцените нагрузку на вычислительный узел по AI на отечественном железе.
2. Шаг 1 — Установка Claude Code
Установка идёт через npm одной командой:
npm install -g @anthropic-ai/claude-codeПосле этого проверьте, что команда доступна:
claude --versionЕсли версия вывелась — установка прошла. Дальше нужен доступ к модели. Запустите:
claudeПри первом запуске система попросит авторизацию. Варианты входа — через браузер с вашим аккаунтом Anthropic или через API-ключ. В команде удобнее общий API-ключ, чтобы все работали с одним доступом и одной вычислительной базой.
3. Шаг 2 — Настройка доступа к проекту
Claude Code работает с вашим проектом, поэтому важно задать права. По умолчанию агент имеет доступ к тем файлам, которые вы разрешили. Настройте рабочую директорию:
cd /path/to/your/project
claudeЗдесь агент подхватывает файлы проекта по контексту. Чтобы ограничить зону работы, используйте правила и конфиг в корне — там определяете, где агенту разрешено менять файлы, а где нет. Это защищает от случайных правок в критичных местах.
4. Шаг 3 — Первая задача (рабочий цикл)
Проверьте цикл на простой задаче. Опишите цель обычным языком:
Прочитай модуль авторизации, найди, где отсутствует проверка ролей, и добавь её с тестами.
Агент выполнит шаги: прочитает файлы, найдёт разрыв, предложит правку и покажет её вам. Вы утверждаете изменение — и только после этого код меняется. Это встроенный контроль: ничего не улетает «в прод» без вашего согласия.
Дальше можно подключить агента к внешним данным и сервисам через MCP (Model Context Protocol) — открытый протокол, по которому модель берёт доступ к базам, календарям и инструментам в оговорённых рамках.
5. Шаг 4 — Составные агенты и субагенты
Для сложных задач у Claude Code есть субагенты — вложенные агенты с собственной ролью. Один пишет код, второй — тесты, третий — документацию. За распределение отвечает оркестрация: она держит порядок и не даёт агентам «разъехаться».
Чтобы воспользоваться этим, опишите задачу как «многошаговую с ролями» — например, «раздели на: генерация, тесты, документация». Подробная схема такого процесса — в многоагентной разработке: субагенты и оркестрация.
Типовой расклад ролей для реальной задачи: один субагент пишет модуль, второй подчищает за ним тесты, третий собирает краткую документацию, а оркестратор сводит всё к единому результату и не даёт агентам противоречить друг другу. Если субагенты работают с локальной моделью, узкое место — память и ускорители: чем больше ролей крутится в параллели, тем выше требования к VRAM и скорости обмена.
6. Типовые ошибки и как их избежать
| Ошибка | Причина | Решение |
|---|---|---|
| Агент меняет лишние файлы | Слишком широкая зона доступа | Чётко ограничить рабочую директорию и правила |
| Результат не совпадает с ожиданием | Размытая постановка задачи | Точное ТЗ: шаги, границы, критерии приёмки |
| Правки уходят без вашего контроля | Отключён этап утверждения | Всегда подтверждать изменения перед применением |
| Слишком много контекста, всё тормозит | Неограниченный проект в одной сессии | Разбивать на модули и субагентов |
| Данные утекают на внешние серверы | Агент ходит во внешние интеграции | Разворачивать в своём контуре, политики доступа |
7. Чек-лист
- Установил актуальную версию Node.js и npm.
- Установил Claude Code и проверил
claude --version. - Прошёл авторизацию (браузер или API-ключ).
- Настроил рабочую директорию и правила доступа.
- Убедился, что изменения подтверждаются человеком.
- Прогнал пилотную задачу и зафиксировал результат.
- Согласовал, где разворачивать — в облаке или в своём ЦОД.
Вопросы и ответы
Claude Code — это то же самое, что обычный чат с ИИ? — Нет. Чат отвечает на вопросы, а Claude Code работает в вашем проекте: читает файлы, запускает команды, выполняет многошаговые задачи.
Нужна ли мощная машина для работы? — Для базовых задач хватит обычной рабочей станции. Для тяжёлых контекстов и локальных моделей — смотрите на GPU-узел.
Можно ли отключить доступ агента к определённым файлам? — Да, через правила и конфиг рабочей директории. Это ключевой элемент контроля.
Где безопаснее разворачивать — в облаке или своём контуре? — При работе с персональными данными и защищаемым контуром — в своём ЦОД. Схема закупки по 44-ФЗ/223-ФЗ — в закупке ИИ-решения.
Частые вопросы
Claude Code — это то же самое, что обычный чат с ИИ?
Нет. Чат отвечает на вопросы, а Claude Code работает в вашем проекте: читает файлы, запускает команды, выполняет многошаговые задачи.
Нужна ли мощная машина для работы?
Для базовых задач хватит обычной рабочей станции. Для тяжёлых контекстов и локальных моделей — смотрите на GPU-узел.
Можно ли отключить доступ агента к определённым файлам?
Да, через правила и конфиг рабочей директории. Это ключевой элемент контроля.
Где безопаснее разворачивать — в облаке или своём контуре?
При работе с персональными данными и защищаемым контуром — в своём ЦОД. Схема закупки по 44-ФЗ/223-ФЗ — в закупке ИИ-решения.