Claude Code CLI: Полное руководство 2026 — Установка, Настройка, MCP

Claude Code CLI — терминальный AI-ассистент от Anthropic, который меняет подход к разработке. Это не просто чат-бот: инструмент понимает твою кодовую базу целиком, выполняет команды, редактирует файлы и автоматизирует рутину. Опытные архитекторы с 10+ годами стажа признают: после месяца использования рабочий процесс становится «агентским» и менее рутинным. В этом гайде — всё от установки до продвинутых техник.

Что такое Claude Code CLI

Claude Code CLI — это терминальный AI-агент от Anthropic, который интегрирует модель Claude непосредственно в командную строку разработчика. Проще говоря: Claude Code — это инструмент, который понимает весь проект целиком и способен самостоятельно читать и редактировать файлы, запускать команды, управлять Git и автоматизировать рутинные задачи. В отличие от чат-ботов и IDE-плагинов с автодополнением, это полноценный «агент» — он планирует действия, выполняет их последовательно и контролирует результат. Всё происходит в терминале, под контролем разработчика.

Claude Code запущен Anthropic в феврале 2025 года. Работает на моделях Claude Sonnet 4.5 и Opus 4.5 с контекстным окном до 200 000 токенов — этого достаточно, чтобы охватить архитектуру крупного проекта без ручной подачи файлов. Вот как выглядит типичная сессия:

$ cd ~/projects/my-app
$ claude
> Найди все API-эндпоинты без обработки ошибок и добавь try-catch

● Читаю структуру проекта...
● Найдено 12 файлов в src/api/
● Обнаружено 3 эндпоинта без try-catch: users.ts, orders.ts, payments.ts
● Предлагаю изменения:

  src/api/users.ts
  + try {
  +   const user = await db.findUser(id);
  + } catch (error) {
  +   return res.status(500).json({ error: 'Internal server error' });
  + }

Записать файл? [Y/n]

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

Зачем нужен

Главная проблема, которую решает Claude Code CLI — постоянное переключение контекста. Вместо того чтобы копировать код в чат-окно, описывать структуру проекта вручную и переносить ответы обратно в редактор, ты работаешь прямо в терминале. Claude видит файлы, запускает команды и вносит правки напрямую.

Ключевое отличие от GitHub Copilot и Cursor: Claude Code — агент, а не автокомплит. Он не дополняет строку кода — он выполняет полную цепочку действий: анализирует задачу → читает нужные файлы → вносит правки → запускает тесты → исправляет ошибки → создаёт коммит. Каждый шаг — с запросом подтверждения.

Инструмент следует Unix-философии и встраивается в пайплайны и скрипты: можно подать данные через stdin, получить структурированный вывод и использовать в CI/CD.

Ключевые возможности

• Глубокое понимание контекста — самостоятельно анализирует структуру проекта, читает файлы и понимает архитектуру приложения целиком.
• Агентское кодирование — выполняет цепочки действий для достижения цели: запуск тестов, анализ ошибок, исправление кода и повторный запуск.
• Нативная работа с Git — создаёт коммиты с осмысленными описаниями, открывает pull requests, управляет ветками.
• Автоматизация рутины — разрешает merge-конфликты, исправляет lint-ошибки, генерирует документацию и release notes.
• MCP-интеграции — через Model Context Protocol подключается к Sentry, GitHub, PostgreSQL, Figma, Slack и десяткам других сервисов.
• Plan Mode — режим только для чтения для безопасного анализа кода перед внесением изменений.
• Extended Thinking — глубокий пошаговый анализ сложных архитектурных задач.
• Анализ изображений — работа со скриншотами, диаграммами и макетами интерфейсов.
• IDE-расширения — интеграция с VS Code и JetBrains через встроенный терминал и плагины.

Перед любым действием — записью файла или выполнением shell-команды — Claude запрашивает подтверждение. Полный контроль остаётся за разработчиком.

Сценарии использования

Claude Code CLI охватывает весь цикл разработки:

• Генерация кода — создание функций, компонентов и модулей по описанию на естественном языке.
• Отладка — поиск и исправление багов с анализом стектрейсов, логов и поведения приложения.
• Рефакторинг — реструктуризация кода крупных модулей с сохранением поведения и обновлением тестов.
• Тестирование — автоматическая генерация unit- и integration-тестов по паттернам проекта.
• Онбординг — быстрое погружение в незнакомую кодовую базу: задавай вопросы о структуре и логике приложения.
• CI/CD — headless-режим (claude -p) для интеграции в пайплайны автоматической проверки и генерации кода.

Установка и системные требования

