Claude Code

Claude Code простыми словами

Claude Code - это агент для разработки, который работает с проектом, а не только отвечает на вопросы о коде. Он может читать файлы, искать по репозиторию, редактировать код, запускать команды, анализировать вывод терминала и помогать с pull request. Anthropic описывает Claude Code как инструмент, доступный в терминале, IDE, desktop app и браузере.

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

Главный сдвиг в уровне доступа. Чат рассуждает о коде, который ему дали. Claude Code работает внутри среды разработки, поэтому требует Git-дисциплины, permissions и проверки результата.

Чем Claude Code отличается от Claude Chat

Claude Chat - универсальный ассистент, а Claude Code - рабочий инструмент для разработки с доступом к файлам, терминалу, GitHub и инженерным workflow.

Разница по задачам:

• Claude Chat: объяснить идею, написать пример, разобрать небольшой фрагмент.
• Claude Code: найти связанные файлы, внести правки, показать diff.
• Claude Chat: помочь обсудить архитектурный подход.
• Claude Code: проверить, как изменение ложится на текущую кодовую базу.
• Claude Chat: предложить тест.
• Claude Code: добавить тест в проект и запустить команду проверки.
• Claude Chat: дать список возможных причин ошибки.
• Claude Code: посмотреть stack trace, найти файл и предложить минимальную правку.

Поэтому Claude Code стоит описывать как agentic coding tool. Его ценность появляется там, где есть репозиторий, тесты, история изменений и проверяемый результат.

Где работает Claude Code

Claude Code доступен через несколько интерфейсов: терминал, desktop app, IDE extensions, claude.ai/code, Remote Control, Slack и CI/CD pipelines. В документации Anthropic подчёркивается, что интерфейс меняет способ взаимодействия, но агентный цикл остаётся тем же.

Основные варианты работы:

• Terminal / CLI - главный формат для тех, кто живёт в командной строке.
• Claude Code Desktop - приложение для macOS и Windows; на Linux предлагается использовать CLI.
• VS Code extension - графический интерфейс в редакторе с inline diffs, plan review, @-mentions файлов и историей разговоров.
• Cursor, Windsurf и другие VS Code forks - установка через расширение или Open VSX.
• JetBrains IDEs - поддержка через IDE-интеграции.
• claude.ai/code - веб-режим с GitHub и облачной средой.
• GitHub Actions - вызов через @claude в issue или pull request.
• Agent SDK - программное встраивание агента в собственные инструменты.

Для старта проще выбрать VS Code extension или CLI. Первый вариант удобнее визуально, второй ближе к реальной инженерной работе: команды, тесты, Git и локальный контекст остаются в одном месте.

Что попробовать в первые 30 минут

Начинать с Claude Code лучше с маленьких задач, где результат виден сразу. Это снижает риск и быстро показывает, чем агент отличается от обычного чат-бота.

1. Объяснить структуру проекта
   Запрос: «Объясни структуру проекта: где входная точка, где бизнес-логика, где тесты и как всё запускается».
2. Найти причину ошибки
   Вставьте stack trace или лог. Попросите Claude Code найти вероятный источник ошибки и предложить минимальную правку.
3. Сделать план без изменений
   Запрос: «Сначала предложи план, файлы пока не меняй». Это базовый безопасный режим перед multi-file правками.
4. Написать тест к небольшой функции
   Лучше выбирать функцию с понятным входом и выходом. Результат можно сразу проверить запуском тестов.
5. Проверить текущий diff
   Запрос: «Проверь текущий diff: найди риск регрессии, недостающие тесты и лишние изменения».
6. Добавить правило в память проекта
   Например: «Запомни, что в этом проекте нужно использовать pnpm, а не npm». Через /memory можно посмотреть, какие memory-файлы загружены.

Plan mode: сначала исследование, потом правки

Plan mode - один из самых важных режимов Claude Code. В этом режиме агент исследует проект, читает и ищет файлы, может запускать exploration-команды, но не редактирует исходники до утверждения плана. В документации Anthropic указано, что plan mode можно включить через /plan или Shift+Tab.

Plan mode нужен для задач, где цена ошибки выше обычной:

