Как пользоваться Claude Code: установка и настройка с нуля

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

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

Какой тариф нужен для Claude Code

По официальной документации Claude Code требует платный аккаунт: Pro, Max, Team, Enterprise либо аккаунт Claude Console с API-биллингом. Бесплатный тариф Claude.ai доступа к Claude Code не даёт, и это первое, обо что спотыкаются на входе. В Team есть нюанс: доступ даёт премиум-место, обычное не подходит.

Минимальный вход для одного человека это Pro. На странице тарифов Anthropic он стоит 20 долларов в месяц при помесячной оплате. Годовая подписка списывается одним платежом, 200 долларов за год, около 17 в месяц. Max начинается от 100 долларов (5x) и 200 долларов (20x) в месяц: в основном это больше лимитов плюс ранний доступ к новым моделям и функциям. Для старта не нужен.

Заодно сверься с требованиями к системе: macOS 13.0 и новее, Windows 10 версии 1809 и новее или Windows Server 2019 и новее, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+. Нужно от 4 ГБ оперативной памяти, процессор x64 или ARM64, интернет и доступ из страны, которую Anthropic поддерживает. Что входит в каждый тариф, разбирали в тексте про тарифы Claude.

Установка Claude Code: два пути

Путь первый, терминал. Одна команда.

macOS, Linux, WSL:

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

Windows PowerShell:

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

Установщик ставит всё сам, Node.js отдельно не нужен: он требуется только тем, кто ставит через npm. Если на Mac стоит Homebrew, подойдёт brew install --cask claude-code. На Windows есть вариант через WinGet: winget install Anthropic.ClaudeCode.

Проверь, что установилось:

`` claude --version ``

В ответ придёт номер версии и подпись (Claude Code).

Путь второй, приложение. У Claude есть десктоп-приложение с вкладкой Code. Тот же Claude Code, но с кнопками, окном просмотра изменений и выбором «принять» или «отклонить» на каждой правке. Терминал и отдельная установка CLI не нужны, требования по тарифу те же. Если слово «терминал» вызывает лёгкую панику, начинай отсюда.

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

Открой терминал в папке, с которой хочешь работать, и запусти:

`` cd /путь/к/папке claude ``

При первом старте он попросит войти через браузер. Что стоит знать в первые пять минут:

• Shift+Tab переключает режим доступа
• /clear начинает разговор заново, с чистым контекстом
• /compact сжимает уже сказанное в резюме, когда разговор разросся
• /add-dir путь подключает ещё одну папку
• /rewind открывает меню отката, то же делает двойной Esc при пустой строке

Первую задачу дай безобидную. Например, «расскажи, что лежит в этой папке и как она устроена». Он прочитает и ответит, ничего не меняя.

Режимы доступа Claude Code: главная настройка для новичка

Claude Code спрашивает разрешение перед тем, как изменить файл или запустить команду. Как часто он спрашивает, зависит от режима. Shift+Tab переключает по кругу три основных:

• Manual (в настройках это default, подпись в строке состояния зависит от версии CLI): без спроса идёт чтение и встроенный список безопасных команд вроде ls, cat, git status. Всё остальное ждёт твоего подтверждения.
• Accept edits: правки файлов внутри рабочей папки применяются сами, ты смотришь результат после. Вместе с ними без спроса выполняются файловые команды mkdir, touch, rm, rmdir, mv, cp, sed в той же папке, а именно их /rewind не откатывает. Поэтому включай этот режим только на копии данных.
• Plan: он изучает и предлагает план, но файлы не трогает, пока план не утверждён.

Схема на первое время: стартуешь в Plan, читаешь план, утверждаешь, дальше идёшь в Manual и подтверждаешь шаги. Стартовать сразу в плане: claude --permission-mode plan.

Отдельно про bypassPermissions, он же флаг --dangerously-skip-permissions: он отключает практически все запросы на подтверждение. Документация допускает его только в изолированных контейнерах и виртуальных машинах, на рабочем ноутбуке включать не надо.

Четыре задачи не про код

