Claude Code: установка и сценарии

Claude Code это терминальный агент от Anthropic, который пишет и правит код прямо в твоём проекте. Не чат в соседнем окне, куда ты копируешь куски и переносишь ответы обратно руками, а агент, который сидит внутри папки проекта, видит все файлы, понимает стек и вносит изменения сам. Ты описываешь задачу обычными словами, он читает код вокруг, формирует план, предлагает diff, ты подтверждаешь.

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

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

Что понадобится

• Аккаунт Anthropic с платным планом. Нужен Pro, Max, Team или Enterprise. Бесплатный план Claude.ai к Claude Code доступа не даёт. Можно также подключить аккаунт Anthropic API с кредитами или сторонний провайдер (Amazon Bedrock, Google Vertex AI, Microsoft Foundry). Планы тут: https://claude.com/pricing. Вход идёт через браузер, без аккаунта агент не запустится.
• Поддерживаемая ОС. macOS 13+, Windows 10 (сборка 1809+) или Windows Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+. 4 ГБ RAM и выше, процессор x64 или ARM64. Скачивается на следующем шаге, ставить заранее ничего не надо.
• Любой терминал и папка с проектом. Подойдёт Bash, Zsh, PowerShell или CMD, встроенный терминал в редакторе или системный. Главное, чтобы ты запускал агента внутри папки, с которой хочешь работать.

Официальная инструкция по установке всегда тут: https://code.claude.com/docs/en/setup. Если что-то в командах ниже изменится, сверяйся с этой страницей.

Установка

Путь не один, а несколько. Выбери под себя, дальше всё одинаково.

Вариант А. Официальный инсталлятор (рекомендую, самый простой)

Один скрипт, ставит нативный бинарь, дальше сам обновляется в фоне.

macOS, Linux, WSL:

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

Windows PowerShell:

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

Windows CMD:

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

Если в PowerShell видишь ошибку The token '&&' is not a valid statement separator, значит ты не в CMD. Если в CMD ругается 'irm' is not recognized, значит ты не в PowerShell. В PowerShell строка приглашения начинается с PS C:\, в CMD просто C:\ без PS. На нативном Windows рекомендую поставить Git for Windows, чтобы агент мог использовать Bash.

Вариант Б. Через npm

Если у тебя уже стоит Node.js 18 или выше. Качай Node тут: https://nodejs.org/en/download.

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

Важно: не ставь через sudo npm install -g, это ведёт к проблемам с правами и рискам безопасности. Если терминал ругается на права, чини Node через nvm, а не запускай от рута. Обновлять потом так:

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

Вариант В. Через пакетный менеджер

macOS через Homebrew, Windows через WinGet. Учти: эти варианты не обновляются автоматически, апдейтить надо руками.

Homebrew (macOS):

brew install --cask claude-code

WinGet (Windows):

winget install Anthropic.ClaudeCode

Обновить вручную: brew upgrade claude-code или winget upgrade Anthropic.ClaudeCode.

Вариант Г. Десктоп-приложение, без терминала

Если терминал пока пугает, ставь приложение с графическим интерфейсом. Внутри есть вкладка Code и режим Cowork для фоновых задач. Скачать: https://claude.com/download. Гайд по нему: https://code.claude.com/docs/en/desktop-quickstart.

Вариант Д. Расширение для редактора

Claude Code встраивается прямо в IDE. Лучший вариант, если хочешь работать в привычном редакторе кода.

• VS Code: открой панель расширений (Cmd+Shift+X на Mac, Ctrl+Shift+X на Windows), вбей в поиск «Claude Code», нажми Install. Докинструкция: https://code.claude.com/docs/en/vs-code.
• JetBrains (PyCharm, IntelliJ, WebStorm): Settings → Plugins → Marketplace → найди «Claude Code». Страница плагина: https://plugins.jetbrains.com/plugin/27310-claude-code-beta-.

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

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

claude --version

Если выдаёт версию, ты готов. Если command not found, перезапусти терминал и проверь снова. Для подробной диагностики установки и конфига есть отдельная команда:

claude doctor

Первый запуск

1. Залогинься

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

claude

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

2. Дай первую задачу

Опиши задачу обычным текстом, как объяснил бы коллеге. Claude читает проект, формирует план, предлагает diff, а ты подтверждаешь или отклоняешь правки. На что смотреть: всегда читай diff перед подтверждением, не подтверждай вслепую. Diff это и есть точка контроля, тут видно, что именно агент собирается изменить. Типичная ошибка новичка, кинуть огромную задачу одним промптом и нажимать ок не глядя. Начни с маленькой понятной правки, посмотри, как агент работает, и только потом наращивай размер задач.

Можно дать задачу и одной строкой, без входа в сессию:

claude "Объясни, что делает этот проект, и опиши структуру файлов"

Сценарии использования

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

1. Персональный сайт

claude "Build me a personal portfolio website. Include a homepage with my name and bio, an About page, a Projects page with 4 placeholder cards, and a Contact page with a form. Make it look modern and clean. Use dark mode. Make sure it looks good on phones too."

