Содержание
Читайте в Telegram
|
Claude Code — агент от Anthropic, который работает прямо в терминале вашего проекта: читает структуру репозитория, правит файлы и доводит задачу до рабочего состояния в диалоге с вами.
Рассказываем, как его установить и авторизовать, как ставить задачи, чтобы агент не уходил в сторону, и как встроить его в реальный рабочий процесс.
Главное отличие от обычного чат-бота — контекст всего проекта и итеративная работа. Вы не получаете готовый код одним запросом, а ведёте диалог: агент предлагает решение, вы проверяете, уточняете задачу, агент дорабатывает. Как напарник, который видит весь репозиторий и понимает архитектуру.
Что умеет Claude Code и чем отличается от чата
Claude Code запускается в папке проекта через терминал, принимает задачи на естественном языке, читает файлы, предлагает изменения и может править код напрямую.
Базовый сценарий: открыть терминал в корне проекта, запустить команду claude и дать задачу как коллеге — например, «сделай рефакторинг модуля авторизации, добавь типизацию и обнови тесты». Агент умеет:
- Читать структуру проекта и понимать связи между модулями.
- Предлагать правки с учётом архитектуры.
- Рефакторить код и писать новые функции.
- Генерировать тесты и чинить падающие.
- Работать с Git и GitHub: создавать коммиты, оформлять pull requests, разрешать конфликты слияния.
- Подключать внешние инструменты через MCP-коннекторы (Model Context Protocol), что расширяет возможности за пределы работы с файлами.
Ключевое отличие от чата в том, что Claude Code видит весь проект, а не отдельный фрагмент. Вы не копируете файлы в окно — агент сам находит нужные модули, зависимости и конфигурацию. Это особенно ценно там, где важен контекст: миграция на новую версию библиотеки, рефакторинг с сохранением API, исправление ошибок, затрагивающих несколько модулей.
Как установить и запустить: четыре способа
Обратите внимание, что Claude официально не поддерживается в России. Вам потребуется использовать VPN для установки и работы с ним.
Claude Code можно использовать в терминале, через десктоп-приложение, в IDE или в браузере. Выбор зависит от того, как вы привыкли работать.
| Способ | Как ставится | Когда подходит |
|---|---|---|
| Терминал (CLI) | Нативный установщик, а также Homebrew, WinGet или npm | Основной путь для тех, кто работает в терминале |
| Десктоп-приложение | Отдельное приложение для macOS, Windows и Linux | Если удобнее GUI с визуальными диффами и параллельными сессиями |
| Плагины для IDE | Расширение для VS Code или плагин для JetBrains | Для работы внутри редактора без переключения в терминал |
| Claude Code on the web | Подключение GitHub-репозитория через браузер | Для задач в облаке и работы с чужой машины |
Установка через терминал
Anthropic рекомендует нативный установщик: он не требует Node.js и сам обновляется в фоне.
Для macOS, Linux и WSL выполните в терминале:
curl -fsSL https://claude.ai/install.sh | bash
Для Windows в PowerShell:
irm https://claude.ai/install.ps1 | iex
Если предпочитаете пакетные менеджеры, доступны альтернативы. Через Homebrew на macOS и Linux:
brew install --cask claude-code
Через WinGet на Windows:
winget install Anthropic.ClaudeCode
Есть и путь через npm, но он требует Node.js версии 22 или новее и по сути ставит тот же нативный бинарник:
npm install -g @anthropic-ai/claude-code
Ставить через npm с sudo не нужно — это ведёт к проблемам с правами и рискам безопасности. Homebrew, WinGet и npm, в отличие от нативного установщика, не обновляются автоматически: их придётся обновлять вручную.
После установки перейдите в папку проекта и запустите агента:
cd "путь к вашему проекту"claude
Проверить, что всё установилось можно командой claude --version — она выведет номер версии. Для подробной диагностики установки и настроек есть команда claude doctor.
Десктоп-приложение
Скачайте приложение с сайта Anthropic, установите и откройте. В интерфейсе выберите папку проекта — агент получит доступ к файлам и будет работать так же, как в терминале, но с графическим диалогом вместо командной строки. Приложение доступно для macOS, Windows и Linux; минимальные требования — macOS 12 и новее, Windows 10 и новее или Ubuntu 20.04 и новее, не меньше 4 ГБ оперативной памяти.
В отличие от голого терминала, десктоп-приложение дополнительно даёт визуальный просмотр диффов, несколько параллельных сессий в отдельных вкладках, встроенный редактор файлов, мониторинг pull requests на GitHub и планировщик задач — например, для ночного прогона тестов или еженедельного обновления зависимостей.
На Windows приложение ставится стандартным MSIX-установщиком, а для устройств на архитектуре ARM64 предусмотрена отдельная сборка — под них нужно скачивать ARM64-установщик. Claude Code в десктоп-приложении на Windows работает наравне с macOS: локальный доступ к файлам, MCP-коннекторы и плагины поддерживаются в полном объёме.
Интеграции для VS Code и JetBrains
Для VS Code установите расширение из маркетплейса, для JetBrains — плагин из Marketplace.
После установки агент появится в боковой панели редактора, и вы сможете задавать вопросы и получать изменения прямо в IDE, не переключаясь в терминал.
Claude Code on the web
Веб-режим доступен на claude.ai/code: вы подключаете GitHub-репозиторий, описываете задачу, и Claude выполняет её на облачной инфраструктуре Anthropic, а по завершении сам оформляет pull request.
Каждая задача идёт в изолированной песочнице, можно запускать несколько задач параллельно, а сессии сохраняются даже после закрытия браузера — следить за ними можно и из мобильного приложения.
Также веб-версию можно использовать для удалённого управления своим компьютером с другого устройства. Это полезно, когда нужно оставить Claude за выполнением долгой задачи и наблюдать за процессом со стороны.
Авторизация: аккаунт и API-ключ
Claude Code требует платного плана — Pro, Max или Team. Бесплатный план Claude.ai доступа к агенту не даёт.
При первом запуске CLI откроется браузер: войдите в аккаунт Claude и подтвердите доступ. Агент сохранит токен локально, и повторно авторизовываться не придётся.
Отдельная логика с API-ключом. Если в вашем окружении установлена переменная ANTHROPIC_API_KEY (такое бывает, если вы раньше работали с API Anthropic напрямую через SDK), Claude Code при запуске один раз попросит подтвердить этот ключ вместо открытия браузера. API-ключ пригодится для интеграции агента в скрипты и CI/CD-пайплайны; для повседневной работы достаточно входа через браузер.
Как формулировать задачи
Claude Code работает эффективнее, когда задача сформулирована не как абстрактная проблема, а как конкретное изменение. Указывайте цель, конкретные файлы или модули и ожидаемый результат.
Слишком общие формулировки, которые почти гарантируют лишние итерации: «улучши код», «сделай проект лучше», «исправь баги». Конкретные формулировки работают куда лучше:
- «Найди причину падения теста в модуле авторизации и исправь её».
- «Разбей компонент UserProfile.tsx на три части — данные, UI и логику — и добавь типы для пропсов».
- «Добавь валидацию email и телефона в форму регистрации, обнови тесты в auth.test.ts».
Чем точнее задача, тем меньше итераций уйдёт на результат. Для сложных задач удобно сначала переключиться в режим планирования: нажмите Shift+Tab, чтобы Claude Code сначала изучил код и предложил план, который вы утвердите до начала правок. В режиме планирования агент работает только на чтение и ничего не меняет, пока вы не одобрите план.
Итеративная работа: агент как напарник, а не волшебная кнопка
Claude Code удобнее воспринимать как напарника по разработке, а не по принципу «один запрос — готовый продукт». Типичный цикл выглядит так:
- Агент изучает кодовую базу: структуру, зависимости, конфигурацию.
- Предлагает или вносит изменения.
- Вы проверяете результат — запускаете тесты, смотрите дифф.
- Даёте следующую итерацию: уточняете задачу или просите доработать.
Для длительной работы помогает несколько привычек: коммитьте изменения перед запуском агента, чтобы легко откатить неудачные правки; фиксируйте прогресс коммитом после каждой успешной итерации; дробите работу на маленькие шаги — три задачи по десять минут предсказуемее одной на час. И главное — не доверяйте правкам слепо: ревьюйте изменения, запускайте тесты и просматривайте дифф вручную.
Расширенные возможности: CLAUDE.md, MCP и автоматизация
Файл CLAUDE.md
CLAUDE.md — файл с инструкциями и контекстом для агента. Создайте его в корне репозитория и опишите архитектуру, соглашения по коду и особенности проекта. Агент будет опираться на него, чтобы понимать специфику проекта и держать контекст между сессиями.
MCP-коннекторы
MCP-коннекторы (Model Context Protocol) подключают внешние инструменты: базы данных, API, CLI-утилиты. Агент может, например, запросить данные из PostgreSQL, проверить статус деплоя через kubectl или отправить уведомление в Slack. Это выводит возможности за пределы работы с файлами.
Автоматизация рутины
Claude Code можно встроить в CI/CD через GitHub Actions: автоматически исправлять ошибки линтера в pull requests, обновлять документацию при изменении API или собирать changelog перед релизом.
Практические советы для реальной работы
- Начинайте с маленьких задач — так проще оценить качество и понять стиль работы агента. Первая задача — не «переписать весь проект», а «добавить типы в один модуль».
- Давайте контекст: вместо «исправь тесты» напишите «тесты падают из-за изменения API, обнови моки в auth.test.ts под новую структуру ответа».
- Ставьте внешние CLI-инструменты, которыми агент сможет пользоваться, — например, gh для GitHub или kubectl для Kubernetes.
- Следите за расходом токенов, особенно при параллельных сессиях: на больших проектах счёт растёт быстро.
- Просите агента заранее задать уточняющие вопросы — например, какие файлы он планирует изменить и какие зависимости добавить.
- Проверяйте дифф перед применением изменений и не разрешайте удаление файлов без подтверждения.
Как ограничить доступ агента к файлам
Если в проекте есть чувствительные файлы — секреты, ключи, .env, — доступ к ним стоит закрыть заранее. В Claude Code это делается через правила deny в файле настроек settings.json (пользовательском ~/.claude/settings.json или проектном .claude/settings.json). Например, правило Read(.env) запрещает агенту читать этот файл.
Тонкость безопасности: запрет на чтение и запрет на запись задаются отдельно. Если вы закрыли Read для файла с секретами, имеет смысл закрыть и Write того же пути — иначе агент, не имея права читать файл, всё ещё сможет в него писать.
Типичные проблемы и решения
Многие повседневные задачи Claude Code закрывает одной точной формулировкой:
| Задача | Как поставить агенту |
|---|---|
| Ошибки линтера в проекте | «Исправь все ошибки ESLint в src/» — агент пройдёт по файлам и применит автофиксы. |
| Конфликты слияния после rebase | «Разреши конфликты в ветке feature-branch» — агент разберёт изменения и предложит решение. |
| Устаревшие зависимости | «Обнови зависимости в package.json и исправь breaking changes» — агент поднимет версии и адаптирует код. |
| Нет актуальной документации | «Сгенерируй README на основе кода в src/» — агент опишет модули и API. |
| Миграция на новую версию библиотеки | «Переведи проект с React 17 на 18, исправь устаревшие API» — агент найдёт проблемные места и обновит код. |
Частые вопросы
Можно ли использовать Claude Code без интернета?
Нет, агент работает через серверы Anthropic и требует постоянного подключения — все запросы обрабатываются на их стороне.
Как Claude Code обрабатывает конфиденциальный код?
Код передаётся на серверы Anthropic для обработки. Если в проекте есть чувствительные данные, ограничьте доступ агента к критичным файлам через правила deny в settings.json — например, закройте .env, секреты и логи.
Можно ли откатить изменения, внесённые агентом?
Да, если вы работаете в Git. Перед запуском агента сделайте коммит — тогда неудачные правки легко откатить через git reset --hard или git checkout.
Поддерживает ли Claude Code языки кроме английского?
Да, агент понимает задачи на русском и других языках. Качество работы практически не зависит от используемого языка.
Короткий практический итог
Claude Code — сильный инструмент для ускорения рутинной работы с кодом. Задача в целом решается несложно: установили, авторизовались, открыли проект и дали конкретную задачу. Чаще всего люди путаются не в установке, а в формулировках и ожиданиях — пытаются скормить агенту слишком общую задачу и ждут идеального результата с первого раза.
Самый разумный подход: начинайте с маленьких конкретных задач, всегда проверяйте дифф и тесты, используйте CLAUDE.md для фиксации правил проекта и Plan Mode (Shift+Tab дважды) для сложных изменений. Тогда агент действительно экономит время, а не создаёт новый технический долг.
