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

Анатолий0

Что такое Claude Code и зачем его ставить

Claude Code — терминальный AI-агент для кодинга от Anthropic. Он читает вашу кодовую базу, правит файлы, запускает команды, работает с git и интегрируется с внешними инструментами через MCP. Это не чат-бот, которому вы скармливаете куски кода и копируете ответы — агент сам исследует проект, вносит изменения и проверяет результат.

По оценке Anthropic, на начало 2026 года Claude Code достиг run-rate $2,5 млрд годовой выручки и удвоил аудиторию с начала года (источник). Это самый быстрорастущий инструмент в нише агентского кодинга.

Пример из жизни: Кайл, видеопродюсер из Сан-Франциско, не пишущий код, за три недели построил на Claude Code полноценное dating-приложение — 40 000 строк TypeScript, 119 компонентов, 32 экрана, нативная iOS/Android-сборка через Capacitor, CI/CD и админ-панель. К концу третьей недели — 30 агентов и 9 младших агентов в репозитории (источник):

«Docs are the real codebase. Early on we set up a docs/ folder that describes every system in plain English, and Claude reads the relevant doc before touching that system. My CLAUDE.md is basically a router.»

«Документация — настоящая кодовая база. С самого начала мы сделали папку docs/, где каждый компонент описан простым языком, и Claude читает нужный документ перед работой с этим компонентом. Мой CLAUDE.md — по сути, роутер.»

К концу июля Кайл обновил статистику: 70 909 строк TypeScript, 190 компонентов, 52 экрана, 152 миграции и $55/мес на инфраструктуру. На тот момент он использовал Max 20x ($200/мес), плюс ~$50/мес бюджет на младших агентов (Haiku для простых задач).

Схема установки Claude Code: выбор пути для macOS, Linux, WSL и Windows
Пути установки Claude Code: macOS/Linux/WSL, Windows (нативно и WSL 2), аутентификация, настройка CLAUDE.md и запуск.

Статья — не обзор возможностей Claude Code (для этого есть статья про агентный кодинг), а практическое руководство: как установить, войти, настроить и начать продуктивно работать.

Готовимся к установке: что нужно знать

Системные требования

Claude Code работает на:
— macOS 13.0+
— Windows 10 1809+ / Server 2019+ (нативно или через WSL 2)
— Linux: Ubuntu 20.04+, Debian 10+, Alpine 3.19+, Fedora, RHEL
— WSL 2 (рекомендуется для Windows — даёт песочницу и bash-инструменты)

Железо: 4 ГБ+ RAM, процессор x64 или ARM64, интернет-соединение (источник).

Для Windows нативно — рекомендуется Git for Windows, чтобы Claude Code использовал Git Bash вместо PowerShell (хотя PowerShell тоже поддерживается). В WSL Git for Windows не нужен — используется штатный bash.

Подписка или API: как платить

Claude Code не работает на бесплатном тарифе. Варианты доступа:

Способ Минимальная цена Что входит
Claude Pro $20/мес ($17 при годовой оплате) Claude Code + чат + Cowork + Design
Claude Max 5x $100/мес В 5 раз больше лимитов, чем Pro
Claude Max 20x $200/мес В 20 раз больше лимитов; ранний доступ к новым функциям
Claude Team $25/мес за место Центральное администрирование, SSO, биллинг
Claude Enterprise $20/мес за место + оплата по API-токенам SCIM, аудит, кастомное хранение данных, HIPAA
API (Console) Pay-as-you-go (~$13/день в среднем) Прямой доступ к моделям через API-ключ
Amazon Bedrock / Google Cloud / Microsoft Foundry По тарифам провайдера Для enterprise, без прямой подписки Anthropic

Средний расход на одного разработчика в enterprise-развёртываниях — около $13 за активный день и $150–250 в месяц. У 90% пользователей — ниже $30 в день (источник).

Pro-подписки достаточно для старта. Кайл из кейса выше начинал на Max 5x ($100/мес), к концу третьей недели перешёл на Max 20x ($200/мес) — по мере роста проекта и количества агентов.

На момент публикации (август 2026): цены в долларах США. Бесплатный тариф Claude.ai НЕ включает Claude Code.

Шаг 1: Установка

macOS, Linux и WSL

Откройте терминал и выполните:

curl -fsSL https://claude.ai/install.sh | bash