Перед установкой убедись, что система соответствует минимальным требованиям:

Операционные системы:

• macOS 10.15+
• Ubuntu 20.04+ / Debian 10+
• Windows 10+ (через WSL или Git Bash)

Обязательно:

• Node.js 18 или выше
• Минимум 4 ГБ RAM
• Стабильное интернет-соединение

Рекомендуемые терминалы: Bash, Zsh, Fish. Большинство функций лучше работают в современных терминалах с поддержкой Unicode.

Как установить Claude Code CLI — пошаговая инструкция

Нативная установка (рекомендуемый способ)

Официально рекомендуемый способ установки — через нативный инсталлятор, который не требует Node.js:

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

Этот метод автоматически устанавливает последнюю версию Claude Code в вашу систему. После установки перезапусти терминал или обнови переменные окружения:

source ~/.bashrc  # или ~/.zshrc для Zsh

Проверь установку:

claude --version

Установка через npm (альтернативный способ)

Если у тебя уже установлен Node.js 18+, можешь использовать npm:

npm install -g @anthropic-ai/claude-code

Важно: Не используй sudo npm install -g. Это может вызвать проблемы с правами доступа и безопасностью. Если возникают ошибки прав — настрой npm для работы без sudo.

Установка на Windows

Для Windows используй PowerShell:

# Стабильная версия
irm https://claude.ai/install.ps1 | iex

# Последняя версия
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

Если работаешь в WSL и получаешь ошибки — это может быть связано с определением ОС. Попробуй нативную установку через curl (см. выше) или npm с флагами:

npm config set os linux
npm install -g @anthropic-ai/claude-code --force --no-os-check

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

Убедись, что Claude Code установлен корректно:

claude --version

Для диагностики системы запусти интерактивную сессию и используй встроенные команды:

claude
# Внутри сессии:
/doctor   # Диагностика системы
/config   # Проверка настроек

Команды /doctor и /config проверят корректность установки, версии зависимостей и покажут информацию о системе. Если есть проблемы — получишь конкретные рекомендации по исправлению.

Настройка аутентификации

OAuth авторизация (Claude Pro/Max)

Если у тебя подписка Claude Pro ($20/мес) или Max ($100-200/мес):

1. Запусти claude в терминале
2. Система предложит авторизоваться через браузер
3. Подтверди доступ в открывшемся окне
4. Вернись в терминал — авторизация завершена

API ключ для разработчиков

Для работы через API:

1. Получи ключ в консоли Anthropic
2. Установи переменную окружения:

export ANTHROPIC_API_KEY=sk-ant-api03-xxxxx

Для постоянного использования добавь эту строку в ~/.bashrc или ~/.zshrc.

Безопасность: Никогда не коммить API-ключи в git. Используй .env файлы и добавляй их в .gitignore.

Запуск и режимы работы

Режимы работы

# Интерактивный режим
claude

# С предзаполненным промптом
claude "объясни что делает функция calculateTotal"

# Headless режим (для скриптов и CI/CD)
claude -p "проанализируй этот лог на ошибки" < build.log

# Продолжить последнюю сессию
claude -c

# Выбрать конкретную сессию из истории
claude --resume

Разница между -c и --resume: Флаг -c (или --continue) автоматически открывает последнюю сессию в текущей директории. Команда --resume открывает интерактивный список всех сохраненных сессий, позволяя выбрать нужную.

Headless mode (-p) — это переломный момент для автоматизации. Claude становится Unix-утилитой:

# Пайпинг данных
cat errors.json | claude -p "приоритизируй критические ошибки" --output-format json > priority.json

# В GitHub Actions
claude -p "триажируй эту issue" --allowedTools "Read,Bash(gh:*)"

Реальные кейсы headless mode:

• Субъективный линтинг — проверка опечаток, устаревших комментариев (то, что ESLint не поймёт)
• Автоматические Release Notes — cat CHANGELOG.md | claude -p "сделай markdown release notes"
• Security Triage — npm audit --json | claude -p "приоритизируй уязвимости"

Slash-команды

Внутри интерактивного режима доступны команды:

Pro tip: Используй /clear после каждой новой задачи. Длинная история съедает токены и замедляет ответы.

Горячие клавиши

Claude Code использует Escape вместо привычного Ctrl+C — это ключевое отличие от стандартных CLI-инструментов. Двойное нажатие Escape открывает историю предыдущих промптов, а Shift+Tab переключает между режимами выполнения и планирования.

Совет: режим планирования (Shift+Tab) позволяет просмотреть, какие файлы Claude собирается изменить, без реального выполнения. Используй его для сложных рефакторингов и незнакомых кодовых баз — сначала увидишь план, потом одобришь действия.

