Claude Code с нуля

Claude Code: что это такое простыми словами?

Коротко: Claude Code - это ИИ-агент от Anthropic, который работает с файлами на твоём компьютере. Ты описываешь задачу так, как сказал бы коллеге, а он читает файлы, правит их, запускает команды и проверяет, что вышло. От чата его отличают инструменты: чат отвечает текстом, агент делает работу сам.

Claude Code - что это, если без терминов? Программа, внутри которой модель Claude получает доступ к папке с файлами и может в ней действовать. Как правильно по-русски, клод код или клауд код? Пишут по-разному, продукт один.

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

Пишу как пользователь: до агентов я десять лет занимался маркетингом, а весной 2026 года агент по моим описаниям собрал мне первый продукт, телеграм-бота, без строчки моего кода. Поведение программы ниже взято из документации Anthropic и проверено 21 сентября 2026 года на моём Mac с версией 2.1.278.

Где ты сейчас

Коротко: выбери строку про себя, подробности по каждой ветке - в отдельных статьях.

• Ещё не поставил - установка на три системы.
• Поставил, но терминал пугает - разбор терминала или приложение из следующего раздела.
• Работаешь в VS Code - статья про расширение и его панель.
• Агент уже работает - настройка с нуля.

Где работает Claude Code: терминал, VS Code, приложение или браузер?

Коротко: новичку хватает четырёх мест работы, движок везде один. Терминал даёт полный набор функций, VS Code держит агента рядом с файлами, вкладка Code в настольном приложении обходится без терминала, а браузерная версия работает в облаке. Правила проекта и подключения у локальных вариантов общие.

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

Облачная версия на 21 сентября 2026 года - исследовательская (research preview) и работает с репозиторием на GitHub, так что без него начинать с неё неудобно.

Что нужно, чтобы начать, и как поставить Claude Code?

Коротко: нужен компьютер на macOS 13, Windows 10 версии 1809 или Linux и платный аккаунт Claude либо аккаунт Console. На бесплатном тарифе Free Claude Code нет. Ставится он одной командой и проверяется командой claude --version, порядок для каждой системы разобран отдельно.

Поставить программу можно и до покупки: аккаунт она попросит при первом запуске, а без него не ответит ни на одно сообщение. По таблице тарифов на claude.com Claude Code входит в Pro, Max, Team и Enterprise, второй путь - аккаунт Console с оплатой по расходу. Лимиты подписки общие для чата и агента. Подробнее - в статьях о бесплатном доступе и о лимитах.

Установка на macOS и Linux:

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

Для Windows в PowerShell:

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

Проверка: claude --version печатает номер версии и приписку (Claude Code). Остальные способы собраны в инструкции по установке, особенности Windows - в отдельном разборе.

Системные требования Anthropic ссылаются на список поддерживаемых стран, и России в нём нет. Вход и сеть из России разобраны в статье про Россию, оплата - в статье как оплатить Claude из России.

Как пользоваться Claude Code в первые десять минут?

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

1. Заведи отдельную папку под задачу. Агенту доступна папка, из которой его запустили, и всё, что ниже. Файлы в других местах он трогает только с разрешения.

2. Запусти агента и войди. В терминале из этой папки:

   claude

   При первом запуске откроется браузер для входа. Над полем ввода появятся версия, модель и рабочая папка.

3. Спроси о папке, ничего не меняя. Документация начинает быстрый старт с вопросов, правки идут позже. Файлы прикладывать не нужно, агент читает их сам.

   Расскажи, что лежит в этой папке и как это устроено. Ничего не меняй.

4. Посмотри на строку состояния внизу. Там написан режим разрешений, Shift+Tab переключает его по кругу.

5. Дай маленькую задачу с проверкой. Например, переименовать файлы по шаблону. Если агент ушёл не туда, Esc останавливает его сразу.

6. Выйди и вернись. /exit закрывает сеанс, claude --continue в той же папке открывает тот же разговор, claude --resume показывает список прошлых.

Символ / в поле ввода показывает доступные команды и скиллы, остальное - в шпаргалке команды Claude Code.

После первого сеанса агенту нужно рабочее место: свои правила, память, которая переживает закрытие окна, пара готовых скиллов. Моя схема - в уроках и настройках ClaudeBase.

Как ставить задачу агенту, чтобы не переделывать?

