Урок 0. Установка Claude Code — Возможно, вы используете не Claude Code

Совет — зная это, вы уже можете командовать

Одна проверочная строка — это всё.

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

claude --version

Если появился номер версии вроде 2.1.x — перед вами настоящий Claude Code. Он работает во всех уроках с 1-го по 11-й.

Если команда не найдена, или вы сейчас находитесь в чате внутри Cursor, Antigravity или Windsurf — это не Claude Code. Даже если там используется та же модель Claude, это другая программа. Автономный режим этого курса там не работает.

Запомните одно предложение:

Агент ≠ Модель. Даже с одним и тем же Opus — разные программы дают разные возможности.

Установка — одна строка (Mac / Ubuntu / WSL):

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

Windows: сначала WSL или Docker. Подробности — в основном тексте.

Быстрый старт

Убедитесь в разнице между CLI и IDE-чатом своими глазами. Это займёт 3 минуты.

В Claude Code (CLI) введите:

«Создай hello.py в пустой папке. Намеренно добавь одну синтаксическую ошибку, запусти файл, убедись в ошибке, затем исправь её самостоятельно и снова запусти. До тех пор, пока не выведется ‘Hello’.»

CLI-агент — создаст файл, запустит его напрямую, прочитает ошибку, исправит и запустит снова. Он не спрашивает вас на каждом шаге. Автономный цикл крутится сам.

Введите ту же фразу в IDE-чат (Cursor / Antigravity / Windsurf) — код предложат, но запустить придётся вам, ошибку нужно скопировать и вставить обратно, каждый шаг ждёт вашего одобрения. Цикл замыкается только через человека.

В этом и состоит Урок 0. И весь этот курс рассчитан именно на первый вариант.

Почему нужно командовать именно так

Возможно, вы уже что-то делали с «Claude Code». Смотрели видео на YouTube, обращались к чату, видели, как генерируется код.

Но позвольте задать один вопрос: то, что вы использовали, — действительно ли это Claude Code?

Если вопрос кажется несущественным, послушайте историю из реального онбординга.

Агент ≠ Модель

Один пользователь обратился за помощью — его приложение, созданное с помощью vibe coding, сломалось. Он говорил, что «разрабатывает с Claude Code». Несколько дней ничего не получалось: ИИ на каждом шагу спрашивал «выбрать вариант А, Б или В?», прогресс стоял.

Причиной оказалась не его некомпетентность. Он использовал чат-расширение Claude в Antigravity IDE. Не CLI-агент Claude Code. Оба работают на модели Claude Opus. Модель одна и та же. Но результаты были совершенно разными.

Почему? Потому что модель одна, а агент — разный.

• Модель (Model): мозг — Opus, Sonnet. Способность читать и писать текст как таковая.
• Агент (Agent): программа, которая этот мозг запускает. Какой системный промпт подаётся, какие инструменты (чтение/запись файлов, выполнение команд) предоставлены, насколько далеко агент действует самостоятельно без одобрения человека — всё это определяет агент.

Одна и та же лошадь (модель), но одно дело — пустить её пастись в поле без уздечки, другое — надеть седло и дать всаднику в руки поводья. Агент — это то самое седло и упряжь, устройство, к которому крепятся поводья (reins). (Об этом подробнее — в Уроке 5.)

Почему недостаточно «слабого» агента

У агентов есть уровни. И критерий, разделяющий уровни для этого курса (Уроки 1–11), — один.

Суть курса — одно предложение:

ИИ пишет код, машина проверяет, вы лишь спрашиваете «прошло?».

Для этого ИИ должен самостоятельно запускать инструменты проверки и на основе результата решать, что делать дальше. Запустить yongol validate, прочитать ошибку, исправить, запустить снова — если человек выступает посредником на каждом шаге, это не автономность, а ручной труд.

Автономный цикл:
  ИИ запускает validate → читает ошибку → исправляет → снова validate → прошёл → следующий
  (участие человека: 0 раз)

Посредничество человека на каждом шаге:
  ИИ: «Выполните validate вот так» → человек копирует и выполняет →
  человек копирует результат → вставляет ИИ → ИИ предлагает исправление → человек снова выполняет...

Урок 3 — Hurl, Урок 4 — yongol, Урок 6 — tsma, Урок 8 — filefunc. Все они — CLI-инструменты. Смысл есть только если ИИ запускает их автономно. С агентом, который не может крутить этот цикл, половина курса просто не работает.

Критерий «слабого агента» — не бренд, а один вопрос:

Этот агент самостоятельно запускает yongol validate / hurl / tsma, читает результат и определяет следующий шаг? Или мне нужно копировать и одобрять на каждом этапе?

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