Скрипт скачивает и устанавливает бинарник в ~/.local/bin/claude. Нативные установки автоматически обновляются в фоне.

Проверьте установку:

claude --version
# → 2.1.211 (Claude Code)  (версия на момент публикации)

Windows (нативно)

PowerShell (рекомендуется):

irm https://claude.ai/install.ps1 | iex

CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Нативные Windows-установки тоже автоматически обновляются.

Важно: если в PowerShell видите ошибку The token '&&' is not a valid statement separator — вы в PowerShell, а не в CMD. Если в CMD видите 'irm' is not recognized — вы в CMD, а не в PowerShell. Подсказка: PS C:\> = PowerShell, C:\> = CMD.

Альтернативные способы

Homebrew (macOS):

brew install --cask claude-code

Homebrew предлагает два cask’а: claude-code (стабильный канал, ~на неделю позже) и claude-code@latest (свежие релизы). Homebrew-установки не автообновляются — периодически запускайте brew upgrade claude-code.

WinGet (Windows):

winget install Anthropic.ClaudeCode

Тоже не автообновляется: winget upgrade Anthropic.ClaudeCode вручную.

npm (любая платформа, требуется Node.js 22+):

npm install -g @anthropic-ai/claude-code

npm-пакет ставит тот же нативный бинарник — рантайм Node.js не используется.

Linux-пакетные менеджеры: apt (Debian/Ubuntu), dnf (Fedora/RHEL), apk (Alpine). Подробности — в официальной документации.

Шаг 2: Первый вход

Запустите Claude Code в любом проекте:

cd ваш-проект
claude

При первом запуске откроется браузер для аутентификации. Варианты входа:

  1. Claude-аккаунт (Pro, Max, Team, Enterprise) — стандартный путь, логин через браузер
  2. API-ключ — установите переменную ANTHROPIC_API_KEY, тогда Claude Code пропустит браузер и сразу запросит подтверждение ключа
  3. Amazon Bedrock / Google Cloud Agent Platform / Microsoft Foundry — для enterprise через облачных провайдеров

Учётные данные сохраняются в ~/.claude/.credentials.json (на macOS — в Keychain), повторный вход не требуется.

Сменить аккаунт: команда /login внутри сессии.

Шаг 3: Первый запуск — минимальная настройка

После входа вы увидите приглашение Claude Code с версией, моделью и путём к проекту. Несколько вещей, которые стоит сделать сразу:

3.1. Выбор модели

Claude Code по умолчанию использует Sonnet — оптимальный баланс скорости и качества для ежедневного кодинга. Доступные модели:

Алиас Модель Для чего
sonnet Sonnet 5 Ежедневные задачи: фиксы, фичи, рефакторинг
opus Opus 5 Сложная архитектура, многошаговые рассуждения
fable Fable 5 Самые сложные и длинные задачи; автономная работа
haiku Haiku Простые задачи, максимальная скорость
opusplan Opus (plan) → Sonnet (exec) План на Opus, исполнение на Sonnet

Переключить модель:

/model sonnet

Выбор сохраняется как настройка по умолчанию для новых сессий (с версии 2.1.153).

3.2. Настройка CLAUDE.md

Файл CLAUDE.md в корне проекта — главный инструмент настройки Claude Code под вашу кодовую базу. Claude читает его при старте каждой сессии. Кайл описывает свой подход так:

«My CLAUDE.md is basically a router.»

«Мой CLAUDE.md — по сути, роутер.»

Минимальный CLAUDE.md:

# CLAUDE.md

## Стек
- Frontend: React 18 + TypeScript + Tailwind
- Backend: FastAPI + PostgreSQL
- Тесты: pytest, React Testing Library

## Правила кодинга
- Все функции — с аннотациями типов
- Компоненты — функциональные, с хуками
- Перед коммитом — пройти линтер и тесты

## Структура проекта
- `frontend/` — React-приложение
- `backend/` — FastAPI-сервер
- `docs/` — документация по системам (читать перед работой с компонентом)
- `tests/` — общие тесты

Совет из кейса Кайла: папка docs/ с описанием каждой системы на простом английском. Claude читает нужный документ перед работой с конкретным компонентом и не тратит токены на исследование с нуля. Это же сокращает счёт.

Подробнее — в документации Store instructions and memories.

3.3. Режимы прав доступа

