Skip to main content
Дмитрий Тамаров
Дмитрий Тамаров
Ai-инженер, разработчик
23 декабря, 2025

Claude Code CLI: Полный обзор, установка и примеры использования в 2025 году

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

Что такое Claude Code и зачем он нужен

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

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

  • Читает и редактирует файлы напрямую
  • Запускает тесты и билды
  • Управляет git-процессами
  • Понимает кодовую базу целиком (контекстное окно до 200K токенов)

Запущен в феврале 2025 года, работает на моделях Claude Sonnet 4.5 и Opus 4.5. Позиционируется для разработчиков, которые предпочитают терминал IDE.

Разработчики отмечают, что Claude Code «дожимает» проблему, прогоняя тесты до победного конца — в отличие от обычных чат-ботов, которые часто предлагают обходные пути.

Реальный кейс: команды используют Claude Code для переписывания крупных модулей — например, 146 TypeScript-файлов с автоматической генерацией 23 миграций базы данных.

Производительность моделей в бенчмарках

Claude 4.5 демонстрирует лидирующие результаты в индустриальных бенчмарках по программированию. Согласно анализу данных Hugging Face:

SWE-bench Verified — золотой стандарт оценки способности AI решать реальные задачи программирования (500 реальных GitHub issues из популярных open-source проектов). Claude Opus 4.5 установил новый рекорд с результатом 80.9%, став первой моделью, превысившей порог 80%. Это на 65% выше по сравнению с Claude 3.5 Sonnet (49%) и превосходит все конкурирующие модели, включая GPT-5.1 (76.3%) и Gemini 3 Pro (76.2%).

Особенно показательно, что Claude Opus 4.5 превзошел всех кандидатов-инженеров на внутренних тестах Anthropic, завершив двухчасовой тест с более высокими баллами, чем когда-либо достигал человек.

Terminal-Bench — бенчмарк для работы в командной строке. Claude Opus 4.5 достигает 59.3%, превосходя Gemini 3 Pro (54.2%) и GPT-5.1 (47.6%). Это особенно важно для Claude Code CLI, так как демонстрирует превосходство модели в командной строке и сценариях автоматизации.

Эти результаты объясняют, почему Claude Code CLI эффективен для сложных инженерных задач прямо из терминала.

Системные требования для Claude Code

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

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

  • 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 Code

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

# Интерактивный режим
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-команды

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

КомандаОписание
/clearОчистить контекст (используй часто!)
/compactСжать контекст без потери смысла
/initСоздать CLAUDE.md для проекта
/configОткрыть настройки
/helpСправка по командам

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

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

КлавишаДействие
EscapeОстановить Claude (не Ctrl+C!)
Escape дваждыИстория предыдущих сообщений
Ctrl+VВставить изображение из буфера
Shift+TabПереключить в режим планирования

Конфигурация проекта: CLAUDE.md и settings.json

Файл 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
  • Разрешения инструментов
  • Тема оформления

.claudeignore

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

node_modules/
dist/
*.log
.env

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

MCP-серверы — расширение возможностей Claude Code

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

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

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

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

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

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

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

СерверНазначение
filesystemБезопасные файловые операции
gitРабота с репозиторием, быстрые rollback’и
githubПрямое чтение issues, PR, комментариев
sequential-thinkingПошаговый анализ сложных рефакторингов
playwrightE2E тестирование и браузерная автоматизация
puppeteerСкриншоты и взаимодействие с браузером

Пример конфигурации в .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-серверы и инструменты могут использоваться в проекте.

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.

Стоимость Claude Code — подписки и API

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

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

ПланЦенаОсобенности
Pro$20/месРекомендуется для старта. Достаточно для большинства задач
Max$100-200/месВысокие лимиты, доступ к Opus для сложных задач
Team$25-30/мес за пользователяЦентрализованное управление, минимум 5 пользователей

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

МодельВходВыход
Haiku 4.5$1$5
Sonnet 4/4.5$3$15
Opus 4.5$5$25

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

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

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

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

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

Claude Code vs GitHub Copilot vs Cursor — сравнение

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

КритерийClaude CodeGitHub CopilotCursor
ИнтерфейсТерминалIDE-плагиныФорк VS Code
Контекстное окно200K токенов~8K токеновГибридная архитектура
Ценаот $20/месот $10/месот $20/мес
АвтономностьВысокая (агент)Низкая (автокомплит)Средняя
Работа с кодовой базойПонимает весь проектФокус на текущем файлеХорошая индексация

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

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

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

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

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

Best practices — как использовать Claude Code эффективно

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

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

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

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 для критичного кода

Устранение неполадок (Troubleshooting)

Обновление 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

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

  • Используй /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. При выходе новых версий материал будет обновлён.

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

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

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

Статьи по теме:

# Теги
Claude AI
Claude Code
CLI