• рефакторинг модуля;
• исправление бага в нескольких файлах;
• изменение публичного API;
• миграции;
• правки авторизации;
• работа с CI/CD;
• обновление зависимостей.

Хорошая команда:

Сначала перейди в планирование. Найди связанные файлы, предложи план и список проверок. Код пока не меняй.

Для проекта plan mode можно сделать режимом по умолчанию через defaultMode в .claude/settings.json . Такой подход подходит командам, где агент не должен сразу менять файлы.

Permission modes: как ограничивать автономность

Claude Code управляется через permission modes. Доступные режимы включают default , acceptEdits , plan , auto , dontAsk и bypassPermissions ; режим можно задать через CLI-флаг --permission-mode .

Практическая логика такая:

• plan - безопасный старт: агент исследует и предлагает план.
• default - нормальный рабочий режим с подтверждениями.
• acceptEdits - правки принимаются проще, команды всё ещё требуют внимания.
• auto - меньше ручных подтверждений, решения проходят через classifier.
• dontAsk / bypassPermissions - опасные режимы для доверенных сценариев, не для новичков.

Через /permissions можно смотреть и менять правила доступа к инструментам. Правила бывают allow , ask и deny ; deny имеет приоритет над ask и allow. Важная деталь: permissions enforced by Claude Code, not by the model - это технический слой, а не просьба в промпте.

Auto mode: меньше подтверждений, но не автопилот

Auto mode появился как ответ на permission fatigue: когда пользователь так часто нажимает approve, что перестаёт читать, что именно разрешает. Anthropic описывает auto mode как режим, где отдельная classifier-модель проверяет действия перед выполнением и блокирует опасные, разрушительные или выходящие за рамки запроса операции.

Auto mode не доступен всем. В документации указано, что он требует Claude Code v2.1.83 или новее и доступен на Max, Team, Enterprise и API, но не на Pro; для Team и Enterprise администратор должен разрешить его в настройках.

Где auto mode уместен:

• исправить lint-ошибки;
• прогнать однотипные форматирования;
• внести небольшие безопасные правки;
• обновить документацию;
• выполнить серию локальных проверок.

Где auto mode опасен:

• миграции баз данных;
• работа с production;
• удаление веток;
• изменение IAM/секретов;
• деплой;
• массовый рефакторинг без тестов.

Anthropic сама приводит примеры агентных сбоев: удаление remote git branches из-за неверно понятой инструкции, загрузка GitHub auth token во внутренний compute cluster и попытка миграций against production database. Это хорошее напоминание: auto mode снижает шум, но не отменяет инженерную проверку.

Slash-команды: управление сессией изнутри

Слэш-команды "/" управляют Claude Code внутри сессии. Они помогают переключать модели, менять permissions, очищать контекст, запускать workflow и вызывать skills. Команды вводятся с / в начале сообщения.

Полезные команды для старта:

• /help - посмотреть доступные команды.
• /plan - перейти к планированию.
• /permissions - управлять доступом к инструментам.
• /memory - посмотреть и редактировать загруженные memory-файлы.
• /compact - сжать контекст длинной сессии.
• /clear - очистить контекст между несвязанными задачами.
• /debug - bundled skill для диагностики.
• /simplify - bundled skill для упрощения.
• /loop - bundled skill для повторяемых циклов работы.

В документации Anthropic указано, что bundled skills вызываются как команды через / , а кастомные команды были объединены со skills: файл в .claude/commands/deploy.md и skill в .claude/skills/deploy/SKILL.md создают /deploy .

CLAUDE.md и память проекта

Файл CLAUDE.md - основной способ объяснить Claude Code правила проекта. В этот файл выносят стиль кода, команды запуска, соглашения команды, требования к тестам, запреты и рабочие сценарии.

Пример содержимого:

Используй pnpm, не npm.
Перед multi-file изменениями сначала предложи план.
Не меняй публичный API без отдельного предупреждения.
Для новых функций добавляй unit-тесты.
После правок запускай pnpm test для затронутого пакета.

Claude Code читает инструкции, settings, skills, subagents и memory из .claude в проекте и из ~/.claude в домашней директории. Проектные файлы можно коммитить в Git, личные настройки остаются у пользователя.