Claude Code по умолчанию спрашивает разрешение перед каждым изменением файла. Режимы переключаются по Shift+Tab:

Режим Поведение
Default Запрашивать подтверждение на каждое изменение
Accept edits Автоматически принимать правки файлов
Plan Только предлагать план, не трогать файлы
Auto (не у всех) Фоновая проверка безопасности, блокировка рискованных действий

На старте оставьте Default — так вы видите каждое изменение до того, как оно попадёт в файл.

Шаг 4: Первые команды

4.1. Интерактивный режим (основной)

claude

Вы вводите задачи на естественном языке, Claude исследует код и выполняет.

Первая сессия Claude Code в терминале
Пример первой сессии: Claude Code анализирует проект, добавляет валидацию email и запускает тесты.

Примеры первых запросов:

что делает этот проект?

объясни структуру папок

добавь функцию hello world в главный файл

какие файлы я изменил?

закоммить изменения с осмысленным сообщением

4.2. Одноразовые задачи (без интерактивной сессии)

claude -p "объясни эту функцию"              # запрос и выход
claude "почини ошибку сборки"               # задача и выход
claude -c                                   # продолжить последнюю сессию
claude -r                                   # выбрать сессию для продолжения

4.3. Основные сессионные команды

Команда Действие
/help Справка по всем командам
/clear Очистить историю (начать заново)
/model Выбор модели (с выбором по умолчанию)
/usage Использование токенов и лимитов
/config Настройки Claude Code
/compact Сжать историю (сохранить контекст, освободить место)
/login Переключить аккаунт
/resume Возобновить предыдущую сессию
Ctrl+D (дважды) Выйти

Шаг 5: Полезные настройки для продуктивной работы

5.1. Статус-строка с использованием контекста

Добавьте в ~/.claude/settings.json показ заполненности контекстного окна:

{
  "statusLine": {
    "type": "default"
  }
}

Или настройте через /config.

5.2. Права для частых операций

Чтобы не подтверждать каждое действие вручную, добавьте правила в .claude/settings.json проекта:

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)",
      "Bash(git diff *)"
    ],
    "deny": [
      "Bash(curl *)",
      "Read(./.env)",
      "Read(./secrets/**)"
    ]
  }
}

5.3. Настройка MCP-серверов

MCP (Model Context Protocol) — стандарт для подключения внешних источников данных и инструментов: Google Drive, Jira, Slack, базы данных.

Файл .mcp.json в корне проекта (документация):

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-github"]
    }
  }
}

Подробнее — в статье про MCP.

Российские реалии: Claude Code из РФ

Доступность

Россия отсутствует в списке поддерживаемых стран Anthropic — ни для API, ни для claude.ai (список стран). Прямой доступ к сервисам Anthropic с российского IP заблокирован.

Что нужно для работы

  1. VPN — обязателен для доступа к api.anthropic.com и claude.ai. Подойдёт любой надёжный VPN-сервис с серверами в поддерживаемых странах (США, Европа, Азия).
  2. Регистрация аккаунта — номер телефона для верификации. Российские номера не принимаются — нужен номер страны из списка поддерживаемых (Казахстан, Турция, Армения, Грузия и т.д.). Виртуальные номера часто заблокированы.
  3. Браузерная аутентификация — при первом запуске claude открывается браузер для входа. Если браузер не открывается автоматически, скопируйте URL из терминала и откройте вручную.

Оплата

Российские карты Visa и Mastercard не работают для оплаты подписок Anthropic. Реальные способы оплаты:

  • Карты UnionPay российских банков (не у всех проходят; проверять перед попыткой)
  • Криптовалюта — через посредников, оплачивающих подписку за вас
  • API-ключ через Console — требует пополнения баланса, те же ограничения по картам
  • Team/Enterprise через юрлицо в поддерживаемой стране — если есть возможность открыть юрлицо в Казахстане, Турции, Армении или другой стране из списка

Русский интерфейс

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

Переключить язык общения:

отвечай на русском

Или в CLAUDE.md:

## Язык
Все ответы и комментарии в коде — на русском языке.

Опыт из рунета

Тема Claude Code в рунете освещена слабо — инструмент относительно новый, плюс ограничения по доступности. По состоянию на август 2026:

  • На Хабре — единичные статьи про Claude Code, в основном обзоры возможностей, а не практические руководства по установке
  • Профильные Telegram-каналы по AI-кодингу обсуждают Claude Code, но без структурированных гайдов
  • Практический опыт установки из РФ — есть отдельные посты на форумах; основные грабли: верификация телефона и оплата