2. Веб-приложение с базой данных

claude "Create a simple to-do list app using React for the frontend and a local SQLite database. Users should be able to add tasks, mark them complete, delete them, and filter by status. Add some nice animations when tasks are completed."

3. Лендинг для бизнеса

claude "Build a landing page for my online tutoring business called BrightMind. Include a hero section with a headline and signup button, a section showing 3 features with icons, a testimonials section with 3 fake reviews, a pricing table with 3 tiers, and a footer. Make it professional and colorful."

4. Автоматизация задач с файлами

claude "Write a Python script that goes through a folder of photos, reads the date each photo was taken from the metadata, and organizes them into subfolders by year and month. Like Photos/2025/March/. Run it on my Downloads folder."

5. Расширение для Chrome

claude "Build a Chrome extension that lets me save any highlighted text on a webpage to a list. When I click the extension icon it should show all my saved highlights with the URL they came from. Add a button to copy all highlights to clipboard and a button to clear the list."

6. Мобильное приложение

claude "Create a React Native app for tracking daily habits. It should have a home screen that shows today's habits with checkboxes, a screen to add new habits, and a stats screen that shows a weekly streak calendar. Use a clean minimal design with soft colors."

7. Скриншот в код

claude "Look at this screenshot I'm sharing. Recreate this exact design as a responsive HTML page. Match the layout, colors, fonts, and spacing as closely as possible. Make all the buttons and links functional."

8. Письма и уведомления

claude "Write a Python script that checks a list of URLs every morning and sends me an email summary of which ones are down or returning errors. Use smtplib for email. Include instructions for setting it up with Gmail."

9. API или бэкенд-сервис

claude "Build a REST API using Node.js and Express for a simple blog. It should have endpoints to create, read, update, and delete blog posts. Store posts in a SQLite database. Add basic input validation and error handling. Include a README with setup instructions."

10. Починить баги

claude "I'm getting this error when I try to run my app: [paste your error message here]. Explain what is going wrong in simple terms and fix it for me."

11. Точечный рефакторинг в существующем проекте

claude "Refactor the file <путь к файлу>: вынеси повторяющуюся логику в отдельные функции, ничего не меняя в поведении. Покажи diff и объясни каждое изменение."

12. Объяснить чужой код

claude "Прочитай этот проект и объясни простыми словами: что он делает, какой стек, где точка входа, как запускается. Без правок, только разбор."

Стартовый промпт сессии

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

Ты работаешь внутри этого проекта как инженер.

1. Сначала прочитай структуру и пойми стек, не предлагай правок вслепую.
2. Кратко опиши, что нашёл, и план из 3 шагов.
3. Жди моего ок перед тем, как менять файлы.
4. Меняй точечно, показывай diff, без лишнего рефакторинга.

Задача: <опиши задачу>

Шпаргалка: ревью своего же кода

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

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

Шпаргалка по командам

• claude, запустить сессию в папке текущего проекта
• claude "task", выполнить быструю разовую задачу одной строкой
• claude --continue, продолжить с того места, где остановился в прошлый раз
• claude --resume, выбрать из списка прошлых сессий
• claude --version, проверить установленную версию
• claude update, обновить вручную, не дожидаясь фонового апдейта
• claude doctor, диагностика установки и конфига
• /help, посмотреть все доступные команды (набери внутри сессии)
• /compact, освободить память, когда диалог становится длинным

Лайфхак: CLAUDE.md

Создай файл с именем CLAUDE.md в папке проекта. Пропиши инструкции вроде «always use TypeScript» или «use Tailwind CSS for styling», и Claude будет следовать им автоматически в каждой сессии. Считай это файлом настроек для твоего AI-ассистента: один раз задал правила проекта, дальше не повторяешь их в каждом промпте.

Где заходит, где осторожнее

Заходит:

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

Осторожнее:

• Большие задачи дроби на шаги, иначе агент уходит в сторону и теряет нить.
• Всегда смотри diff перед подтверждением. Доверие не равно автопилот.
• Не запускай агента из домашней папки, только из корня проекта.

Чеклист перед стартом

• Claude Code установлен (claude --version выдаёт версию).
• Залогинен в аккаунт Anthropic с платным планом.
• Агент запущен из корня нужного проекта.
• Задача описана обычным текстом.
• Смотрю diff перед каждым подтверждением.

Частые ошибки

• Кидаешь огромную задачу одним промптом. Агент уходит в сторону, дроби на шаги.
• Подтверждаешь правки, не читая diff. Так в проект заезжает то, чего ты не видел.
• Просишь рефакторить всё подряд без причины. Лишние изменения, лишние баги.
• Запускаешь агента не из той папки. Он смотрит не на те файлы и правит мимо.
• Ставишь через sudo npm install -g. Получаешь проблемы с правами, чини Node через nvm.
• Нет критерия, по которому задача готова. Без понятного финиша агент будет крутить бесконечно.