Как поставить агента Claude: установка Claude Code по шагам

Чтобы поставить агента Claude, установите Claude Code — консольного ИИ-агента от Anthropic. На macOS, Linux и в WSL достаточно одной команды curl -fsSL https://claude.ai/install.sh | bash, на Windows — irm https://claude.ai/install.ps1 | iex в PowerShell. Дальше в папке проекта набираете claude и входите в аккаунт: нужна платная подписка Pro, Max, Team, Enterprise или аккаунт Claude Console с оплатой API. Важная оговорка: Россия и Беларусь не входят в список стран, где Anthropic официально поддерживает свои сервисы.

Что такое Claude Code

По официальной документации, Claude Code — «агентный инструмент для программирования», который читает код проекта, правит файлы, запускает команды и работает с вашими инструментами разработки. Работает в терминале, в VS Code и JetBrains, в отдельном настольном приложении и в браузере на claude.ai/code. Ему пишут задачу обычным языком, а он сам ищет нужные файлы, показывает изменения и спрашивает разрешения перед действиями.

Что нужно заранее

• Система: macOS 13 и новее, Windows 10 (версия 1809) или Windows Server 2019 и новее, Ubuntu 20.04+, Debian 10+, Alpine 3.19+.
• Железо: от 4 ГБ оперативной памяти, процессор x64 или ARM64, интернет.
• Аккаунт: подписка Pro, Max, Team или Enterprise либо Claude Console (API с предоплатой). Бесплатный тариф claude.ai Claude Code не включает. Для компаний есть вариант через Amazon Bedrock, Google Cloud и Microsoft Foundry.
• Страна из списка поддерживаемых — документация прямо ссылается на него в требованиях.

Установка по шагам

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

• macOS, Linux, WSL: curl -fsSL https://claude.ai/install.sh | bash
• Windows PowerShell (строка начинается с PS C:\): irm https://claude.ai/install.ps1 | iex
• Windows CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Права администратора на Windows не нужны. Документация советует поставить Git for Windows: тогда агент выполняет команды через Git Bash, без него — через PowerShell. Для песочницы команд нужен WSL 2.

Другие способы: Homebrew (brew install --cask claude-code), WinGet (winget install Anthropic.ClaudeCode), репозитории apt, dnf и apk, а также npm: npm install -g @anthropic-ai/claude-code (нужен Node.js 22 или новее). Через Homebrew, WinGet и пакетные менеджеры Linux обновления ставятся вручную. Запускать npm-установку через sudo документация прямо запрещает.

Если установщик промолчал — это нормально, прогресса он не показывает. Откройте новое окно терминала и проверьте claude --version: должен появиться номер версии. Если команда не находится, значит, папка установки ещё не в PATH. Для диагностики есть claude doctor.

Первые команды

• cd папка-проекта, затем claude — запуск; при первом входе откроется браузер для авторизации;
• /init — агент изучит проект и создаст файл CLAUDE.md с командами сборки, тестов и правилами, который потом читает в начале каждой сессии;
• /help — список команд, /login — сменить аккаунт, /clear — очистить диалог, /exit — выйти;
• claude -c — продолжить последний разговор, claude -p "вопрос" — разовый запрос без интерактива;
• Shift+Tab — переключить режим разрешений (насколько свободно агент действует без вопросов).

Начать документация предлагает с простого: «what does this project do?» (что делает этот проект) — и уже потом просить исправить ошибку или написать тесты.

«У агентов свои агенты»: что такое субагенты

Именно об этом ролик, после которого ищут установку. Субагенты — это помощники внутри Claude Code: каждый работает в своём окне контекста, со своим системным промптом, набором инструментов и правами, а основной сессии возвращает только итог. Так большой поиск по коду или разбор логов не засоряет главный разговор. Встроенные субагенты — Explore (быстрый поиск по коду, только чтение), Plan (сбор информации для плана) и универсальный general-purpose.

Своего субагента можно попросить создать у самого Claude или описать файлом Markdown с заголовком YAML (обязательны только поля name и description) в папке .claude/agents/ проекта или ~/.claude/agents/ для всех проектов. По документации, субагент по умолчанию может запускать собственных субагентов — до трёх уровней ниже основного разговора; глубину меняет переменная CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH. Так что «агенты у агентов» — не преувеличение, а штатная функция.

Про доступность в России

На странице поддерживаемых стран Anthropic России и Беларуси нет; список общий для Claude.ai, Claude Code и API, а всё, чего нет в списке, компания считает неподдерживаемым. Казахстан, Армения, Грузия и Узбекистан в списке есть, Украина — за исключением ряда регионов. Перед покупкой подписки проверьте актуальный список: он меняется.

Источники

• Claude Code Docs: Advanced setup (требования, установка, npm, Windows) (https://code.claude.com/docs/en/setup)
• Claude Code Docs: Quickstart (первый запуск, вход, основные команды) (https://code.claude.com/docs/en/quickstart)
• Claude Code Docs: Overview (что такое Claude Code) (https://code.claude.com/docs/en/overview)
• Claude Code Docs: CLAUDE.md и команда /init (https://code.claude.com/docs/en/memory)
• Claude Code Docs: Subagents (https://code.claude.com/docs/en/sub-agents)
• Anthropic: Supported countries and regions (https://www.anthropic.com/supported-countries)