Коротко: говори с агентом как с толковым коллегой, которому задачу объясняют один раз. Назови, что сделать, где это лежит, как выглядит готовый результат и чем его проверить. Файлы и команды агент подберёт сам, а признак готовности за тебя никто не придумает.

По документации агент останавливается, когда работа выглядит законченной. Без проверки «выглядит» остаётся единственным признаком, поэтому в задаче должно быть, как понять, что всё готово.

Ещё два приёма из документации:

1. Сначала исследование, потом правка. В режиме плана агент читает файлы и предлагает порядок действий, ничего не меняя. Если правку можно описать одной фразой, план не нужен.
2. Ссылайся на файлы через @. Строка вида @notes/plan.md подкладывает файл в разговор, а картинку можно просто перетащить в окно.

Как формулировать просьбы, разобрано в словаре: промпт.

Что агент делает без спроса: режимы разрешений

Коротко: режим разрешений решает, что агент делает сам, а о чём спрашивает. Их шесть, переключаются клавишами Shift+Tab. На Pro, Max и Team сеанс по умолчанию стартует в режиме auto, где безопасные действия пропускает отдельная модель-классификатор, на остальных тарифах - в ручном Manual.

Текущий режим виден в строке состояния: ⏸ manual mode on, ⏵⏵ accept edits on, ⏸ plan mode on или ⏵⏵ auto mode on. Стартовый auto требует версию 2.1.228 на macOS и Linux или 2.1.233 на Windows, а в первом сеансе после установки программа может начать и в Manual.

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

Почему агент «забывает» и что такое контекст?

Коротко: всё, что агент знает в сеансе, лежит в окне контекста: переписка, прочитанные файлы, вывод команд, правила. Окно заполняется, и по документации качество ответов при этом падает. Новый сеанс стартует с чистого листа, поэтому постоянные правила пишут в файл: в чате их пришлось бы повторять каждый раз.

Anthropic называет окно контекста самым важным ресурсом. Когда оно почти заполнено, программа сжимает историю сама, и инструкции из начала беседы могут потеряться.

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

Вчерашний разговор агент не помнит, пока ты не откроешь его через claude --continue или claude --resume. Через границу сессии знание переносят два механизма: файл правил, который пишешь ты, и автоматическая память, которую ведёт агент.

Откуда берутся правила, скиллы и агенты?

Коротко: базовые инструменты закрывают большую часть задач, а своё добавляется слоями. CLAUDE.md хранит правила проекта, скиллы - повторяемые процедуры, субагенты берут подзадачи в отдельном контексте, MCP подключает внешние сервисы. Слой добавляют, когда появился повод, ставить всё сразу не нужно. Начинают обычно с CLAUDE.md.

Документация предлагает порядок по поводам:

CLAUDE.md агент читает в начале каждого сеанса. Заготовку собирает команда /init, ориентир по размеру - короче двухсот строк, подробно - в статье CLAUDE.md: правила проекта. Рядом работает автоматическая память: агент записывает выводы сам, в сеанс грузятся первые 200 строк или 25 КБ её индекса, управляет ею команда /memory.

Скилл - папка с файлом SKILL.md, где описана процедура. Личные лежат в ~/.claude/skills/, проектные - в .claude/skills/. В начале сеанса агенту доступно только описание, а целиком скилл подгружается, когда нужен. Как написать свой - в статье про свои скиллы, как поставить готовый - в статье как установить скилл.

Субагент работает в своём окне контекста и возвращает только итог. Встроенные уже есть: Explore для поиска по файлам, Plan для режима плана и general-purpose. Своего создают просьбой к Claude или файлом в .claude/agents/, подробно - в статье про агентов.

MCP - открытый стандарт подключения внешних данных, его авторы сравнивают с портом USB-C. Так агент читает документы из Google Drive или работает с задачами в Jira (разбор MCP). Плагин упаковывает скиллы, хуки, субагентов и серверы MCP в одну установку (статья про плагины).

Все эти слои в базе ClaudeBase собраны готовыми. Урок «Рабочее окружение: правила проекта и разрешения» показывает, где живут файл правил, папка настроек и папки skills и agents. Настройки закрывают три темы: чтобы агент помнил прошлые сессии, держался правил твоих проектов и не требовал пересказывать одно и то же. Готовых агентов там восемь, от юриста до ассистента, плюс авторские скиллы с инструкцией, как их поставить и проверить.

Что Claude Code умеет, а чего не умеет?

