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

Инструкция подходит для версий Claude Code до 2.1.322, полный справочник есть в документации Claude Code.

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

Что нужно заранее

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

Требования к компьютеру скромные11Процессор подойдёт x64 или ARM64, оболочка Bash, Zsh, PowerShell или CMD. Git для работы не обязателен. На Debian, Fedora, RHEL и Alpine Claude Code ставится ещё и через apt, dnf или apk.. Подойдёт macOS 13 и новее, Windows 10 версии 1809 и новее, Ubuntu 20.04+, Debian 10+ или Alpine Linux 3.19+, от 4 ГБ оперативной памяти и постоянный интернет. Официально Claude Code работает только в странах, где Anthropic предоставляет свои сервисы.

Установка

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

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

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

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

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

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

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

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

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

brew install --cask claude-code
winget install Anthropic.ClaudeCode

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

Проверка установки

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

claude --version

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

Вход и первый сеанс

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

cd ~/projects/my-app
claude

При первом запуске откроется браузер для входа в аккаунт Claude. Данные для входа сохранятся44Данные входа на macOS лежат в системной связке ключей Keychain, на Linux в файле ~/.claude/.credentials.json с правами 0600, на Windows в %USERPROFILE%\.claude\.credentials.json. Выйти из аккаунта можно командой /logout., и повторно входить не придётся. Сменить аккаунт можно командой /login прямо в сеансе. Если в окружении задана переменная ANTHROPIC_API_KEY, Claude Code спросит, использовать ли этот ключ. Если согласиться, вход через браузер не понадобится, а запросы будут оплачиваться по API.

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

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

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

Инструкции для проекта в CLAUDE.md

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

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

Таких файлов может быть несколько55Порядок загрузки нескольких CLAUDE.md, правила в .claude/rules/ и устройство автопамяти подробно разобраны в статье о контексте и памяти.. ~/.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 действует сам, а каждое действие проверяет фоновый классификатор. Есть ещё режим без проверок66Даже в bypassPermissions Claude Code в терминале спрашивает перед rm на критических путях вроде корня диска или домашней папки. С версии 2.1.311 этот вопрос снимает CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS=1 в окружении запуска. Документация предназначает переменную только для одноразовых контейнеров., bypassPermissions. Его включают только в изолированных контейнерах и виртуальных машинах, где агент не навредит основной системе.

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

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

7

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

В тот же блок permissions можно добавить два новых ключа. С версии 2.1.314 "blockWritesOutsideWorkingDirectories": true не даёт тулам Write, Edit и NotebookEdit писать за пределами рабочих папок в любом режиме, даже в bypassPermissions. Команды в терминале и MCP-тулы этот ключ не ограничивает, для них нужен сэндбокс. С версии 2.1.319 "denyInsteadOfPrompting": true пригодится сеансу, который идёт без вас: вызов, который ждал бы вашего разрешения, отклоняется, и работа продолжается. Этот ключ читается только из ~/.claude/settings.json, настроек организации или флага --settings, репозиторий его включить не может.

Внешние сервисы через MCP

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

claude mcp add --transport http notion https://mcp.notion.com/mcp

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

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

Обновления

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

Дальше стоит освоить субагентов, скилы и хуки, с ними Claude Code подстраивается под ваш проект.

Курсы по теме

У каждого курса есть бесплатная часть: оставьте почту и начните сразу.

Рассылка

Раз в месяц — новые курсы, обновления программ и платформы. Отписаться можно в один клик из любого письма.

Начните учиться сегодня

Все курсы за 1500 ₽ в месяц. Доступ откроется сразу после оплаты, отменить можно в любой момент.

Для компаний — 5000 ₽ в месяц за сотрудника