Чтобы пользоваться Claude Code, установите его одной командой, запустите claude в папке проекта, войдите через аккаунт Claude в браузере и опишите задачу обычными словами. Claude читает нужный код, предлагает правки и команды и спрашивает, прежде чем делать то, что вы не разрешили.
Это весь цикл. Остальная часть руководства — о том, что заставляет его работать хорошо: файл CLAUDE.md, режимы разрешений, несколько slash-команд, plan mode и привычки, которые помогают не выйти за лимиты.
Что такое Claude Code
Claude Code — кодовый агент Anthropic. Он работает в терминале (а также в VS Code, JetBrains, десктопном приложении и вебе), трудится над файлами в папке, из которой вы его запустили, и умеет выполнять команды оболочки: тесты, линтеры, git. В отличие от чата, ему не нужно вставлять код вручную. Он сам идёт и читает всё необходимое.
Шаг 1: установите Claude Code
Рекомендуемый способ — штатный установщик. Он обновляется сам в фоне.
| Платформа | Команда |
|---|---|
| macOS, Linux, WSL | curl -fsSL https://claude.ai/install.sh | bash |
| Windows PowerShell | irm https://claude.ai/install.ps1 | iex |
| macOS (Homebrew) | brew install --cask claude-code |
| Windows (WinGet) | winget install Anthropic.ClaudeCode |
Установки через Homebrew и WinGet сами не обновляются, поэтому время от времени обновляйте их менеджером пакетов. Проверьте, что всё сработало:
claude --versionШаг 2: войдите в аккаунт
Перейдите в папку проекта и запустите:
cd your-project
claudeВ первый раз Claude Code откроет браузер для входа. Можно использовать:
- подписку Claude Pro, Max, Team или Enterprise — обычный выбор;
- аккаунт Claude Console с оплатой за токены из предоплаченных кредитов;
- облачного провайдера: Amazon Bedrock, Google Cloud или Microsoft Foundry.
Вход сохраняется, так что делать это нужно один раз. Если аккаунтов несколько, между ними переключает /login.
Шаг 3: первая задача
Начните с чего-то небольшого и настоящего, а не с «сделай мне приложение». Хорошие первые задачи:
- «Объясни, как в этом проекте устроена аутентификация.»
- «Запусти тесты и скажи, почему падает неудачный.»
- «Добавь проверку ввода в форму регистрации и тест к ней.»
Введите задачу и нажмите Enter. Claude читает файлы, затем предлагает изменения или команды. В зависимости от режима разрешений он либо сначала спросит, либо сразу выполнит, а каждую правку покажет как diff. Читайте их. Код в релиз отправляете вы.
Можно сразу запустить с задачей:
claude "find where we parse dates and list the formats we accept"Другие полезные способы запуска:
| Команда | Что делает |
|---|---|
claude | Запускает интерактивную сессию |
claude "task" | Запускает сессию с первым сообщением |
claude -p "task" | Выполняет один раз, печатает ответ и выходит (удобно для скриптов) |
claude -c | Продолжает последний разговор в этой папке |
claude -r | Позволяет выбрать старый разговор для возобновления |
Шаг 4: напишите CLAUDE.md
Каждая сессия начинается с чистого окна контекста. CLAUDE.md — способ, которым Claude помнит ваш проект: Markdown-файл, читаемый в начале каждой сессии.
Выполните в сессии:
/initClaude просматривает кодовую базу и пишет первый CLAUDE.md с найденными командами сборки, командами тестов и соглашениями. Если CLAUDE.md уже есть, он предложит улучшения. Затем отредактируйте файл сами. Что стоит туда включить:
- как собирать, запускать и тестировать (
pnpm test, а не «запусти тесты») - соглашения, которые не очевидны из кода
- чего избегать («никогда не правь сгенерированные файлы в
src/gen/») - где находятся важные части
Держите его коротким; Anthropic советует не выходить за примерно 200 строк на файл. Длинные файлы съедают контекст, и им следуют менее надёжно. Содержимое можно разбить импортами @path/to/file.
CLAUDE.md может лежать в нескольких местах:
| Файл | Область действия |
|---|---|
./CLAUDE.md или ./.claude/CLAUDE.md | Проект, общий с командой через git |
~/.claude/CLAUDE.md | Вы, во всех проектах |
./CLAUDE.local.md | Вы, только в этом проекте (держите вне git) |
Если в репозитории уже есть AGENTS.md для других агентов, свежие версии Claude Code читают его при отсутствии CLAUDE.md, а из CLAUDE.md его можно импортировать через @AGENTS.md.
Шаг 5: разберитесь с разрешениями
Claude Code спрашивает, прежде чем делать что-то рискованное. Как часто, зависит от режима разрешений. Нажимайте Shift+Tab, чтобы переключать их; текущий режим виден внизу экрана.
| Режим | Что выполняется без вопросов | Подходит для |
|---|---|---|
Manual (default) | Чтение файлов | Обучения, чувствительного кода |
| Accept edits | Чтение, правки файлов, простые команды файловой системы | Работы, которую вы всё равно проверите в diff |
| Plan mode | Только чтение; без правок исходников | Исследования и проектирования до кода |
| Auto mode | Большинство действий, проверяемых классификатором безопасности | Длинных задач с меньшим числом запросов |
Свежие версии по умолчанию стартуют в auto mode, старые — в Manual. В auto mode вторая модель проверяет каждое действие и блокирует то, что выглядит рискованным или не по задаче, но гарантией это не является, так что следите за происходящим.
Для более тонкого контроля /permissions позволяет добавлять правила allow, ask и deny, например «всегда разрешать npm test» или «всегда спрашивать перед git push». В macOS, Linux и WSL2 команда /sandbox запускает команды Bash внутри песочницы.
Есть ещё --dangerously-skip-permissions, который никогда не спрашивает. В документации Anthropic сказано использовать его только внутри контейнера или виртуальной машины. Не применяйте его на основной машине, пока вы учитесь.
Шаг 6: slash-команды, которые стоит знать
Введите / в сессии, чтобы увидеть все команды. Чаще всего вам пригодятся эти:
| Команда | Что делает |
|---|---|
/help | Показывает справку и команды |
/init | Создаёт или улучшает CLAUDE.md |
/clear | Начинает новый разговор (старый остаётся в /resume) |
/compact | Сжимает разговор до сводки, освобождая контекст |
/context | Показывает, что заполняет окно контекста |
/model | Переключает модель; стрелки меняют effort |
/plan | Включает plan mode, при желании сразу с задачей |
/permissions | Управляет правилами allow, ask и deny |
/rewind | Возвращает к более раннему моменту разговора и кода |
/resume | Открывает прежний разговор |
/mcp | Управляет MCP-серверами (дополнительные инструменты) |
/usage | Показывает лимиты использования вашего тарифа |
/review | Проверяет ваши текущие изменения |
/memory | Редактирует ваши файлы CLAUDE.md |
/rewind — то, что новички упускают. Если Claude пошёл не туда, вернитесь к моменту до этого, а не уговаривайте его вернуться.
Шаг 7: для всего крупнее используйте plan mode
Для изменений, затрагивающих больше одного-двух файлов, сначала попросите план. Нажимайте Shift+Tab, пока не увидите plan mode, или введите:
/plan add rate limiting to the public APIВ plan mode Claude читает код, задаёт уточняющие вопросы и пишет план, но исходники не правит. Вы читаете план, возражаете против того, что не нравится, и одобряете, когда всё верно. Потом он переключается на правки и выполняет план.
Это стоит несколько минут и экономит много откатов. Сессию в plan mode можно также запустить командой claude --permission-mode plan.
Хорошие привычки при постановке задач
Claude Code хорошо следует чётким инструкциям. Большинство плохих результатов — от расплывчатых.
- Скажите, как проверить работу. «Добавь эндпоинт и добейся, чтобы
pnpm test apiпроходил» лучше, чем «добавь эндпоинт». - Указывайте файлы. Назовите файл или функцию или введите
@, чтобы сослаться на файл. - Одна задача на разговор. Используйте
/clear, когда переходите к несвязанному. - Давайте примеры. «Следуй шаблону из
users.service.ts» лучше абзаца описания. - Просите сначала объяснить, если не знаете код: «Как работает X? Пока ничего не меняй.»
- Прерывайте рано. Нажмите Esc, чтобы остановить его, если он идёт не туда, затем поправьте.
- Повторяющиеся поправки записывайте в CLAUDE.md. Если вы сказали это дважды, запишите.
Лимиты и как в них уложиться
У подписок есть лимиты использования: скользящее 5-часовое окно и недельный лимит, у старших тарифов больше. Длинные разговоры расходуют больше, потому что каждое сообщение несёт весь контекст.
- Проверяйте, где вы находитесь, через
/usage. - Используйте
/clearмежду несвязанными задачами. - Используйте
/compactв долгих сессиях, при желании указав, что сохранить:/compact keep the API decisions. - Используйте
/context, чтобы увидеть, что занимает место, например большие файлы или множество инструментов MCP. - Для простой работы выбирайте более лёгкую модель через
/model.
Подробнее — в статьях лимиты Claude Code и как сократить расход токенов Claude Code.
Когда одного терминала мало
Освоившись, вы захотите, чтобы второй Claude работал, пока первый гоняет тесты. Два агента в одной папке будут наступать друг другу на файлы, поэтому каждому нужен свой git worktree. В этот момент один терминал становится неудобным.
AgentVera — десктопное приложение для macOS, Windows и Linux, которое запускает Claude Code (и других CLI-агентов) в настоящих терминалах рядом друг с другом. Оно использует уже имеющийся у вас вход в Claude Code.
- Workspace: сетка агентов на проект, от 1×1 до 5×4. У каждого агента своё имя, модель, effort, Role and instructions, и после перезапуска он возвращается к своему разговору.
- Worktrees: в панели Git создайте worktree и запустите в нём агента одним кликом, чтобы параллельные агенты не делили файлы.
- Разрешения для каждого агента: в диалоге New agent выберите Ask, Auto или Full access. Auto использует собственный auto mode Claude Code.
- Чекпоинты и повтор: хранятся последние 60 ходов на агента, а сессию можно воспроизвести.
- Контекст на виду: каждая панель показывает текущий размер контекста, а auto-compact срабатывает до заполнения окна.
Всё перечисленное доступно на бесплатном тарифе. Auto approval, который пропускает безопасные чтения и тесты, но всё же спрашивает перед git push или rm, входит в Pro и Team.
Когда дойдёте до этого, прочитайте как запускать несколько агентов Claude Code и скачайте AgentVera бесплатно.
Держите под рукой шпаргалку по командам Claude Code, пока учитесь, а если работаете в VS Code, загляните в настройку расширения для VS Code.
Подведём итог
Установите, запустите claude, войдите и начните с небольшой настоящей задачи. Выполните /init и держите CLAUDE.md коротким. Через Shift+Tab выбирайте, как много Claude может делать, plan mode используйте для всего крупнее, /rewind — когда что-то пошло не так, а /clear и /compact — чтобы уложиться в лимиты. Этого хватит почти для всего, что нужно в первые недели.