Конфигурация и настройка

Файл CLAUDE.md — память Claude

CLAUDE.md — это «конституция» твоего проекта. Claude автоматически загружает его в контекст при каждом запуске.

Иерархия файлов:

• ~/.claude/CLAUDE.md — глобальные правила для всех проектов
• ./CLAUDE.md — правила конкретного проекта
• ./subfolder/CLAUDE.md — правила для вложенной директории

Создать файл можно командой /init или вручную.

Пример эффективного CLAUDE.md:

# Project: My App

## No-Touch Zones (NEVER modify without permission)
- api/auth.ts (authentication logic)
- api/analyze.ts (core business logic)
- vercel.json (deployment config)

## Quality Gates (before ANY commit)
- npm run build — MUST succeed
- npm run test — All tests pass
- npx tsc --noEmit — Zero TypeScript errors

## Coding Standards
- Use TypeScript strict mode
- All functions need JSDoc comments
- Follow repository pattern for database access

Разработчики, которые ведут детальный CLAUDE.md (~500 строк), отмечают 90% успешных правок с первой попытки против 50% без него.

settings.json

Расположение: ~/.claude/settings.json (пользовательские) или .claude/settings.json (проектные).

Основные параметры:

• MCP-серверы
• Hooks
• Разрешения инструментов
• Тема оформления

{
  "permissions": {
    "allowedTools": [
      "mcp__filesystem__read",
      "Bash(git:*)"
    ]
  },
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

Проектный файл .claude/settings.json переопределяет глобальные настройки. Используй его для фиксации MCP-серверов и разрешений, специфичных для проекта — команда получит одинаковую конфигурацию через git.

.claudeignore

Работает как .gitignore — исключает файлы и папки из контекста Claude:

node_modules/
dist/
*.log
.env

Меньший контекст = быстрее ответы и лучше качество.

Рабочие процессы и автоматизация

Цикл работы: Explore → Plan → Code → Commit

Правильный workflow повышает качество на 30-50%:

1. Разведка: «Прочитай auth.ts, но не пиши код — только разберись»
2. План: Используй Shift+Tab для режима планирования
3. Реализация: Только после утверждения плана
4. Коммит: С осмысленным сообщением

Для сложных проектов этот цикл можно масштабировать через оркестрацию агентов — см. Claude Flow Tutorial 2026.

Extended Thinking: ключевые слова

Добавь в промпт магические слова для расширенного мышления:

• "think" — базовый бюджет
• "think hard" — больший бюджет
• "ultrathink" — максимальный бюджет (до 32K токенов на размышления)

ultrathink: спроектируй архитектуру кэширования для нашего API

Управление контекстом

• Используй /clear после каждой новой задачи
• Меньше контекста = лучше качество
• Настрой .claudeignore для исключения node_modules, логов, билдов

«Ask not what Claude can do for you, ask what context you can give to Claude»

Параллельные сессии с Git Worktrees

Вместо ожидания завершения одной задачи:

git worktree add ../project-feature-a -b feature-a
cd ../project-feature-a && claude
# В другом терминале:
cd ../project-bugfix && claude

Инженеры Anthropic используют 3-4 рабочих дерева параллельно.

CLAUDE.md как живая память

• Обновляй после найденных ошибок
• Фиксируй паттерны проекта
• Добавляй No-Touch Zones для критичного кода

Hooks — автоматизация рабочих процессов

Hooks позволяют запускать код в ключевых точках работы Claude. Настраиваются в ~/.claude/settings.json.

Типы hooks:

• PreToolUse — перед использованием инструмента
• PostToolUse — после использования инструмента
• UserPromptSubmit — перед обработкой промпта
• Stop — после завершения ответа

Пример конфигурации:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'About to run bash command'"
          }
        ]
      }
    ]
  }
}

Практический сценарий: Команды Anthropic используют hooks для автоматического анализа PR — планы Terraform подаются в Claude для сканирования безопасности, что сокращает время одобрения изменений.

Продвинутый кейс — система автоактивации Skills через hooks:

• UserPromptSubmit Hook анализирует промпт и инжектит напоминание о релевантных skills
• Stop Event Hook проверяет код после ответа Claude на ошибки

Результат: consistent patterns, self-correction, zero errors left behind.

Hooks — лишь часть возможностей автоматизации. Подробнее о расширении агента через навыки: Agent Skills от Anthropic — как научить AI-агента новым навыкам.

MCP и интеграции

Что такое MCP (Model Context Protocol)