Важно: «IDE-расширение = однозначно не подходит» — это не так. Cursor и Windsurf в агентном режиме самостоятельно выполняют команды и крутят цикл. Зато простой чат-режим в том же продукте требует одобрения на каждом шаге. Судите не по названию продукта, а по критерию выше. Те, кто застревал при реальном онбординге, застревали не потому что «IDE», а потому что используемый ими чат-режим не крутил CLI-цикл автономно.

Вот почему Урок 0 — это вход на курс. Выбрать неправильный инструмент — значит превратить все одиннадцать следующих уроков во лжи.

Ловушка YouTube

Вот в чём проблема. Большинство vibe coding-уроков на YouTube и в сообществах не различают агентов с автономным циклом и режим простого чата — и называют и то, и другое «Claude Code».

Из-за этого у новичка нет способа заметить разницу. Он обращается к чату и думает: «я использую Claude Code». А когда не получается как в уроке — винит себя.

Нет. Просто выбран не тот инструмент. Точнее, YouTube показал не тот инструмент. Держите в голове один критерий — «запускает ли он CLI самостоятельно?» — и в эту ловушку не попадёте.

Установка Claude Code

Этот курс ориентирован на Ubuntu (или WSL). Для пользователей Mac большинство шагов аналогично.

Предварительные требования

1. Аккаунт Anthropic: зарегистрируйтесь на https://console.anthropic.com
2. План подписки: Claude Pro ($20/мес.), Max ($100/мес. или $200/мес.). У Max щедрее лимиты на использование.
3. Ubuntu / Mac / WSL или Docker: пользователи Windows выбирают один из двух путей ниже.

Mac · Ubuntu · WSL — нативная установка (рекомендуется)

Самый простой способ, Node.js не нужен.

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

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

claude --version

Если появился номер версии вроде 2.1.x — успех.

Windows, вариант А: WSL (рекомендуется)

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

wsl --install

Эта одна строка активирует WSL, скачает ядро Linux и установит Ubuntu. После перезагрузки Ubuntu откроется автоматически и попросит имя пользователя и пароль. Введите короткое имя строчными буквами.

Важно: Вся дальнейшая работа ведётся в терминале Ubuntu. Если установить Claude Code в PowerShell или CMD, появится ошибка «Windows is not supported».

После этого выполните команду нативной установки выше — внутри Ubuntu.

Совет для WSL: Проект обязательно размещайте в файловой системе Linux (/home/имя_пользователя/). Если разместить на стороне Windows (/mnt/c/), чтение файлов будет крайне медленным.

Windows, вариант Б: Docker (если WSL недоступен)

Если WSL заблокирован корпоративной политикой или настройками среды, запустите Linux-контейнер через Docker и работайте в нём.

# В папке проекта — запустить ubuntu-контейнер, примонтировав текущую папку
docker run -it -v "$(pwd)":/work -w /work ubuntu:24.04 bash

# Внутри контейнера
apt update && apt install -y curl
curl -fsSL https://claude.ai/install.sh | bash
claude --version

-v "$(pwd)":/work связывает вашу папку проекта с /work внутри контейнера. Результаты работы внутри контейнера остаются в вашей папке.

Дополнительный способ: установка через npm

Этот способ для тех, у кого уже есть опыт с Node.js. Если вы новичок — используйте нативную установку выше.

# Установка nvm, затем Node.js LTS
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install --lts

# Установка Claude Code
npm install -g @anthropic-ai/claude-code

Внимание: Не используйте sudo npm install -g. Это создаёт проблемы с правами доступа и безопасностью.

Первый запуск и аутентификация

# Перейдите в папку проекта (создайте, если нет)
mkdir -p ~/projects/my-first-app
cd ~/projects/my-first-app

# Запустите Claude Code
claude

При первом запуске откроется браузер с запросом на вход в Anthropic. После входа аутентификация завершена, и в дальнейшем подключение будет автоматическим.

Чек-лист проверки установки

Если все три пункта отмечены — вы готовы к Уроку 1.

• claude --version выводит номер версии 2.1.x
• claude запускается и появляется приглашение (окно диалога)
• Аутентификация завершена через вход в браузере
• В быстром старте выше ИИ самостоятельно создал файл, запустил и исправил его (не просил одобрения на каждом шаге)

Последний пункт — самый важный. Если ИИ самостоятельно выполнял команды и исправлял ошибки — значит, вы используете настоящий Claude Code.

IDE-расширения — только как вспомогательный инструмент

Cursor, Antigravity, Windsurf — это не плохие инструменты. Для того чтобы смотреть на код и менять его построчно, они отличны. Для программистов — удобный выбор.