Порядок в папке. Скопируй «Загрузки» в отдельную папку и попроси: «разбери файлы по типу и году, создай подпапки, ничего не удаляй, в конце дай список, что куда переехало». Ключевое тут «ничего не удаляй» и требование отчёта.

Выжимка из документов в таблицу. Папка со счетами или договорами: «пройди по всем файлам, вытащи дату, контрагента, сумму и номер, собери CSV. Где поле не нашлось, оставь пусто и вынеси такие файлы отдельным списком». Вторая часть важнее первой: она показывает, где инструмент не справился, вместо красивой выдумки в пустой ячейке.

Массовое переименование. «Переименуй все файлы в формат 2026-08-02_контрагент_сумма, регистр нижний, пробелы замени подчёркиваниями. Сначала покажи таблицу старое и новое, переименовывай после подтверждения».

Чистка текстов по правилу. Сорок заметок в .txt и .md: «убери из всех файлов строку со старым адресом, приведи заголовки к одному виду. Покажи изменения по первым трём файлам, дальше работай молча и в конце отчитайся числом правок».

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

Правила безопасности

• Работай в копии. Не в корне диска и не в «Документах» целиком. Отдельная папка под конкретную задачу.
• Делай бэкап до старта. Не из страха, а потому что откат неполный, об этом ниже.
• Убери лишнее из рабочей папки. Пароли, сканы документов, чужие персональные данные выноси заранее.
• Читай, что он собирается запустить. В запросе на разрешение видно команду целиком.
• Проверяй результат руками. Посчитай файлы до и после, открой три штуки наугад.

Частые ошибки и что проверять руками

«Команда claude не найдена». Установка прошла, но терминал её пока не видит. Перезапусти терминал. Если команда всё ещё не находится, дело в PATH или во второй установке рядом. Когда claude заработает, состояние установки и настроек покажет claude doctor.

Он работает не с той папкой. Claude Code видит ту папку, в которой ты его запустил. Если он «не находит» файлы, проверь, куда сделал cd, или подключи папку через /add-dir.

Откат работает не всегда. /rewind возвращает правки, которые Claude сделал инструментами редактирования. Файлы, изменённые командами оболочки вроде rm, mv и cp, он не отслеживает, как и изменения вне сессии. Вот ради этого и нужен бэкап.

Он пересказал план вместо того, чтобы сделать. Скорее всего, ты в режиме Plan. Посмотри на индикатор режима и переключи Shift+Tab.

Ответы стали вязкими, начало разговора забылось. Длинная сессия съедает контекст. /clear начинает с нуля, /compact сжимает историю в резюме.

Цифры в таблице не сошлись. Сверяй число строк против числа файлов. Пустая ячейка честнее аккуратно заполненной.

Где ломается и когда нужен разработчик

Скан или фото-PDF он читает как картинку. Текст модель видит, но на плохом качестве, рукописном почерке и мелком шрифте ошибается, а длинный PDF читает кусками по страницам, до 20 за раз. Поэтому пачку сканов проверяй выборочно, а на больших объёмах дешевле прогнать распознавание заранее.

На больших пачках он спотыкается о выбросы. Если из трёхсот файлов десять оформлены иначе, именно они и станут браком, поэтому список исключений важнее сводной цифры. На длинных задачах упирается в лимиты тарифа, текущий расход показывает /usage.

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

С чего начать

Поставь, запусти в тестовой папке, дай одну задачу из четырёх выше. Через полчаса будет понятно, твой это инструмент или нет.

Программа AGINE Academy доходит до Claude Code и запуска своих продуктов: 81 урок, 12 блоков, семь направлений, из каждого урока выходишь с рабочим результатом. Технический опыт не нужен. Стартовый блок из четырёх уроков открыт без регистрации, можно просто посмотреть, как устроен формат. AGINE Academy не связана с Anthropic.

Смотри также

• Вайб-кодинг: с чего начать, если ты никогда не писал код
• Как навести порядок в файлах через Claude Code без единой строчки кода
• Промпты для Claude: механика и 15 рабочих примеров по ролям