Добро пожаловать и настройка — Практика

Прямая речь: “Всё на этой практической странице построено так, чтобы вы могли повторять за мной строка за строкой. Когда вы видите блок с командой или промптом, можете копировать его прямо в терминал или сессию Claude, если я явно не скажу, что это справочный материал. По ходу дела сравнивайте свой результат с моим на экране, чтобы ловить ошибки рано, а не копить их.”

Продолжительность: ~15 минут Результат: Claude Code установлен, аутентифицирован и запущен внутри проекта ai-coderrank с успешным первым диалогом Пререквизиты: Node.js 18+, Git, аккаунт GitHub, подписка Anthropic Pro

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

Откройте терминал и установите Claude Code с помощью текущего официального нативного установщика:

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

Если предпочитаете пакетный менеджер:

• macOS: brew install --cask claude-code
• Windows: winget install Anthropic.ClaudeCode

Node.js по-прежнему нужен для работы с проектом курса позже, но он не требуется для самой установки Claude Code через нативный установщик.

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

claude --version

Вы должны увидеть номер версии. Если видите command not found, перезапустите терминал (или выполните source ~/.zshrc / source ~/.bashrc), чтобы PATH подхватил новый бинарник.

Прямая речь: “Обратите внимание, насколько скучной — в лучшем смысле — выглядит эта установка. Одна официальная команда установки, несколько секунд настройки, и готово. На macOS можно также использовать Homebrew, а на Windows — WinGet. Результат, который мы хотим получить, прост: claude --version работает, и мы готовы перейти к реальному рабочему процессу.”

Шаг 2: Аутентификация

Запустите Claude Code впервые:

claude

При первом запуске Claude Code предложит пройти аутентификацию. Следуйте инструкциям на экране — откроется окно браузера, где вы войдёте в аккаунт Anthropic и авторизуете Claude Code.

Требования: Вам нужна активная подписка Anthropic Pro ($20/месяц, рекомендуется для этого курса). Claude Code входит в планы Pro и Max. Pro даёт вам доступ к Sonnet и Haiku в Claude Code — этого достаточно для курса. Подробности в Руководстве по затратам.

После успешной аутентификации вы окажетесь в интерактивной сессии. Вы должны увидеть промпт примерно такого вида:

claude >

Поздравляем — вы внутри. Но прежде чем начать диалог, давайте изучим управление.

Прямая речь: “Внимательно следите за процессом аутентификации. После входа Claude Code обычно запоминает сессию, так что это шаг настройки, а не ежедневный ритуал. Результат, который вам нужен — это интерактивный промпт claude >, потому что это момент, когда ваш локальный терминал действительно подключён и готов к работе.”

Шаг 3: Изучение /help

Находясь в сессии Claude Code, введите:

/help

Это покажет все доступные слэш-команды. Уделите минуту, чтобы их просмотреть. Те, которые мы чаще всего будем использовать в курсе:

Прямая речь: “Думайте о /help как о вашей панели управления. Вам не нужно запоминать каждую команду в первый же день. Результат, который я хочу получить, прост: вы знаете, куда смотреть, когда что-то забыли, и продолжаете работать, а не тратите время на поиск документации.”

Попробуйте быстрый разговор:

Введите что-нибудь простое, чтобы убедиться, что всё работает:

What can you help me with?

Claude ответит обзором своих возможностей. Обратите внимание, что он упоминает чтение файлов, выполнение команд, редактирование кода — это не просто заявления, это реальные инструменты, к которым у него есть доступ. Мы скоро увидим их в действии.

Теперь выйдите из сессии:

/exit

Шаг 4: Форк и клонирование ai-coderrank

Перейдите в репозиторий проекта курса на GitHub:

https://github.com/ExpectoMentoris/ai-coderrank

Сделайте форк через интерфейс GitHub (нажмите кнопку “Fork” в правом верхнем углу).

Затем склонируйте ваш форк локально:

git clone https://github.com/YOUR_USERNAME/ai-coderrank.git
cd ai-coderrank

Замените YOUR_USERNAME на ваш реальный логин GitHub.

Быстрая проверка — убедитесь, что файлы проекта на месте:

ls

Вы должны увидеть структуру проекта Next.js: package.json, src/, public/, Dockerfile, k8s/, .github/ и другие файлы.

Прямая речь: “Я показываю форк, клонирование и листинг файлов специально, потому что именно здесь курс становится реальным. Я хочу, чтобы вы увидели репозиторий на диске и сразу распознали важные директории: src для кода приложения, k8s для манифестов и .github для автоматизации. Ожидаемый результат — Claude вот-вот войдёт в реальный проект, а не в искусственную демо-песочницу.”

Шаг 5: Запуск Claude Code внутри проекта

Вот этот момент. Перейдите в директорию проекта (если вы ещё не там) и запустите Claude Code:

cd ai-coderrank
claude

Теперь спросите Claude что-нибудь о проекте:

What is this project? Give me a quick summary.

Наблюдайте, что происходит. Claude не угадывает по названию директории. Он активно читает файлы — вы увидите, как он обращается к package.json, README.md, возможно заглядывает в src/ — чтобы построить реальное понимание того, что делает проект.

Попробуйте ещё несколько вопросов:

What tech stack does this project use?

What does the file structure look like?

Are there any Docker or Kubernetes configs in this project?

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

Прямая речь: “Видите, как происходит чтение файлов? Claude буквально открывает файлы на моей машине и использует этот живой контекст для ответов. Это ключевая ментальная модель для всего курса. Результат, который я хочу, чтобы вы усвоили: Claude Code не гадает о каком-то абстрактном приложении на Next.js — он анализирует именно этот репозиторий в реальном времени.”

Шаг 6: Проверка расхода токенов

Прежде чем завершить, давайте посмотрим, сколько стоил этот разговор:

/cost

Это покажет количество токенов за текущую сессию. В типичном первом разговоре используется относительно небольшое количество токенов — основной расход начнётся, когда Claude будет читать много файлов и вносить правки (что мы начнём делать с Блока 1).

Прямая речь: “Я всегда проверяю /cost в самом начале, чтобы вы выработали привычку с первого дня. Результат здесь — не просто число на экране; это уверенность в том, что вы можете контролировать расход и оставаться хозяином ситуации. Для обычной ежедневной разработки на Pro такая ознакомительная сессия комфортно укладывается в ожидаемый расход.”

Шаг 7: Выход

Чистый выход:

/exit

Что произошло?

Подведём итоги:

1. Установили Claude Code с помощью официального установщика
2. Прошли аутентификацию с подпиской Anthropic Pro
3. Исследовали систему /help, чтобы увидеть доступные команды
4. Сделали форк и склонировали проект ai-coderrank — наш спутник по курсу
5. Провели первый разговор с Claude Code внутри реальной кодовой базы
6. Наблюдали, как Claude читает реальные файлы, чтобы отвечать на вопросы о нашем проекте

Теперь у вас есть рабочая среда Claude Code, настроенная на реальное приложение Next.js. В следующем блоке мы пойдём гораздо глубже — используем /init для генерации файла CLAUDE.md и попросим Claude объяснить архитектуру, API-роуты и структуру компонентов в деталях.

Решение проблем

“command not found: claude” Перезапустите терминал или подгрузите конфигурацию шелла: source ~/.zshrc или source ~/.bashrc.

Аутентификация не проходит или истекает время ожидания Убедитесь, что у вас активная подписка Pro на claude.ai. Бесплатный тариф не включает доступ к Claude Code.

“Permission denied” при установке Если npm install -g выдаёт ошибки разрешений, либо исправьте глобальный префикс npm (npm config set prefix ~/.npm-global и добавьте ~/.npm-global/bin в PATH), либо используйте менеджер версий Node, например nvm, который избавляет от этой проблемы.