MCP — открытый стандарт Anthropic для интеграции с внешними сервисами. Представь это как «универсальный USB-порт» для Claude: подключаешь сервер — получаешь новые возможности.

Для практического примера интеграции MCP см. руководство по Claude MCP и Playwright — пошаговая настройка E2E-тестирования через MCP.

Как добавить MCP-сервер

# Добавить сервер
claude mcp add my-filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/Documents

# Список установленных
claude mcp list

# Удалить сервер
claude mcp remove my-filesystem

Популярные MCP-серверы

Пример конфигурации в .mcp.json:

{
  "mcpServers": {
    "puppeteer": {
      "command": "node",
      "args": ["path/to/puppeteer-server.js"]
    }
  }
}

Управление разрешениями MCP (2025)

В версии 2025 года добавлена поддержка масок для разрешений серверов MCP, что упрощает настройку прав доступа:

{
  "permissions": {
    "allowedTools": [
      "mcp__server__*",  // Разрешить все инструменты всех MCP-серверов
      "mcp__filesystem__read",  // Конкретный инструмент
      "Bash(git:*)"  // Bash с git-командами
    ]
  }
}

Это позволяет гибко контролировать, какие MCP-серверы и инструменты могут использоваться в проекте.

Интеграция с IDE

Хотя Claude Code — терминальный инструмент, он глубоко интегрируется в современные редакторы кода:

• VS Code — официальное расширение Claude Code for VS Code добавляет панель Claude в боковую панель редактора. Можно запускать Claude прямо из встроенного терминала, а расширение автоматически подхватывает контекст открытых файлов.
• JetBrains — плагины для IntelliJ IDEA, WebStorm, PyCharm. Claude Code запускается в Terminal-вкладке IDE и взаимодействует с проектом через файловую систему, не требуя специальной настройки.
• Cursor и Windsurf — Claude Code работает в встроенном терминале этих редакторов. Можно комбинировать агентский режим Claude Code с нативными AI-функциями редактора.

Для любого терминала с поддержкой Vim-keybindings доступен встроенный режим Vim — управление с клавиатуры без мыши.

Стоимость и тарифы

Цены актуальны на декабрь 2025

Подписки для пользователей

API тарификация (за миллион токенов)

Способы экономии:

• Batch API — скидка 50% для несрочных задач
• Кэширование промптов — экономия до 90% на повторяющемся контенте

Бесплатный старт

Новые пользователи API получают $5 бесплатных кредитов без привязки карты.

ROI из практики: Разработчики отмечают, что задачи на 1-2 недели фрилансера решаются за 2 часа итераций с Claude Code. Без Claude: 4-6 часов на фичу. С Claude Code + правильные workflows: 45-90 минут.

Сравнение с конкурентами

Таблица сравнения

Claude Code vs Cursor AI

Cursor — форк VS Code со встроенным AI. Главное отличие от Claude Code: Cursor работает внутри редактора, а Claude Code — рядом с ним в терминале.

Cursor выигрывает в inline-редактировании: подсветка diff прямо в коде, Tab-автокомплит, мультифайловое редактирование в IDE-интерфейсе. Для визуальных задач (вёрстка, CSS) Cursor удобнее.

Claude Code выигрывает в автономности: цепочки действий (тесты → правка → коммит), headless-режим для CI/CD, 200K контекст против гибридной архитектуры Cursor. Для сложных рефакторингов и автоматизации Claude Code эффективнее.

Оптимальная стратегия — использовать оба инструмента: Cursor для повседневного кодинга в IDE, Claude Code для агентских задач и автоматизации.

Когда выбрать Claude Code

• Предпочитаешь работу в терминале
• Нужна автономность — агент, который сам найдёт файлы, запустит тесты, создаст PR
• Работаешь с большими кодовыми базами (200K токенов контекста)
• Хочешь единую модель для всего — код, документация, рефакторинг

Когда НЕ выбирать Claude Code

• Нужна глубокая IDE-интеграция с подсветкой и автокомплитом в реальном времени
• Бюджет ограничен ($10 у Copilot vs $20 у Claude)
• Команда привыкла к Copilot/Cursor и не готова менять workflow

Claude Code — это не «GitHub Copilot в терминале». Это полноценный разработчик-помощник, если даёшь ему правильный контекст.

Решение проблем

Обновление Claude Code

Для обновления до последней версии используй встроенную команду:

claude update

Эта команда автоматически загрузит и установит последнюю версию Claude Code. После обновления рекомендуется перезапустить терминал.

Альтернативный способ (через npm):

npm update -g @anthropic-ai/claude-code

