Как установить и настроить Claude Code

Инструкция сверена с документацией Claude Code в октябре 2026 года. Claude Code обновляется часто, поэтому названия меню и номера версий со временем могут поменяться.

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

Нужен платный аккаунт Claude: подписка Pro, Max, Team или Enterprise либо аккаунт Claude Console с оплатой по API. В бесплатном плане claude.ai Claude Code нет. Компании подключают его и через облачные платформы Amazon Bedrock, Google Cloud и Microsoft Foundry.

Требования к компьютеру скромные. Подойдёт macOS 13 и новее, Windows 10 версии 1809 и новее, Ubuntu 20.04+, Debian 10+ или Alpine Linux 3.19+, от 4 ГБ оперативной памяти и постоянный интернет. Официально Claude Code работает только в странах, где Anthropic предоставляет свои сервисы.

Удобнее всего нативный установщик. Он ставит Claude Code в домашнюю папку, не требует прав администратора и потом сам обновляется в фоне. На macOS, Linux и в WSL откройте терминал и выполните:

На Windows команда зависит от оболочки. Если строка ввода в терминале начинается с PS C:\, вы в PowerShell:

Если просто с C:\, это командная строка CMD:

Пока установщик скачивает файлы, он ничего не пишет на экран, так что подождите минуту. Когда он закончит, откройте новое окно терминала.

На Windows стоит поставить ещё Git for Windows. С ним Claude Code выполняет команды через Git Bash, без него через PowerShell. Если ваши проекты живут в Linux-окружении, ставьте Claude Code внутрь WSL 2. Там работает сэндбокс для команд, которого в нативном Windows нет.

Если привычнее пакетный менеджер, есть Homebrew для macOS и WinGet для Windows:

У Homebrew два варианта. Пакет claude-code идёт по стабильному каналу, версия в нём примерно на неделю старше и без релизов с серьёзными ошибками. Пакет claude-code@latest получает каждую версию в день выхода. Установки через Homebrew и WinGet сами не обновляются, для этого есть команды brew upgrade claude-code и winget upgrade Anthropic.ClaudeCode. Поставить Claude Code можно и через npm командой npm install -g @anthropic-ai/claude-code, если у вас Node.js 22 или новее. Только не запускайте её через sudo, это небезопасно и ломает права доступа к файлам.

Если терминал вам непривычен, Claude Code есть и в десктопном приложении Claude для macOS, Windows и Linux, там командная строка не нужна. Дальше речь о версии для терминала.

В новом окне терминала выполните:

Рабочая установка печатает номер версии, например 2.1.211 (Claude Code). Если терминал отвечает, что команда claude не найдена, папка установки ещё не попала в переменную PATH. Обычно помогает перезапуск терминала, а если нет, пошаговое решение есть в разделе о проблемах с установкой. Подробную диагностику даёт claude doctor. Он ничего не меняет, только проверяет установку и файлы настроек и подсказывает, что исправить.

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

При первом запуске откроется браузер для входа в аккаунт Claude. Данные для входа сохранятся, и повторно входить не придётся. Сменить аккаунт можно командой /login прямо в сеансе. Если в окружении задана переменная ANTHROPIC_API_KEY, Claude Code спросит, использовать ли этот ключ. Если согласиться, вход через браузер не понадобится, а запросы будут оплачиваться по API.

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

В свежих версиях сеанс начинается в режиме auto. Claude Code сам правит файлы и запускает команды, а фоновый классификатор останавливает рискованные действия. Если хотите подтверждать каждый шаг, переключите режим, как это сделать, рассказано ниже.

Ещё несколько команд пригодятся с первого дня. claude -c продолжает последний разговор в этой папке, claude -r открывает список прошлых сеансов, а claude -p "вопрос" выполняет одну задачу и сразу выходит, это удобно в скриптах. Внутри сеанса /help показывает все команды, /model переключает модель, /clear начинает разговор заново, а /exit завершает работу.

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

Пишите туда то, до чего агент не догадается сам, и держите файл коротким. Anthropic советует укладываться в 200 строк, потому что длинный файл съедает контекст и хуже соблюдается. Подробности можно вынести в отдельные документы и подключить строкой вида @docs/git-instructions.md, они загрузятся вместе с основным файлом.

Таких файлов может быть несколько. ~/.claude/CLAUDE.md в домашней папке действует во всех ваших проектах. CLAUDE.md в репозитории попадает в git и работает для всей команды. CLAUDE.local.md остаётся только у вас, его стоит добавить в .gitignore. Если в репозитории уже лежит AGENTS.md для других агентов, Claude Code прочитает его сам, когда рядом нет CLAUDE.md.

Кроме ваших инструкций есть автопамять. Claude Code сам записывает выводы из ваших поправок и предпочтений и подгружает их в следующих сеансах. Но и память, и CLAUDE.md для агента только контекст, а не жёсткие правила. То, что ему нельзя делать ни при каких условиях, задают в правах доступа.

Что Claude Code может делать без спроса, решают режим сеанса и правила в файлах настроек. Режимы переключаются клавишами Shift+Tab.

В ручном режиме, в интерфейсе он называется Manual, Claude Code без спроса только читает файлы, а на каждую правку и команду просит разрешения. Режим acceptEdits разрешает без спроса править файлы и выполнять простые файловые команды вроде mkdir и mv внутри папки проекта. В режиме plan он изучает код и составляет план, ничего не меняя, и берётся за правки после вашего одобрения. С него удобно начинать большие задачи. В режиме auto Claude Code действует сам, а каждое действие проверяет фоновый классификатор. Есть ещё режим без проверок, bypassPermissions. Его включают только в изолированных контейнерах и виртуальных машинах, где агент не навредит основной системе.

Постоянные правила задают в файлах настроек. Личные настройки для всех проектов лежат в ~/.claude/settings.json. Общие настройки команды хранятся в .claude/settings.json внутри репозитория и коммитятся в git. Ваши личные исключения для одного проекта живут в .claude/settings.local.json, этот файл Claude Code сам держит вне git. Например, так можно разрешить линтер и тесты без подтверждения и запретить агенту читать файлы с секретами:

Когда на запрос разрешения вы отвечаете «Yes, and don't ask again», Claude Code сам записывает такое правило в .claude/settings.local.json. Команда /status показывает, какие файлы настроек загрузились в текущем сеансе, а /config открывает меню личных настроек вроде темы оформления.

Через открытый протокол MCP Claude Code подключается к внешним системам: трекерам задач, базам данных, документации, мониторингу. Удалённый сервер добавляется одной командой:

По умолчанию сервер доступен только вам и только в текущем проекте. С флагом --scope project он записывается в файл .mcp.json, который можно закоммитить для всей команды, а с --scope user подключается во всех ваших проектах. Список серверов и их состояние показывает claude mcp list. Если сервер требует входа, выполните /mcp в сеансе и авторизуйтесь в браузере.

Подключайте только серверы, которым доверяете. Сервер, который приносит в контекст чужой контент, например письма или веб-страницы, может принести и чужие инструкции. Это классическая промпт-инъекция.

Нативная установка обновляется сама. Claude Code проверяет новые версии при запуске и время от времени во время работы, скачивает их в фоне, и новая версия начинает работать со следующего запуска. Обновиться сразу можно командой claude update. Если стабильность важнее свежих функций, переключите канал обновлений на stable в меню /config или строкой "autoUpdatesChannel": "stable" в settings.json.

Дальше стоит освоить субагентов, скилы и хуки. С ними Claude Code превращается из помощника в терминале в рабочую среду, настроенную под ваш проект. Этому посвящён курс «Основы Claude Code».