Урок 1: Установка и настройка Claude Code

Описание

Claude Code — это мощный инструмент CLI, который живёт в вашем терминале и позволяет работать с AI-агентом прямо из командной строки. В этом уроке вы выполните все необходимые шаги: от установки до первого запуска и проверки доступных функций.

Чему вы научитесь

• Установить Claude Code на ваш компьютер (macOS, Linux, Windows)
• Авторизоваться через Anthropic Console или подписку Claude
• Запустить первую команду и понять, как работает интерфейс
• Проверить доступный контекст и стоимость использования
• Настроить базовые параметры

Требования

Перед началом убедитесь, что выполнены следующие условия:

Обязательные требования:

• Node.js 18+ установлен (нужен только при установке через npm; нативный установщик не требует Node.js)
• Подписка Claude Pro ($20/месяц) или Claude Max ($100/$200/месяц) ИЛИ API ключ Anthropic
• Git установлен (требуется для Windows)

Проверить версию Node.js:

node --version
# v18.0.0 или выше

Проверить Git:

git --version

Обзор процесса

flowchart LR
    A["Установка\nnpm / curl / winget"] --> B["Авторизация\nчерез браузер или API-ключ"]
    B --> C["Первый запуск\nclaude в терминале"]
    C --> D["Проверка\n/status · /cost · /doctor"]

Пошаговая установка

Вариант 1: Нативный установщик (рекомендуется)

Это рекомендованный Anthropic способ. Не требует Node.js, создаёт самодостаточный исполняемый файл с автообновлением.

На macOS и Linux:

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

На Windows (PowerShell):

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

Нативный установщик автоматически обновляет Claude Code в фоне — вы всегда будете на последней версии.

Важно для Windows: после установки обязательно закройте и заново откройте PowerShell (или CMD). Без этого система не увидит новую команду claude, и вы получите ошибку «имя не распознано как имя командлета». Это касается любого способа установки.

Если PowerShell блокирует выполнение скрипта irm | iex, сначала разрешите запуск скриптов:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Затем повторите установку.

Вариант 2: Установка через npm (если Node.js уже есть)

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

Внимание: не используйте sudo npm install -g — это приводит к проблемам с правами.

Вариант 3: Установка через WinGet (Windows)

winget install Anthropic.ClaudeCode

Обновление:

winget upgrade Anthropic.ClaudeCode

Авторизация и первый запуск

Шаг 1: Перейти в рабочую директорию

cd /path/to/your/project

Выберите папку с вашим проектом или создайте новую:

mkdir my-ai-project
cd my-ai-project

Шаг 2: Запустить Claude Code

claude

При первом запуске система предложит вам авторизоваться. Откроется браузер с запросом на вход в ваш аккаунт Anthropic.

Шаг 3: Выбрать способ авторизации

Вариант A: Через Claude подписку (Pro или Max)

1. Нажмите на ссылку для входа
2. Используйте учётные данные Claude.com
3. Подтвердите, что у вас активна подписка Pro ($20/месяц) или Max ($100/$200/месяц)

Вариант B: Через API ключ

1. Перейдите на https://console.anthropic.com
2. Создайте новый API ключ в разделе “API Keys”
3. Скопируйте ключ
4. При запуске Claude Code выберите опцию авторизации через API ключ
5. Вставьте ключ в диалоговое окно

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

После авторизации вы увидите приглашение к вводу команды:

claude>

Введите что-нибудь простое для проверки:

/help

Система выведет список доступных команд и краткое описание каждой.

Проверка установки

Команда /status

Проверяет текущий статус Claude Code:

/status

Вывод должен показать:

• Текущую версию Claude Code
• Выбранную модель (по умолчанию Claude Sonnet 4.6)
• Ваш аккаунт
• Статус подключения

Команда /cost

Один из самых важных инструментов для отслеживания расходов:

/cost

Выведет информацию о:

• Количестве использованных токенов в текущей сессии
• Стоимости текущей сессии в долларах
• Лимитах использования для вашего плана
• Проценте использованного контекста

Пример вывода:

Session: 1,234 input tokens, 567 output tokens
Cost: $0.05
Usage: 15% of monthly limit

Команда /doctor

Диагностирует проблемы с установкой:

/doctor

Проверяет:

• Корректность установки Claude Code
• Доступность всех необходимых инструментов
• Конфигурацию окружения
• Наличие конфликтов с другими утилитами

Базовая конфигурация

Просмотр текущих настроек

/config

Откроет интерактивный интерфейс настроек. Здесь можно изменить:

• Модель AI (Haiku, Sonnet, Opus)
• Язык интерфейса
• Стиль вывода
• Тему оформления (светлая/тёмная)

Выбор модели

/model

Позволяет переключаться между моделями прямо во время работы:

• Haiku 4.5: быстрая, экономичная, для простых задач
• Sonnet 4.6: сбалансированная, универсальная (по умолчанию)
• Opus 4.6: мощная, для сложных задач (требует Claude Max)