Через /memory можно посмотреть загруженные CLAUDE.md , CLAUDE.local.md и rules-файлы. Документация предупреждает: 

CLAUDE.md передаётся как user message после system prompt, поэтому это инструкция, а не жёсткая гарантия. Чем конкретнее правило, тем выше шанс, что агент будет ему следовать.

Skills: старт-киты для повторяющихся задач

Skills расширяют возможности Claude Code через переиспользуемые инструкции и workflow. Skill создаётся через SKILL.md ; Claude добавляет его в toolkit и использует, когда он релевантен, или пользователь вызывает skill напрямую через /skill-name .

Skills нужны, когда одна и та же процедура повторяется:

• «как писать тесты в этом проекте»;
• «как оформлять pull request»;
• «как проверять безопасность auth-модуля»;
• «как обновлять документацию»;
• «как чинить flaky tests»;
• «как проводить frontend-review».

Главная разница между CLAUDE.md и skill: CLAUDE.md загружается как общий контекст, а тело skill загружается только при использовании. Поэтому длинные инструкции лучше держать в skills, чтобы не забивать контекст каждой сессии.

Hooks: автоматизация вокруг действий агента

Хуки - shell-команды, которые запускаются в определённые моменты жизненного цикла Claude Code: после редактирования файлов, перед выполнением команд, при ожидании ввода, на старте сессии и в других событиях. Anthropic описывает hooks как deterministic control: правила выполняются всегда, а не по решению модели.

Типичные сценарии hooks:

• форматировать файлы после Edit или Write ;
• блокировать опасные команды;
• запускать линтер после изменений;
• отправлять уведомление, когда Claude ждёт ввода;
• добавлять контекст на старте сессии;
• проверять, что агент не трогает запрещённые директории.

Хуки особенно полезны командам. Если правило критично, его лучше закрепить hook, а не просьбой в промпте.

Субагенты: отдельные агенты для узких задач

Subagents - специализированные помощники внутри Claude Code. Каждый субагент работает в своём контекстном окне, с отдельным system prompt, tool access и permissions. Anthropic рекомендует использовать их, когда побочная задача может заполнить основной контекст логами, поиском или содержимым файлов.

Примеры subagents:

• test-writer - пишет тесты;
• security-reviewer - проверяет риски;
• frontend-auditor - смотрит UI-компоненты;
• migration-checker - анализирует миграции;
• docs-updater - обновляет документацию;
• debug-researcher - собирает факты по багу.

Subagents экономят основной контекст. Вместо того чтобы тащить в главный диалог сотни строк логов, отдельный агент исследует проблему и возвращает краткое резюме.

MCP и внешние инструменты

MCP нужен, чтобы Claude Code работал не только с файлами проекта, но и с внешними источниками: документацией, таск-трекером, внутренними сервисами, базой знаний, CI/CD или API. В Claude Agent SDK MCP указан как одна из базовых возможностей вместе с hooks, subagents, permissions и sessions.

Практические сценарии MCP:

• подтянуть внутреннюю документацию;
• связать агент с Jira или Linear;
• дать доступ к design system;
• подключить knowledge base;
• связать Claude Code с тестовой инфраструктурой;
• дать безопасный доступ к internal tools.

MCP повышает полезность агента, но увеличивает требования к безопасности. Чем больше внешних систем видит агент, тем строже должны быть permissions, allowlist и правила команды.

GitHub Actions и @claude

Claude Code GitHub Actions позволяет вызывать агента прямо в issue или pull request через @claude . По документации Anthropic, Claude может анализировать код, создавать pull request, реализовывать функции и исправлять баги с учётом стандартов проекта.

Сценарии:

• @claude review - проверить pull request;
• попросить исправить замечание в PR;
• превратить issue в черновик реализации;
• добавить тесты;
• обновить документацию;
• автоматически реагировать на CI failures.

GitHub Actions построен на Claude Agent SDK. В официальном репозитории claude-code-action указано, что action может отвечать на @claude mentions, issue assignments и automation tasks, а также поддерживает Anthropic API, Amazon Bedrock, Google Vertex AI и Microsoft Foundry.