Однако автономный режим этого курса реализуется в CLI. IDE-расширение используйте как вспомогательное окно для просмотра кода, а цикл «создать, проверить, зафиксировать» — доверьте CLI Claude Code. Оба можно использовать вместе, главное — разграничить роли.

Практика: убедиться в подлинности

Цель: Убедиться, что используется CLI Claude Code, и один раз прокрутить автономный цикл.

Шаг 1 — Проверка установки

claude --version

Убедитесь, что версия выводится как 2.1.x. Если нет — вернитесь к инструкции по установке выше. Пользователям Windows — сначала настроить WSL (вариант А) или Docker (вариант Б).

Шаг 2 — Наблюдение за автономным циклом

Запустите claude и в пустой папке введите:

Создай hello.py в пустой папке. Намеренно добавь одну синтаксическую ошибку,
запусти файл, убедись в ошибке, затем исправь её самостоятельно и снова запусти.
До тех пор, пока не выведется «Hello».

Что наблюдать:

• ИИ сам создаёт файл? (вы не копируете и не вставляете код)
• ИИ сам запускает python hello.py?
• Если ошибка — ИИ сам читает её и исправляет?
• На протяжении всего процесса вы сделали только одно: написали первую фразу (и при необходимости дали разрешение на выполнение)?

Если на всё «да» — вы прошли через ворота. Идите на Урок 1.

(Если вы использовали IDE-чат) Введите ту же фразу и в окно IDE-чата — посмотрите, где он застревает. Почувствовав разницу один раз, вы никогда не забудете, зачем нужен Урок 0.

Итоги

1. Агент ≠ Модель. Даже с одной и той же моделью Claude — разные программы (агенты) дают принципиально разные возможности.
2. Значительная часть того, что YouTube называет «Claude Code», — это режим простого чата, который не может крутить автономный цикл. Критерий — не бренд, а «запускает ли он CLI самостоятельно?»
3. Этот курс рассчитан на CLI. Урок 3 — Hurl, Урок 4 — yongol, Урок 6 — tsma, Урок 8 — filefunc. Всё это CLI-инструменты, которые ИИ должен запускать автономно.
4. Установка — одна строка. curl -fsSL https://claude.ai/install.sh | bash. Windows: сначала WSL или Docker.
5. Критерий прохождения: claude --version выводит 2.1.x, ИИ самостоятельно создаёт файлы, запускает их и исправляет ошибки.

Выбрать неправильный инструмент — значит превратить следующие одиннадцать уроков во лжи. Вход на курс мы перекрыли здесь.

Анонс следующего урока: «Как давать задания ИИ.» Теперь, когда в руках настоящий Claude Code, учимся: что и как поручать ИИ, если вы не умеете читать код.

Домашнее задание

1. Проверить свой инструмент: Убедиться, был ли инструмент, который вы до сих пор называли «Claude Code», действительно CLI или IDE-чатом. claude --version даст ответ.
2. Прокрутить автономный цикл: Выполнить задание с hello.py из практики до конца — посчитать, сколько шагов ИИ сделал без вашего участия.
3. (Пользователи Windows) Выбрать среду: Выбрать WSL или Docker — тот, что работает в вашей среде — и завершить настройку.

Связанные статьи

• Почему кодирующие агенты работают и почему ломаются — Условия, при которых автономный цикл проверки агентов работает, и условия, при которых он разрушается. Теоретическая основа вопроса «почему именно CLI-автономный цикл» из Урока 0.
• Reins Engineering — ИИ на поводьях — Разница между ограждением (harness) и поводьями (Reins), и общий фрейм: агент как субстрат для поводьев.

Дополнительное чтение (внешние источники)

• Agent Harness Engineering — Addy Osmani. «Хорошая модель + отличный harness побеждает отличную модель + плохой harness.» Случаи, когда при фиксированной модели и изменённом только harness рейтинги в бенчмарках переворачивались. Исчерпывающий пример принципа Агент ≠ Модель.
• Agents are models using tools in a loop — Simon Willison. Стандартное определение агента. «Цикл» (loop), при котором результат инструмента возвращается обратно в модель, — вот что отделяет настоящего агента от маркетингового термина.
• Which AI Coding Harness Actually Works Without You? — Paweł Józefiak. Классификация инструментов кодирования на три категории: Orchestrator (автономный) / Pair Programmer (пошаговые инструкции) / Supervised IDE (не принимает решения самостоятельно). Путаница между этими тремя — ключевая ошибка. Точное совпадение с «ловушкой YouTube» из Урока 0.

Полный курс Reins Engineering

Источники

• Anthropic. “Claude Code overview.” Anthropic Documentation. link
• Anthropic. “Set up Claude Code.” Anthropic Documentation. link
• Karpathy, A. (2025). “Vibe coding” — термин, обозначающий кодирование по ощущениям, без чтения кода.