Claude Code: как установить агента от Anthropic

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

Рассказываем, как его установить и авторизовать, как ставить задачи, чтобы агент не уходил в сторону, и как встроить его в реальный рабочий процесс.

Главное отличие от обычного чат-бота — контекст всего проекта и итеративная работа. Вы не получаете готовый код одним запросом, а ведёте диалог: агент предлагает решение, вы проверяете, уточняете задачу, агент дорабатывает. Как напарник, который видит весь репозиторий и понимает архитектуру.

Что умеет Claude Code и чем отличается от чата

Claude Code запускается в папке проекта через терминал, принимает задачи на естественном языке, читает файлы, предлагает изменения и может править код напрямую.

Базовый сценарий: открыть терминал в корне проекта, запустить команду claude и дать задачу как коллеге — например, «сделай рефакторинг модуля авторизации, добавь типизацию и обнови тесты». Агент умеет:

• Читать структуру проекта и понимать связи между модулями.
• Предлагать правки с учётом архитектуры.
• Рефакторить код и писать новые функции.
• Генерировать тесты и чинить падающие.
• Работать с Git и GitHub: создавать коммиты, оформлять pull requests, разрешать конфликты слияния.
• Подключать внешние инструменты через MCP-коннекторы (Model Context Protocol), что расширяет возможности за пределы работы с файлами.

Ключевое отличие от чата в том, что Claude Code видит весь проект, а не отдельный фрагмент. Вы не копируете файлы в окно — агент сам находит нужные модули, зависимости и конфигурацию. Это особенно ценно там, где важен контекст: миграция на новую версию библиотеки, рефакторинг с сохранением API, исправление ошибок, затрагивающих несколько модулей.

Как установить и запустить: четыре способа

Обратите внимание, что Claude официально не поддерживается в России. Вам потребуется использовать VPN для установки и работы с ним.

Claude Code можно использовать в терминале, через десктоп-приложение, в IDE или в браузере. Выбор зависит от того, как вы привыкли работать.

Установка через терминал

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 закрывает одной точной формулировкой:

Частые вопросы

Можно ли использовать 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 дважды) для сложных изменений. Тогда агент действительно экономит время, а не создаёт новый технический долг.