Если вы прошли путь установки Claude Code из РФ — поделитесь опытом в комментариях, дополним статью.

Подписка vs API: что выбрать

Критерий Подписка (Pro/Max) API (Console)
Оплата $20–200/мес, фикс. плата Pay-as-you-go, ~$0.04–0.15 за запрос
Лимиты Скользящие 5-часовые и недельные окна Бюджет workspace
Модели Все модели через /model Все модели, нужен доступ к workspace
Интерфейс CLI + десктоп + веб + VS Code/JetBrains CLI (с API-ключом)
Авторизация Браузерный вход ANTHROPIC_API_KEY
Zero data retention Нет Да (опционально)
Подходит для Индивидуальная работа, старт Команды, точный контроль расходов, enterprise

Для старта берите Pro ($20/мес) — этого достаточно для активного использования 2–3 часа в день. Если упираетесь в лимиты — переходите на Max или API.

Сравнение подписки и API Claude Code
Сравнение подписки (Pro / Max) и API (Console): стоимость, лимиты, способ входа, для кого подходит.

Проверить текущий расход: команда /usage внутри сессии.

Советы от пользователей

  1. Одна сессия — одна задача. Закончили фичу — /clear. Длинные сессии жрут контекст и токены, даже когда вы ничего не делаете (Claude перечитывает всю историю при каждом запросе).

  2. Пишите конкретно. Вместо «почини баг» — «почини баг: пустой экран после ввода неправильного пароля на странице логина».

  3. Дайте Claude исследовать проект до правок. Начните с «проанализируй схему базы данных» или «как устроена аутентификация» — агент сориентируется и не будет тратить токены на изучение в процессе правок.

  4. Используйте plan-режим для сложных задач. Shift+Tab → Plan mode: Claude исследует и предлагает план до внесения изменений. Дешевле, чем переделывать после неверного направления.

  5. Документируйте архитектуру. Как показал кейс Кайла — папка docs/ с описанием систем и CLAUDE.md-роутер экономят токены лучше любой технической оптимизации.

  6. Выбирайте модель под задачу. Sonnet для 90% задач, Opus — для архитектурных решений, Haiku — для простых операций (генерация сообщений коммита, форматирование).

Честные ограничения

  • Нет бесплатного доступа. В отличие от OpenCode и Aider, Claude Code требует платную подписку или API-ключ. Бесплатный тариф Claude.ai не включает Claude Code.
  • РФ — только через VPN. Без вариантов: Россия не в списке поддерживаемых стран. Доступ только с IP поддерживаемой страны.
  • Лимиты. Даже на Max 20x есть скользящие 5-часовые и недельные лимиты. При активной работе они достижимы — у Кайла Max 5x заканчивался за день интенсивного кодинга.
  • Русский — на уровне общения. Claude Code понимает и пишет по-русски, но системные сообщения, документация и сообщества — на английском.
  • Требуется интернет. Локального режима нет — все запросы уходят на серверы Anthropic (или облачного провайдера).
  • Не локальный. В отличие от Ollama + Qwen3-Coder, модели работают в облаке. Для полностью локального AI-кодинга — смотрите статью про Aider и локальные модели.
  • Стоимость при интенсивной работе. Enterprise-статистика: $150–250/мес на разработчика. Это не «копейки» — закладывайте в бюджет.

Что дальше

Вы установили Claude Code и запустили первую сессию. Дальше:

  1. Пройдите Quickstart — claude и пара запросов о проекте
  2. Настройте CLAUDE.md под свой проект
  3. Подключите MCP-серверы — GitHub, Jira, базы данных
  4. Попробуйте VS Code-расширение — инлайн-диффы и визуальное ревью правок
  5. Прочитайте статью про агентный кодинг, чтобы понять, как устроен цикл работы агента

Если интересуют open-source альтернативы — обзор бесплатных инструментов для агентского кодинга (выйдет в этом цикле).

Насколько публикация полезна?

Нажмите на звезду, чтобы оценить!

Средняя оценка / 5. Количество оценок:

Оценок пока нет. Поставьте оценку первым.

Статьи по теме:
Просмотров: 0

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *