​
Системные требования

  • Операционные системы: macOS 10.15+, Ubuntu 20.04+/Debian 10+, или Windows через WSL
  • Аппаратное обеспечение: минимум 4ГБ ОЗУ
  • Программное обеспечение:
    • Node.js 18+
    • git 2.23+ (опционально)
    • GitHub или GitLab CLI для рабочих процессов PR (опционально)
  • Сеть: Требуется подключение к интернету для аутентификации и обработки ИИ
  • Местоположение: Доступно только в поддерживаемых странах

​
Установка и аутентификация

1

Установите Claude Code

Install NodeJS 18+, then run:

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

Do NOT use sudo npm install -g as this can lead to permission issues and security risks. If you encounter permission errors, see configure Claude Code for recommended solutions.

2

Перейдите к вашему проекту

cd your-project-directory
3

Запустите Claude Code

claude
4

Завершите аутентификацию

Claude Code предлагает несколько вариантов аутентификации:

  1. Anthropic Console: Опция по умолчанию. Подключитесь через Anthropic Console и завершите процесс OAuth. Требует активного биллинга на console.anthropic.com.
  2. Claude App (с планом Pro или Max): Подпишитесь на план Pro или Max Claude для единой подписки, которая включает как Claude Code, так и веб-интерфейс. Получите больше ценности по той же цене, управляя своим аккаунтом в одном месте. Войдите в систему с вашим аккаунтом Claude.ai. Во время запуска выберите опцию, которая соответствует вашему типу подписки.
  3. Корпоративные платформы: Настройте Claude Code для использования Amazon Bedrock или Google Vertex AI для корпоративных развертываний с вашей существующей облачной инфраструктурой.

​
Инициализируйте ваш проект

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

1

Запустите Claude Code

claude
2

Выполните простую команду

> summarize this project
3

Сгенерируйте руководство проекта CLAUDE.md

/init
4

Зафиксируйте сгенерированный файл CLAUDE.md

Попросите Claude зафиксировать сгенерированный файл CLAUDE.md в вашем репозитории.

​
Устранение неполадок

​
Устранение неполадок установки WSL

В настоящее время Claude Code не работает напрямую в Windows и вместо этого требует WSL.

Вы можете столкнуться со следующими проблемами в WSL:

Проблемы обнаружения ОС/платформы: Если вы получаете ошибку во время установки, WSL может использовать Windows npm. Попробуйте:

  • Выполните npm config set os linux перед установкой
  • Установите с помощью npm install -g @anthropic-ai/claude-code --force --no-os-check (НЕ используйте sudo)

Ошибки “Node не найден”: Если вы видите exec: node: not found при запуске claude, ваша среда WSL может использовать установку Node.js для Windows. Вы можете подтвердить это с помощью which npm и which node, которые должны указывать на пути Linux, начинающиеся с /usr/, а не с /mnt/c/. Чтобы исправить это, попробуйте установить Node через менеджер пакетов вашего дистрибутива Linux или через nvm.

​
Оптимизируйте настройку вашего терминала

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

Поддерживаемые оболочки:

  • Bash
  • Zsh
  • Fish

​
Темы и внешний вид

Claude не может контролировать тему вашего терминала. Это обрабатывается вашим приложением терминала. Вы можете сопоставить тему Claude Code с вашим терминалом во время настройки или в любое время через команду /config

​
Переносы строк

У вас есть несколько вариантов для ввода переносов строк в Claude Code:

  • Быстрый экранирующий символ: Введите \ и затем Enter для создания новой строки
  • Сочетание клавиш: Нажмите Option+Enter (Meta+Enter) с правильной конфигурацией

Чтобы настроить Option+Enter в вашем терминале:

Для Mac Terminal.app:

  1. Откройте Настройки → Профили → Клавиатура
  2. Отметьте “Использовать Option как Meta Key”

Для iTerm2 и терминала VSCode:

  1. Откройте Настройки → Профили → Клавиши
  2. В разделе Общие установите клавишу Left/Right Option на “Esc+”

Совет для пользователей iTerm2 и VSCode: Выполните /terminal-setup в Claude Code для автоматической настройки Shift+Enter как более интуитивной альтернативы.

​
Настройка уведомлений

Никогда не пропускайте момент, когда Claude завершает задачу, с правильной конфигурацией уведомлений:

​
Уведомления звонка терминала

Включите звуковые оповещения при завершении задач:

claude config set --global preferredNotifChannel terminal_bell

Для пользователей macOS: Не забудьте включить разрешения уведомлений в Системные настройки → Уведомления → [Ваше приложение терминала].

​
Системные уведомления iTerm 2

Для оповещений iTerm 2 при завершении задач:

  1. Откройте Настройки iTerm 2
  2. Перейдите к Профили → Терминал
  3. Включите “Silence bell” и Фильтр оповещений → “Send escape sequence-generated alerts”
  4. Установите предпочитаемую задержку уведомлений

Обратите внимание, что эти уведомления специфичны для iTerm 2 и недоступны в стандартном терминале macOS.

​
Обработка больших входных данных

При работе с обширным кодом или длинными инструкциями:

  • Избегайте прямой вставки: Claude Code может испытывать трудности с очень длинным вставленным содержимым
  • Используйте файловые рабочие процессы: Запишите содержимое в файл и попросите Claude прочитать его
  • Учитывайте ограничения VS Code: Терминал VS Code особенно склонен к обрезанию длинных вставок

​
Режим Vim

Claude Code поддерживает подмножество привязок клавиш Vim, которые можно включить с помощью /vim или настроить через /config.

Поддерживаемое подмножество включает:

  • Переключение режимов: Esc (в NORMAL), i/I, a/A, o/O (в INSERT)
  • Навигация: h/j/k/l, w/e/b, 0/$/^, gg/G
  • Редактирование: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (повтор)