Коротко: по документации агент помогает со всем, что делается из командной строки: тексты, поиск по файлам, исследование темы, сборка программ. Непрограммисту это даёт работу с папками документов, страницами, скриншотами и повторяющимися задачами. Помнить прошлые сеансы без файлов и откатывать внешние действия он не умеет.

Чего агент не умеет, лучше знать заранее:

1. Помнить прошлое сам по себе, без CLAUDE.md и автопамяти.
2. Откатывать всё подряд. Откат покрывает только его собственные правки файлов.
3. Гарантированно выполнять правила. CLAUDE.md для агента - контекст. Для действий, которые обязаны случаться всегда, документация отправляет к хукам.
4. Работать без платного аккаунта. На тарифе Free Claude Code недоступен.

Если выбираешь между агентами, сравнение лежит в статье Codex или Claude Code, а сам подход «кодинг словами» - в статье вайбкодинг: с чего начать.

Какие ошибки делают в первую неделю?

Коротко: ошибки первой недели бывают двух видов. Технические - программа не находится, вход не выполнен, кончился лимит, нет связи с сервером, и у каждой есть дословный текст в справочнике Anthropic. Поведенческие - один разговор на всё подряд и задачи без проверки - Anthropic разбирает в руководстве по лучшим практикам.

command not found: claude

Это ответ терминала на macOS и Linux, когда папка установки ещё не попала в список путей, где система ищет программы. Документация советует пройти шаги исправления и открыть новое окно терминала, подробно - в статье про установку.

Not logged in · Please run /login

Сеанс запущен без входа. Команда /login внутри сессии открывает вход. Если в системе задана переменная ANTHROPIC_API_KEY, справка Claude предупреждает: программа возьмёт ключ вместо подписки, и расход пойдёт по тарифам API (Claude Code API).

You’ve hit your session limit

Закончился лимит подписки в текущем окне. В сообщении указано время сброса, а команда /usage показывает остаток.

Unable to connect to API

Нет связи с сервером Anthropic. Справочник называет причины: нет интернета, VPN блокирует адрес api.anthropic.com или не настроен прокси.

Поведенческие ошибки из руководства Anthropic по лучшим практикам:

1. Один разговор на всё подряд. Несвязанные задачи забивают контекст, лечится командой /clear.
2. Бесконечные поправки. После двух неудачных исправлений выгоднее начать заново.
3. Доверие без проверки. Правдоподобный результат может сломаться на крайнем случае, поэтому проверку задают в самой задаче.

Чек-лист

Коротко: первый этап пройден, если про тебя все шесть пунктов ниже. На каждый уходит минута: одна команда или взгляд на экран.

• claude --version печатает номер версии и приписку (Claude Code).
• Вход выполнен аккаунтом с Claude Code: Pro, Max, Team, Enterprise или Console.
• Режим разрешений виден в строке состояния, и ты переключаешь его Shift+Tab.
• Первая задача сделана в отдельной папке, и одна правка откачена двойным Esc.
• Сеанс закрыт через /exit и открыт снова через claude --continue.
• /context показывает, чем занято окно, и ты знаешь, когда нажать /clear.

Claude Code запущен - что дальше?

Коротко: дальше три дела - правила проекта, первый скилл и привычка задавать проверку. Документация советует начинать с CLAUDE.md, а остальное добавлять, когда для него появится конкретная причина, например повторная ошибка агента. Ниже эти шаги по порядку и статьи, где каждый разобран подробно.

1. Выполни /init в папке, с которой работаешь чаще всего, и допиши в CLAUDE.md то, что уже объяснял агенту дважды.
2. Поставь один готовый скилл под задачу, которую делаешь каждую неделю.
3. Задавай проверку в каждой задаче: скриншот, таблицу, список изменений.

Статьи по следующим шагам:

• Claude Code: настройка с нуля - правила, память, разрешения и скиллы по шагам.
• CLAUDE.md: правила проекта - что писать в файл.
• Лимиты Claude Code - где смотреть расход.
• Каталог скиллов - открытые скиллы с инструкциями по установке.

Правила, настройки памяти, готовые агенты и скиллы, которыми я пользуюсь каждый день, лежат в ClaudeBase, уроки курса выходят по мере записи. Копировать оттуда ничего не нужно: база подключается к Claude Code как MCP-сервер, и нужное для задачи он берёт из неё сам. Состав базы - на странице доступа к ClaudeBase.