Проблемы установки

PATH не настроен:

# Добавь в ~/.bashrc или ~/.zshrc
export PATH="$HOME/.npm-global/bin:$PATH"

Ошибки прав доступа:
Не используй sudo. Настрой npm для работы без root-прав.

WSL проблемы:

npm config set os linux
npm install -g @anthropic-ai/claude-code --force --no-os-check

Проблемы аутентификации

Если авторизация сломалась:

# Полный выход
/logout

# Перезапуск с новой авторизацией
claude

Если проблема сохраняется, проверь сетевое подключение — Claude Code требует стабильный доступ к API Anthropic. Корпоративные VPN и прокси могут блокировать запросы. В таком случае настрой переменную HTTPS_PROXY или обратись к администратору сети.

Медленная работа

• Используй /compact для сжатия контекста
• Ограничь контекст через .claudeignore
• При длинных сессиях модель может «затухать» — делай /clear каждые 5-10 минут
• Восстановление сессии: claude -c

Типичные ошибки новичков

1. Забыли про CLAUDE.md — Claude работает вслепую
2. Надолго держать контекст — используй /clear часто
3. Не использовать Plan Mode — теряешь 20-30% качества
4. Не прерывать Claude сразу — жми Escape при неправильном направлении
5. Запускать на полных правах — ограничивай через --allowedTools

Часто задаваемые вопросы

Что такое Claude Code и чем он отличается от обычного Claude?

Claude Code — терминальный агент от Anthropic. В отличие от веб-версии, он имеет доступ к файловой системе, может выполнять команды и понимает контекст всего проекта. Работает автономно, как junior-разработчик с идеальной памятью.

Можно ли использовать Claude Code бесплатно?

Для API новые пользователи получают $5 кредитов без привязки карты. Для полноценной работы рекомендуется подписка Pro за $20/мес.

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

Через PowerShell: irm https://claude.ai/install.ps1 | iex. Также работает через WSL с npm-установкой. При проблемах используй npm config set os linux.

Какие модели использует Claude Code?

По умолчанию Sonnet 4.5. Подписчики Max имеют доступ к Opus 4.5 для сложных задач.

Как настроить CLAUDE.md для своего проекта?

Запусти /init в терминале или создай файл вручную в корне проекта. Опиши архитектуру, правила кодирования, No-Touch Zones и Quality Gates.

Чем Claude Code лучше GitHub Copilot?

Автономность: Claude Code — агент, который сам находит файлы, запускает тесты, создаёт PR. Copilot — автокомплит в IDE. Контекстное окно: 200K токенов у Claude против ~8K у Copilot.

Как подключить MCP-серверы?

Командой claude mcp add <name> <command>. Например: claude mcp add github -- npx -y @modelcontextprotocol/server-github.

Сколько стоит Claude Code для команды?

Plan Team: $25-30/месяц за пользователя, минимум 5 человек. Включает централизованное управление и выставление счетов.

Заключение

Claude Code CLI — мощный терминальный AI-агент, который радикально меняет подход к разработке. Это не замена IDE, а новый инструмент в арсенале: автоматизация рутины, глубокий анализ кода, автономное выполнение задач.

Рекомендация: Начни с подписки Claude Pro за $20/мес — этого достаточно для большинства задач. Или попробуй бесплатно с $5 кредитами API.

Установка занимает 2 минуты:

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

Статья актуальна на декабрь 2025. При выходе новых версий материал будет обновлён.

Полезные ссылки:

• Официальная документация Claude Code
• Anthropic Engineering: Best Practices
• GitHub Claude Code

История правок

2025-12-23: Исправлено по замечаниям фактчекера

Критичные исправления:

• Раздел «Проверка установки»: Исправлена информация о команде claude doctor — это внутренняя команда /doctor, а не внешняя CLI-команда. Добавлена информация о /config

Дополнительные улучшения (актуализация 2025):

• Добавлена информация о команде claude --resume и её отличии от --continue
• Добавлен раздел «Обновление Claude Code» с командой claude update
• Добавлен подраздел «Управление разрешениями MCP (2025)» с информацией о масках разрешений (mcp__server__*)

2025-12-23: Добавлена информация о бенчмарках

Улучшения:

• Добавлен подраздел «Производительность моделей в бенчмарках» в раздел «Что такое Claude Code и зачем он нужен»
• Включена информация о SWE-bench Verified (80.9% для Claude Opus 4.5 — рекорд индустрии)
• Добавлены данные о Terminal-Bench (59.3%) с объяснением важности для CLI
• Добавлена ссылка на исследование Hugging Face