Просмотр разрешений

/permissions

Показывает, какие действия разрешены Claude Code:

• Редактировать файлы в проекте
• Запускать команды в терминале
• Работать с git
• Обращаться к MCP серверам

Проверка работоспособности

Теперь давайте выполним простой тест, чтобы убедиться, что всё работает:

Тест 1: Просмотр структуры проекта

claude
# затем введите:
explore

Claude Code должен отсканировать структуру вашего проекта и рассказать вам о файлах и папках.

Тест 2: Запрос информации

claude

# В приглашении claude> введите:
Tell me what files are in this project

Агент проанализирует файлы и даст описание.

Тест 3: Проверка плана без изменений

claude

# Введите:
/plan
# Затем опишите задачу, например:
add a simple hello world function

Claude Code предложит план действий, но не будет выполнять изменения (режим плана).

Встроенные команды

Основные команды для начальной работы:

Попробуйте сами

Практическое задание:

1. Установите Claude Code одним из предложенных методов
2. Перейдите в любую папку вашего проекта (или создайте новую)
3. Выполните команду claude
4. Авторизуйтесь через браузер
5. Введите /status и убедитесь, что всё работает
6. Введите /cost и посмотрите информацию об использовании
7. Введите what's in this directory и посмотрите, как Claude Code анализирует ваш проект
8. Введите /exit для выхода

Проверочные вопросы:

• Видите ли вы список команд после /help?
• Показывает ли /cost информацию о токенах и стоимости?
• Может ли Claude Code описать содержимое вашей папки?
• Видите ли вы версию и модель в /status?

Если все четыре пункта работают — установка успешна!

Решение распространённых проблем

«Command not found: claude» (macOS / Linux)

# Перезагрузите терминал или выполните:
source ~/.bashrc  # или ~/.zshrc для macOS

«Имя “claude” не распознано как имя командлета» (Windows)

Это самая частая ошибка на Windows. Она означает, что PowerShell не видит команду claude.

Шаг 1 — Закройте и заново откройте PowerShell. Это нужно после любой установки, чтобы обновить системный PATH.

Шаг 2 — Проверьте, установлен ли Claude Code:

# Если устанавливали через npm:
npm list -g @anthropic-ai/claude-code

# Если устанавливали через WinGet:
winget list Anthropic.ClaudeCode

Шаг 3 — Если команда по-прежнему не найдена, установщик не добавил папку с Claude Code в PATH. Это значит, что Windows не знает, где искать программу. Добавьте путь вручную:

# Эта команда добавляет папку с Claude Code в «список мест,
# где Windows ищет программы». Выполните её один раз:
[Environment]::SetEnvironmentVariable("PATH", "$env:USERPROFILE\.local\bin;$([Environment]::GetEnvironmentVariable('PATH', 'User'))", "User")

После этого закройте и откройте PowerShell — теперь claude должен работать.

Что делает эта команда? Она говорит Windows: «Ищи программы ещё и в папке .local\bin в моём профиле». Именно туда нативный установщик кладёт claude.exe. Без этого шага Windows просто не находит файл.

Шаг 4 — Если ничего не помогает, попробуйте полный путь напрямую:

# Проверьте, что файл существует:
& "$env:USERPROFILE\.local\bin\claude.exe" --version

# Или для npm-установки:
& "$env:APPDATA\npm\claude.cmd" --version

Шаг 5 — Альтернатива: переустановите через WinGet (он надёжно прописывает PATH):

winget install Anthropic.ClaudeCode

PowerShell блокирует выполнение скрипта (Windows)

При установке через irm | iex PowerShell может выдать ошибку о политике выполнения.

# Разрешите запуск скриптов для текущего пользователя:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

# Затем повторите установку:
irm https://claude.ai/install.ps1 | iex

«Authentication failed»

• Убедитесь, что у вас активная подписка Claude Pro или Max
• Или проверьте, что API ключ введён правильно
• Выполните /login для повторной авторизации

«Node.js version too old»

# macOS:
brew install node

# Windows (PowerShell от администратора):
winget install OpenJS.NodeJS.LTS

# Linux (Ubuntu/Debian):
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

Permission Denied (Linux)

chmod +x ~/.claude/bin/claude

Ключевые выводы

1. Claude Code требует подписки Claude Pro/Max или API ключа; Node.js нужен только при установке через npm
2. Установка простая — одна curl-команда (нативный установщик рекомендуется)
3. Авторизация проходит через браузер — безопасно и удобно
4. Команды /cost и /status — ваши главные инструменты для мониторинга
5. /help всегда под рукой — если забыли синтаксис команды
6. План работает в режиме безопасности — вы видите изменения ДО их применения

Следующий урок

В следующем уроке мы разберём все slash-команды и научимся переключаться между режимами работы (план и редактирование). Вы узнаете, как использовать каждую команду для максимальной эффективности.

Источники

• Claude Code Official Overview
• Claude Code Quickstart
• Anthropic Console
• Claude Pricing