Claude Agent SDK для своих инструментов

Claude Agent SDK позволяет встроить возможности Claude Code в собственные приложения и workflow. В SDK доступны built-in tools, hooks, subagents, MCP, permissions и sessions. Агент может читать файлы, создавать и редактировать их, запускать Bash-команды, искать по проекту через Glob/Grep, использовать WebSearch и WebFetch.

SDK интересен командам, которые хотят сделать свой внутренний агентный workflow:

• бот для ревью;
• агент для flaky tests;
• автоматический triage issues;
• инструмент миграций;
• проверка документации;
• CI/CD-автоматизация;
• внутренний coding assistant с корпоративными правилами.

Для обычного пользователя SDK не нужен на старте. Для платформенной команды это способ превратить Claude Code из продукта в инфраструктурный слой разработки.

Web, cloud и перенос задач

Claude Code работает и через web-интерфейс claude.ai/code . Anthropic описывает GitHub authentication options, cloud environment, setup scripts, dependency management, network access, перенос задач между web и terminal через --remote и --teleport , работу с сессиями и auto-fix pull requests.

Облачный режим удобен для задач, которые можно отдать агенту без постоянного наблюдения:

• исследовать issue;
• подготовить PR;
• исправить CI failure;
• обработать review comments;
• обновить зависимости;
• написать документацию.

Слабое место облачных задач - границы. Если issue сформулирован широко, агент может сделать много работы и попасть не туда. Для cloud лучше давать короткие задачи с явной проверкой результата.

Лайфхаки для повседневной работы

1. Одна сессия - одна задача
   Не смешивайте unrelated work. В best practices Anthropic отдельно указывает «kitchen sink session» как распространённую ошибку; решение - /clear между несвязанными задачами.
2. Сначала план, потом код
   Для сложных задач используйте /plan или Shift+Tab .
3. Diff важнее ответа
   Проверяйте не объяснение агента, а реальные изменения.
4. Большую задачу дробите
   «Перепиши модуль» хуже, чем «вынеси валидацию в отдельную функцию и добавь тесты».
5. Повторяемое - в skill
   Если вы третий раз пишете один и тот же checklist, пора сделать skill.
6. Жёсткие правила - в permissions или hooks
   Промпт может быть проигнорирован. Deny rule или hook сработает надёжнее.
7. Длинную сессию сжимайте
   Используйте /compact , когда контекст разросся.
8. Проектные правила храните в Git
   .claude/settings.json , CLAUDE.md , skills и hooks можно превратить в общую инженерную практику команды.

Тарифы и лимиты Claude Code

Claude Code доступен через Claude Pro, Max, Team и Enterprise, а также через API. Для Pro и Max лимиты Claude и Claude Code общие: активность в обоих инструментах расходует один пул использования. При достижении лимита пользователь может ждать сброса, перейти на Max 5x/20x, включить extra usage или использовать pay-as-you-go через Claude Console.

Практическая логика выбора:

• Pro - личное использование и умеренная работа с Claude Code.
• Max 5x / 20x - интенсивная разработка и большие репозитории.
• Team - командная работа, администрирование и общие правила.
• Enterprise - безопасность, управление, масштабирование.
• API / SDK - собственные автоматизации и CI/CD.

Где Claude Code силён

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

Плюсы:

• работает с реальными файлами;
• запускает команды;
• хорошо подходит для терминального workflow;
• умеет планировать перед изменениями;
• поддерживает permissions и auto mode;
• использует CLAUDE.md и memory;
• расширяется через skills;
• автоматизируется через hooks;
• поддерживает subagents;
• работает с GitHub Actions;
• доступен через Agent SDK;
• подходит для командных правил и внутренних workflow.

Самый сильный сценарий - инженерная рутина: тесты, ревью, поиск ошибок, документация, рефакторинг небольших частей, подготовка PR.

Где Claude Code слабее

Claude Code остаётся агентом, который может ошибаться. У него есть доступ к действиям, поэтому ошибка иногда дороже, чем неверный ответ в чате.

Минусы:

• может менять больше файлов, чем нужно;
• иногда неверно понимает архитектуру;
• может попасть в длинную цепочку лишних действий;
• требует Git и тестов для безопасной работы;
• auto mode доступен не на всех планах;
• сложная настройка permissions, hooks и skills требует времени;
• большие репозитории быстрее расходуют лимиты;
• корпоративное использование требует администрирования.

Главный риск - не слабая генерация кода, а неверная рамка задачи. Если пользователь просит «почини всё», агент начинает угадывать. Если задача звучит как «исправь ошибку в auth middleware, не меняй публичный API, добавь тесты», шанс полезного результата выше.

Функциональность Claude Code

Работа с кодом

• Генерация кода
• Редактирование файлов
• Multi-file editing
• Рефакторинг
• Объяснение кодовой базы
• Поиск ошибок
• Анализ stack trace
• Генерация тестов
• Запуск команд
• Проверка diff
• Code review
• Подготовка pull request

Агентные режимы

• Plan mode
• Permission modes
• Auto mode
• Accept edits
• Review workflow
• Headless mode
• Remote sessions
• Session fork / resume
• Context compaction
• Project trust

Настройка и память

• CLAUDE.md
• CLAUDE.local.md
• /memory
• .claude/settings.json
• User / project / local / managed scopes
• Repository rules
• Output styles
• Project-specific guidance

Расширения и автоматизация

• Skills
• Bundled skills
• Custom slash commands
• Hooks
• Subagents
• Plugins
• MCP servers
• Agent SDK
• GitHub Actions
• CI/CD workflows

Безопасность

• Permissions
• Allow / ask / deny rules
• Sandbox
• Auto mode classifier
• Network restrictions
• PreToolUse hooks
• Managed settings
• Logs and audit trails
• Git checkpoints

Как правильно ставить задачи Claude Code

Плохие запросы:

• «улучши проект»;
• «перепиши всё»;
• «сделай нормально»;
• «оптимизируй код»;
• «добавь безопасность».

Хорошие запросы:

• «найди причину ошибки в этом stack trace и предложи минимальную правку»;
• «сначала составь план, файлы пока не меняй»;
• «добавь unit-тесты для функции расчёта скидки»;
• «исправь баг в форме входа, не меняй публичный API»;
• «проверь текущий diff перед коммитом»;
• «обнови документацию только для изменённого endpoint»;
• «после правок запусти pnpm test для этого пакета».

Рабочий шаблон:

Задача: [что нужно сделать].
Ограничения: [какие файлы не трогать, API не менять, зависимости не добавлять].
Проверка: [какие тесты запустить].
Режим: сначала план, потом изменения после подтверждения.

Кому подойдёт Claude Code

Claude Code подойдёт тем, кто работает с реальными проектами и хочет ускорить инженерную рутину.

Лучшие аудитории:

• backend-разработчики;
• frontend-разработчики;
• fullstack-команды;
• DevOps;
• QA;
• тимлиды;
• студенты с базовым знанием Git;
• команды на GitHub;
• разработчики внутренних инструментов;
• платформенные команды.

Новичкам Claude Code тоже полезен, но порог входа выше, чем у Claude Chat. Лучше начинать с VS Code extension, объяснения проекта и небольших правок. Терминал, hooks, subagents и MCP стоит подключать позже.

Кому стоит начинать с Claude Code

Claude Code стоит попробовать тем, кто уже работает с Git, тестами и IDE. Инструмент особенно хорошо раскрывается в проектах, где есть понятная структура, команды проверки, review-процесс и правила команды.

Оптимальный старт:

1. установить Claude Code в VS Code или CLI;
2. открыть небольшой проект;
3. попросить объяснить структуру;
4. включить plan mode перед изменениями;
5. добавить простой CLAUDE.md ;
6. дать одну проверяемую задачу;
7. посмотреть diff;
8. запустить тесты;
9. принять или откатить изменения.

Claude Code показывает зрелое направление agentic coding: агент уже умеет больше, чем генерировать фрагменты, но требует инженерного контроля. Лучший результат получается не у тех, кто отдаёт ему весь проект, а у тех, кто умеет ставить узкие задачи, держать permissions под контролем и проверять каждое изменение через Git.