Claude Code — агент Anthropic, который работает внутри каталога с вашим проектом. Как использовать Claude Code в деле, видно по одному сеансу целиком: вы запускаете его командой claude, ставите задачу обычными словами, а он сам находит нужные файлы, правит их, запускает команды и показывает изменение. Ниже разобран весь круг работы — вход в учётную запись, первый вопрос к проекту, режимы разрешений, команды, откат неудачной правки и то, что переходит в следующий сеанс. Claude Code входит в платные планы Anthropic, а разбор планов и того, что доступно без оплаты, собран в статье про подписку Claude Code.
Первая сессия: как открыть Claude Code и войти в аккаунт
До первого сеанса Anthropic в быстром старте просит подготовить четыре вещи. Нужны открытый терминал или командная строка, проект кода для работы, подписка Claude одного из платных планов и учётная запись — либо Claude Console, либо доступ через поддерживаемого облачного провайдера. Аккаунт в документации Anthropic называется учётной записью, и без него работа не начинается: «Claude Code требует учётную запись для использования.» Установка программы здесь не разбирается, её порядок под каждую систему собран в статье как установить Claude Code.
Войти можно учётной записью одного из четырёх видов, и Anthropic перечисляет их по порядку:
- подписка Pro, Max, Team или Enterprise — этот способ помечен как рекомендуемый;
- учётная запись Claude Console, то есть доступ к API с предоплаченными кредитами; при первом входе в Console там сам создаётся рабочий раздел «Claude Code», по которому видно затраты;
- Amazon Bedrock, Google Cloud’s Agent Platform или Microsoft Foundry;
- самостоятельно размещённый шлюз приложений Claude, если такой шлюз использует ваша организация.
Как подключить Claude Code к своей учётной записи, зависит от её вида, но начало у всех одно. Перейдите в каталог проекта командой cd /path/to/your/project и наберите claude. При первом запуске появится приглашение войти, а после входа учётные данные сохраняются, и повторять вход не нужно. Переключить учётную запись позже позволяет команда /login прямо в работающем сеансе.
Одно исключение из этого порядка касается переменной окружения ANTHROPIC_API_KEY. Когда она задана, приглашение войти пропускается, и вместо него Claude Code запрашивает одобрение ключа. Это тот случай, когда экран входа не появляется вовсе, а человек ищет, куда делся вход.
После запуска над строкой приглашения печатаются версия, текущая модель и рабочий каталог — по ним видно, где именно вы находитесь и чем сейчас работаете. Команда /help показывает доступные команды, а /resume продолжает предыдущий разговор. Что требуется для входа из России и чем оплачивают доступ, разобрано в отдельной статье про Claude Code в России.
Первый вопрос к проекту
В новом каталоге первым делом спрашивают про сам проект. Примеры вопросов Anthropic даёт по-английски: what does this project do? — что делает этот проект; what technologies does this project use? — какие технологии в нём используются; where is the main entry point? — где главная точка входа; explain the folder structure — объясни устройство папок.
Материал для ответа агент собирает сам, и Anthropic пишет об этом прямо: «Claude Code читает файлы вашего проекта по мере необходимости. Вам не нужно вручную добавлять контекст.» Вы называете задачу, а какие файлы под неё открыть, агент решает сам.
Вторым шагом идёт первая правка. В примере Anthropic просьба выглядит как add a hello world function to the main file — добавь функцию hello world в главный файл. Дальше описано, что происходит: «Claude Code находит подходящий файл и показывает вам изменение.» Если перед правкой он спросит разрешение, ответьте согласием.
Чем сеанс Claude Code отличается от чата
Разница между ними — в том, до чего агент дотягивается. Anthropic перечисляет шесть источников, открытых Claude Code в сеансе:
- файлы рабочего каталога и его подкаталогов, а с вашего разрешения — файлы и в других местах;
- терминал и любая команда, которую вы можете запустить сами;
- состояние git: текущая ветка, незафиксированные изменения и история недавних коммитов;
- файл
CLAUDE.md— постоянные указания по проекту; - автоматическая память: первые 200 строк или 25 КБ файла
MEMORY.md, смотря что меньше, загружаются в начале каждого сеанса; - расширения, которые вы настроили, — серверы MCP, skills, субагенты и Claude в Chrome.
Отсюда и вывод Anthropic про разницу с подсказками внутри редактора: «Поскольку Claude видит весь ваш проект, он может работать по всему проекту». Каждое из расширений разобрано отдельно: про серверы MCP есть статья про MCP для Claude Code, про постоянные умения — про skills, а про то, кому агент отдаёт часть работы, — про агентов Claude Code.
Как устроен рабочий цикл: три фазы
Устройство работы Anthropic описывает одной фразой на странице «Как работает Claude Code»: «Когда вы даёте Claude задачу, он работает через три фазы: сбор контекста, выполнение действия и проверка результатов.» Фазы переплетаются между собой, и весь цикл подстраивается под задачу. Вопрос о кодовой базе может обойтись одним сбором контекста, а исправление ошибки проходит все три фазы повторно, пока результат не сойдётся.
Как это выглядит на просьбе «исправьте неудачные тесты», Anthropic расписывает по шагам.
- Claude Code запускает набор тестов.
- Читает вывод ошибки.
- Находит исходные файлы, к которым эта ошибка относится.
- Читает найденные файлы.
- Редактирует их.
- Снова запускает тесты.
Человек при этом остаётся внутри цикла: «Вы можете прервать процесс в любой момент, чтобы направить Claude в другом направлении».
Всё, что агент делает на этих шагах, он делает встроенными инструментами. Anthropic делит их на пять групп:
| Группа | Что делает |
|---|---|
| Операции с файлами | Читать файлы, редактировать код, создавать новые файлы, переименовывать и реорганизовывать |
| Поиск | Находить файлы по шаблону, искать содержимое с помощью regex, исследовать кодовые базы |
| Выполнение | Запускать команды shell, запускать серверы, запускать тесты, использовать git |
| Веб | Искать в Интернете, получать документацию, искать сообщения об ошибках |
| Интеллект кода | Видеть ошибки типов и предупреждения после редактирования, переходить к определениям, находить ссылки (требует плагины интеллекта кода) |
Список закрывает чтение, правку и запуск, а кадры приносит навык — ниже, на первом проекте, это окажется важно.
Что Claude Code делает сам, а что спрашивает
За то, где агент остановится и задаст вопрос, отвечает режим разрешений. Anthropic определяет его так: «Режим разрешений определяет, какие действия Claude может выполнять в сеансе без предварительного запроса у вас.» Режимов шесть, и различаются они набором действий, которые проходят без вопроса.
| Режим | Что выполняется без запроса | Для чего |
|---|---|---|
default (в интерфейсе — Manual) |
только чтение | проверять каждое действие самому, чувствительная работа |
acceptEdits |
чтение, правка файлов и обычные команды файловой системы (mkdir, touch, mv, cp) |
работа над кодом, который вы просматриваете |
plan |
чтение, плюс одобренные классификатором команды, когда доступен режим auto | изучение кодовой базы до изменений |
auto |
всё, с фоновыми проверками безопасности | долгие задачи, меньше запросов на одобрение |
dontAsk |
чтение и заранее одобренные инструменты; всё, что вызвало бы запрос, отклоняется | CI и скрипты с закрытыми правами |
bypassPermissions |
всё | только изолированные контейнеры и виртуальные машины |
Какой режим включён с самого начала, зависит от плана. Anthropic пишет: «На планах Pro, Max и Team встроенный начальный режим разрешений — это режим auto.» На остальных планах начальным оказывается Manual, и тогда агент спрашивает про каждое действие, кроме чтения. Переключается режим сочетанием Shift+Tab в любой момент сеанса.
Свой предел есть у каждого режима, включая bypassPermissions. Anthropic держит отдельный список действий, которые не одобряются автоматически никогда: инструменты под явным правилом запроса, инструменты, требующие участия человека, и удаления rm и rmdir, нацеленные на критический путь, если их не разрешает отдельное правило.
Чтобы один и тот же вопрос приходил только раз, отдельные команды разрешают заранее в файле .claude/settings.json. В примере Anthropic так разрешены npm test и git status. На практике разница между двумя путями видна со второго сеанса: согласие, выданное на ходу, до следующего запуска не доживает, и агент спрашивает о том же заново. Записанное правило перезапуск переживает, поэтому постоянные согласия имеет смысл переносить в файл настроек.
Неудачная правка откатывается. Anthropic обещает это прямо: «Каждое редактирование файла обратимо. Перед редактированием любого файла Claude создаёт снимок текущего содержимого.» Вернуть прежнее состояние можно двойным нажатием Esc или просьбой отменить сделанное. Граница у этого механизма названа там же: контрольные точки отделены от git и охватывают только изменения файлов, а действия, которые задели удалённые системы — базы данных, API, развёртывания, — ими не покрываются. За этой границей выручает обычная фиксация в git. Когда каждое принятое изменение сразу уходит в коммит, вернуться есть куда даже там, где снимок содержимого не помогает.
Файлы, картинки и git внутри разговора
Символ @ включает файл или каталог в разговор сразу, до того как агент сам до них доберётся. Примеры Anthropic: Explain the logic in @src/utils/auth.js — объясни логику в этом файле; What's the structure of @src/components? — как устроена эта папка. Путь допускается и относительный, и абсолютный.
Ссылка на каталог показывает список файлов, а содержимое агент читает отдельно. Ссылка на файл заодно подтягивает CLAUDE.md из каталога этого файла и из родительских каталогов — вместе с файлом приезжают и правила, которые к нему относятся.
Изображение отдают в разговор тремя способами: перетаскиванием в окно Claude Code, вставкой сочетанием Ctrl+V, а на Windows и в подсистеме Windows для Linux — Alt+V, либо указанием пути к файлу. Дальше картинка работает как материал для разбора: снимок экрана с ошибкой, по которому нужно понять, что сломалось, или макет, по которому нужно собрать разметку. Создавать изображения этот способ не позволяет, он только приносит готовые агенту на вход.
Операции с git идут теми же обычными словами. Anthropic называет это так: «Claude Code делает операции Git разговорными», и даёт примеры: what files have I changed? — какие файлы я изменил; commit my changes with a descriptive message — зафиксируй изменения с понятным сообщением; create a new branch called feature/quickstart — заведи ветку с таким именем; show me the last 5 commits — покажи последние пять коммитов; help me resolve merge conflicts — помоги разобраться с конфликтами слияния.
Дальше этот же круг работы продолжается уже в репозитории. Когда ветка уехала на GitHub, агента зовут прямо там — упоминанием @claude в обсуждении или в запросе на слияние, — и он разбирает код, вносит правки и отвечает в том же обсуждении. Что для этого ставится на репозиторий и какие связки носят одно имя, разобрано в статье Claude Code и GitHub.
Команды Claude Code: в терминале и внутри сеанса
Команд два вида, и Anthropic разделяет их по месту набора. Команды оболочки набираются в терминале — ими Claude Code запускают или возобновляют. Команды сеанса набираются уже внутри Claude Code и начинаются с косой черты.
| Команда оболочки | Что делает |
|---|---|
claude |
запустить интерактивный режим |
claude "task" |
запустить интерактивный режим с начальным приглашением |
claude -p "query" |
запустить одноразовый запрос, затем выйти |
claude -c |
продолжить самый последний разговор в текущем каталоге |
claude -r |
возобновить предыдущий разговор |
Внутри сеанса набор шире. Ниже — те команды, которыми ведут сам рабочий цикл; полный перечень открывается прямо в разговоре.
| Команда сеанса | Что делает |
|---|---|
/init |
инициализировать проект с руководством CLAUDE.md |
/memory |
редактировать файлы CLAUDE.md |
/plan |
войти в режим плана прямо из приглашения |
/model |
переключить модель и сохранить её как выбранную |
/context |
показать текущее использование контекста |
/compact |
освободить контекст, суммировав разговор |
/diff |
посмотреть изменения в рабочем дереве |
/permissions |
управлять правилами разрешения, запроса и отказа |
/resume |
выбрать и продолжить прежний разговор |
/clear |
очистить историю разговора |
/doctor |
проверить настройку и починить неполадки установки |
/help |
показать доступные команды |
/mcp |
управлять подключениями серверов MCP |
/exit |
выйти из сеанса; то же делает Ctrl+D дважды |
Список всегда под рукой. Anthropic советует: «Введите / для просмотра всех команд и skills». Там же названы ещё три приёма: Tab дополняет начатую команду, стрелка вверх листает историю, Shift+Tab переключает режимы разрешений.
Порядок набора у команд строгий. Команда распознаётся только в начале сообщения, а текст после её имени становится аргументами. Команда, отправленная во время ответа, встаёт в очередь и выполняется после текущего хода — так что перебить ею работу не получится.
Как правильно пользоваться Claude Code: порядок работы над задачей
Все советы Anthropic держатся на одном ограничении: окно контекста заполняется быстро, и по мере заполнения работа ухудшается. Отсюда и порядок «сначала исследуйте, потом планируйте, потом кодируйте».
- Исследуйте в режиме плана. Войти в него можно сочетанием
Shift+Tabдо строки состояния⏸ plan mode onили запускомclaude --permission-mode plan. - Попросите план и прочитайте его.
- Выйдите из режима плана и дайте реализовать задуманное.
- Попросите зафиксировать изменения.
У самой Anthropic к этому порядку есть оговорка: режим плана добавляет накладные расходы, и если правку можно описать одним предложением, план пропускают.
Отдельный совет касается проверки: «Дайте Claude проверку, которую он может запустить: тесты, сборку, скриншот для сравнения.» Объяснение простое — Claude останавливается тогда, когда работа выглядит завершённой, и без проверки, которую он может запустить сам, «выглядит завершённой» остаётся единственным доступным ему сигналом. Поэтому просите показать доказательство, а не утверждение об успехе: вывод теста, запущенную команду и её результат.
На длинной задаче это видно особенно ясно. Агент берётся доделывать соседнее, о чём его не просили, обходит прямое указание работать определённым инструментом и сообщает о завершении там, где отдельная проверка кода находит и недоделанное, и небезопасное. Проверку поэтому ставят отдельным шагом, а не читают последнее сообщение агента как приёмку.
Саму задачу Anthropic советует ставить по трём правилам. Будьте конкретны: вместо «исправить ошибку» — «исправить ошибку входа, когда пользователи видят пустой экран после ввода неправильных учетных данных». Сложную задачу разбивайте на пронумерованные этапы. Дайте агенту сначала изучить код и только потом менять его. При этом мелочи оставляйте ему: «Вам не нужно указывать, какие файлы читать или какие команды запускать.»
Направление работы поправляют двумя разными способами. Нажатие Esc останавливает Claude немедленно, и выполняемый вызов инструмента отменяется. Набранная поправка с Enter уходит иначе: текущее действие не прерывается, а поправку Claude учтёт, как только оно закончится.
Первый проект: страница описания продукта
Удобнее всего проверять инструмент на работе, которую вы и так собирались сделать. Возьмём страницу описания продукта внутри своего проекта: у неё видимый результат и понятно, когда она готова.
- Попросите агента разобраться в проекте и предложить план страницы, оставаясь в режиме плана.
- Примите план и дайте собрать разметку и текст.
- Попросите запустить сборку и показать изменение.
- Проверьте результат глазами и попросите зафиксировать его в git.
До этого места агент обходится тем, что у него есть: читает файлы, пишет их, запускает команды. А дальше работа упирается в картинку на первый экран, и здесь встроенных инструментов не хватает. В списке из пяти групп выше есть файлы, поиск, выполнение команд, веб и подсказки редактора — рисования среди них нет.
Умение сделать картинку агенту добавляют навыком. У GEN202 для этого заготовлена одна фраза: она целиком напечатана на странице генерации изображений из Claude Code, её копируют и отдают агенту как обычную просьбу. По ней он открывает описание навыка, где расписаны адрес шлюза, передача ключа, постановка задачи и получение результата, и запоминает этот порядок у себя. Ключ он ищет в переменной окружения GEN202_KEY, а когда её нет — сам проводит по подключению.
Дальше кадр для первого экрана делается в том же разговоре. Вы называете, что должно быть на картинке и куда она встанет, агент подбирает разрешение под это место, ставит задачу модели и кладёт готовый файл в проект. Работу выполняет одна из четырёх моделей навыка — Nano Banana 2, Nano Banana Pro, GPT Image 2 или Grok Imagine Image 2.0, — и выбор между ними агент делает сам по названной задаче. Счёт идёт за готовую картинку: на Nano Banana 2 в невысоком разрешении она обходится в 7,2 ₽.
Дольше всего работа буксует на внешнем виде. Агент правит отступы, отчитывается о готовности, а на экране ничего не меняется, и причина такого не раз оказывалась не в его правках, а в общем файле стилей, который сбрасывал их выше по каскаду. Первый экран поэтому проверяют глазами в браузере, а не по описанию сделанного.
Проверку и здесь стоит поставить такую, которую агент запускает сам. Попросите доказательство: файл сохранён по названному пути, страница собралась, картинка встала в отведённое место на первом экране. Из чего состоит сам файл навыка и где он хранится, разобрано в статье про skills для Claude Code.
Сеанс закончился: что переходит в следующий
Каждый следующий сеанс начинается с чистого листа, и Anthropic говорит об этом прямо: «Сеансы независимы. Каждый новый сеанс начинается со свежего context window, без истории беседы из предыдущих сеансов.» Context window — это рабочее окно, в которое помещается всё, чем агент сейчас располагает. Сам разговор при этом сохраняется на вашей машине: каждое сообщение и каждое обращение к инструменту пишется в файл JSONL в каталоге ~/.claude/projects/.
Из независимости сеансов следует и такое. Умение, добавленное агенту во время работы, в текущем разговоре может не подхватиться: видно его после перезапуска, тогда же становится доступной и своя команда, заведённая на ходу.
Вернуться к прежней работе можно тремя путями. Команда claude --continue открывает последний сеанс повторно с тем же идентификатором и дописывает в него новые сообщения. Команда claude --resume даёт выбрать сеанс из списка, а внутри работающего разговора то же делает /resume. Ключ --fork-session и команда /branch копируют историю в новый идентификатор, оставляя исходный сеанс нетронутым. Когда возобновлять нечего, claude --continue печатает No conversation found to continue и завершает работу.
Окно контекста вмещает историю разговора, содержимое прочитанных файлов, выводы команд, CLAUDE.md, автоматическую память, загруженные skills и системные инструкции. Когда места перестаёт хватать, Claude Code сначала убирает старые выводы инструментов, а затем суммирует разговор. Ваши запросы и ключевые фрагменты кода при этом сохраняются, а подробные указания из начала беседы могут потеряться. Вывод Anthropic из этого один: «Поместите постоянные правила в CLAUDE.md, а не полагайтесь на историю беседы.» Сжатие срабатывает само и прийтись может на середину незаконченной работы, поэтому контекст чистят между кусками, а не тогда, когда он уже кончился: перед новой крупной задачей разговор либо сжимают командой /compact, либо начинают заново командой /clear.
Между сеансами память держат два механизма. Первый — файлы CLAUDE.md, которые пишете вы; второй — auto memory, заметки, которые Claude пишет сам по вашим исправлениям и предпочтениям. Оба загружаются в начале каждого разговора. Места для файлов CLAUDE.md разведены по кругу действия:
~/.claude/CLAUDE.md— личные предпочтения, действующие во всех ваших проектах;./CLAUDE.mdили./.claude/CLAUDE.md— указания по проекту, общие для команды;./CLAUDE.local.md— личные предпочтения внутри одного проекта, этот файл добавляют в.gitignore;- уровень управляемой политики организации, со своим путём под каждую систему.
Когда туда дописывать, Anthropic называет тремя признаками: Claude делает одну и ту же ошибку во второй раз, проверка кода выявила то, что он должен был знать о кодовой базе, одно и то же уточнение приходится вводить второй раз. Заметнее всего из них повтор. Когда агент второй раз запускает сервер, который уже работает, или второй раз нарушает договорённость об оформлении коммита, правило дешевле записать, чем поправлять его в каждом разговоре.
Где ещё работает Claude Code: приложение, браузер и редактор кода
Быстрый старт Anthropic описывает работу в терминале, то есть в CLI, но в 2026 году Claude Code работает и в других местах. Тот же агент доступен в веб-версии, настольным приложением, расширением для VS Code и JetBrains IDEs и в Slack.
Отдельно Anthropic разделяет три среды выполнения — то есть места, где на самом деле запускается код. Локальная среда — ваша машина с полным доступом к файлам и инструментам. Облако — виртуальные машины Anthropic или собственные среды организации. Удалённое управление — код выполняется на вашей машине, а управляете вы им из браузера.
Порядок работы во всех интерфейсах один. Anthropic говорит об этом прямо: «Интерфейс определяет, как вы видите и взаимодействуете с Claude, но основной агентивный цикл идентичен.» Три фазы, режимы разрешений и команды сеанса остаются теми же, меняется только то, где выполняется код и как вы за ним наблюдаете. Чем Claude Code отличается от второй распространённой оболочки, разобрано в статье Claude Code или Codex.
Частые вопросы
Как начать пользоваться Claude Code?
Порядок из четырёх действий. Перейдите в каталог проекта командой cd /path/to/your/project, наберите claude и войдите по появившемуся приглашению. Задайте первый вопрос про сам проект — например what does this project do?, то есть «что делает этот проект». Дальше попросите небольшую правку и посмотрите, как агент показывает изменение. Установка сюда не входит, её порядок разобран в статье как установить Claude Code.
Нужна ли платная подписка, чтобы войти в Claude Code? Подписка — один из путей, но не единственный, а вот учётная запись обязательна в любом случае. Anthropic называет четыре вида: подписку Pro, Max, Team или Enterprise с пометкой «рекомендуемая», учётную запись Claude Console с предоплаченными кредитами, доступ через Amazon Bedrock, Google Cloud’s Agent Platform или Microsoft Foundry и самостоятельно размещённый шлюз приложений Claude. Что входит в каждый план и что доступно без оплаты, разобрано в статье про подписку Claude Code.
Как поменять модель в Claude Code?
Внутри сеанса это делает команда /model: она переключает модель и сохраняет выбранную. Какая модель работает сейчас, видно над строкой приглашения — там же, где версия и рабочий каталог. Пределы, в которые упирается работа на разных планах, разобраны в статье про лимиты Claude Code.
Что делать, если Claude Code спрашивает разрешение на каждое действие?
Значит, сеанс идёт в режиме Manual, где без запроса проходит только чтение. Режим переключают сочетанием Shift+Tab, а посмотреть и поменять правила разрешения, запроса и отказа позволяет команда /permissions. Команды, которые вы одобряете всегда, выносят в файл .claude/settings.json — после этого вопрос по ним больше не приходит.
Как отменить неудачную правку?
Снимок файла делается до правки, поэтому откат возможен всегда: дважды нажмите Esc или попросите отменить сделанное. Посмотреть, что изменилось в рабочем дереве, помогает команда /diff. За этой границей откат не работает: контрольные точки охватывают изменения файлов и не достают до баз данных, API и развёртываний.
Видит ли Claude Code файлы за пределами рабочего каталога?
Сам по себе он работает с каталогом и его подкаталогами, а до файлов в других местах добирается с вашего разрешения. Открыть конкретный файл или каталог сразу помогает символ @ в тексте просьбы, и путь в нём допускается абсолютный.
Что сделать, чтобы Claude Code держал договорённости на большой задаче?
Anthropic советует держать порядок «исследовать, планировать, делать, фиксировать» и разбивать сложную работу на пронумерованные этапы. Постоянные правила выносят в CLAUDE.md: при заполнении контекста подробные указания из начала беседы могут потеряться, а этот файл читается заново в каждом сеансе. Разбор большого куска отдают субагенту, чтобы он не занял место в общем разговоре, — про это есть статья про агентов Claude Code.
Сколько стоит картинка, которую агент делает по навыку? Цена складывается из модели и разрешения. На Nano Banana 2 в невысоком разрешении готовая картинка обходится в 7,2 ₽, на Nano Banana Pro в высоком — 21,6 ₽. Поэтому черновые кадры берут в низком разрешении, а высокое оставляют тому, что пойдёт на страницу. Цены остальных моделей навыка показывает таблица на странице генерации изображений из Claude Code, и меняются они вместе с каталогом.