Claude Code — Частые вопросы по установке и настройке

Ответы на самые частые вопросы: чем Claude Code отличается от Claude Desktop, как установить, настроить, подключить к VS Code и не переплатить за токены.

Dmitrij Tamarov Dmitrij Tamarov 28 марта 2026 г. · 6 мин
Claude Code установка настройка терминал FAQ

Claude Desktop и Claude Code — разные продукты

Claude Desktop:

  • Чат в отдельном графическом окне (claude.ai). Управление мышкой и клавиатурой. Доступен бесплатно и по подписке Pro.

Claude Code:

  • Терминальный агент для работы с кодом. Управление текстовыми командами. Доступен только по подписке Pro/Max или через API.
Важно: Десктопное приложение Claude и Claude Code — это разные вещи. Приложение — это чат-интерфейс. Claude Code — инструмент для работы с кодом в терминале. Ниже речь идёт именно о Claude Code.

Как установить Claude (десктопное приложение)?

Claude доступен как обычное приложение для компьютера — без терминала и кода.

Windows

  1. Зайдите на claude.com/download
  2. Скачайте установщик — файл формата .msix
  3. Запустите файл и следуйте шагам установщика
  4. После установки Claude появится в меню «Пуск»

macOS

  1. Зайдите на claude.com/download
  2. Скачайте файл .dmg
  3. Откройте его и перетащите Claude в папку «Программы» (Applications)
  4. Запустите Claude из Launchpad или Spotlight

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

  • Войдите в аккаунт claude.ai (нужна подписка Pro/Max или бесплатный аккаунт для базового использования)
  • Десктопное приложение — это тот же чат claude.ai, только в отдельном окне

Как начать пользоваться Claude Code?

Перед началом

Убедитесь, что у вас есть:

  • Компьютер с macOS, Windows или Linux
  • Терминал (Terminal на Mac, PowerShell на Windows)
  • Активная подписка Claude Pro/Max или API-ключ Anthropic

Шаг 1: Установите Claude Code

Terminal — zsh
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

# Проверка
claude --version

Шаг 2: Войдите в свою учётную запись

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

Terminal — zsh
cd ~/my-project
claude

При первом запуске откроется браузер для входа через claude.ai. Войдите в свой аккаунт и вернитесь в терминал.

Если используете API-ключ вместо подписки:

Terminal — zsh
export ANTHROPIC_API_KEY=sk-ant-...
claude

Шаг 3: Задайте свой первый вопрос

Просто напишите вопрос на русском или английском:

text
> Объясни структуру этого проекта
> Что делает функция main в файле app.py?
> Какие зависимости используются?

Claude прочитает нужные файлы и даст ответ с учётом контекста проекта.

Шаг 4: Сделайте своё первое изменение кода

Попросите Claude Code внести изменения:

text
> Добавь валидацию email в форму регистрации
> Переименуй переменную data в userData во всех файлах
> Исправь отступы в файле config.yaml

Claude покажет предлагаемые изменения и попросит подтверждения перед записью в файл.

Шаг 5: Используйте Git с Claude Code

Claude Code умеет работать с Git напрямую и может автоматически создавать коммиты:

text
> Покажи, что изменилось с последнего коммита
> Сделай коммит с описанием "Добавлена валидация email"
> Создай новую ветку для фичи авторизации

Шаг 6: Исправьте ошибку или добавьте функцию

Опишите проблему или желаемый результат:

text
> При нажатии кнопки "Отправить" ничего не происходит — найди и исправь баг
> Добавь тёмную тему в приложение
> Напиши тесты для модуля оплаты

Claude Code сам найдёт нужные файлы, предложит решение и внесёт изменения.

Полезные команды

  • /help — показать справку
  • /status — проверить статус авторизации
  • /model — переключить модель (Opus, Sonnet, Haiku)
  • /cost — посмотреть расход токенов за сессию
  • /compact — сжать контекст для экономии токенов
  • /clear — очистить историю диалога
  • Ctrl+C — прервать текущую операцию
  • Ctrl+D — выйти из Claude Code

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

Можно работать двумя способами:

Способ 1: Расширение из маркетплейса

  1. Откройте VS Code → Extensions (Ctrl+Shift+X / Cmd+Shift+X)
  2. Введите в поиск «Claude Code»
  3. Найдите расширение от издателя Anthropic (убедитесь, что это официальное)
  4. Нажмите «Установить» (Install)
  5. В боковой панели появится иконка Claude Code
  6. При первом запуске пройдите аутентификацию через браузер

Способ 2: Через встроенный терминал

Если вы уже установили Claude Code через терминал, просто:

  1. Откройте терминал в VS Code: ` Ctrl+ ` (Windows/Linux) или Cmd+ `` (Mac)
  2. Введите claude

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

«command not found: claude» после установки

Проблема: Исполняемый файл не добавлен в переменную окружения PATH.

Решение: Добавьте путь ~/.local/bin в настройки вашей оболочки:

Terminal — zsh
# Для zsh (~/.zshrc)
export PATH="$HOME/.local/bin:$PATH"

# Для bash (~/.bashrc)
export PATH="$HOME/.local/bin:$PATH"

После этого перезапустите терминал или выполните source ~/.zshrc.

Установка через npm больше не рекомендуется

Проблема: Старый метод установки через npm install -g @anthropic-ai/claude-code может приводить к конфликтам версий Node.js и проблемам с правами доступа.

Решение: Используйте нативный бинарный установщик — он работает быстрее и не требует Node.js:

Terminal — zsh
curl -fsSL https://claude.ai/install.sh | sh

Доступ и авторизация

Бесплатный аккаунт Claude.ai не работает

Claude Code не поддерживает бесплатные аккаунты. Необходима одна из подписок:

  • Pro или Max на claude.ai
  • Teams или Enterprise
  • Аккаунт в Anthropic Console с API-ключом

Безопасность: запрет опасных команд

Claude Code может попытаться выполнить деструктивные команды. Запретите их в settings.json:

data.json
{
  "permissions": {
    "deny": [
      "Bash(rm *)",
      "Bash(git push --force *)",
      "Bash(git push -f *)",
      "Bash(git reset --hard *)"
    ]
  }
}

Как не слить деньги: API vs подписка

Начинающие пользователи подключают Claude Code через API-ключ (Anthropic Console), не понимая, что каждое сообщение тратит реальные деньги. Одна сессия с большим проектом может стоить $5–50, а за день активной работы легко уйти $100+. При этом нет встроенных лимитов — баланс просто тает.

Используйте подписку, а не API

API-ключ:

  • Оплата за каждое сообщение. Стоимость $5–50 за сессию, $100+ в день. Лимитов нет — баланс просто тает. Подходит для автоматизации.

Подписка:

  • Фиксированная цена: Pro $20/мес, Max $100–200/мес. При достижении лимита — замедление, а не списание. Подходит для ежедневной работы.

Почему подписка лучше для новичка:

  • Фиксированная стоимость — вы заранее знаете, сколько заплатите
  • Невозможно случайно потратить сотни долларов
  • При достижении лимита Claude Code просто замедлится, а не продолжит списывать деньги
  • Не нужно разбираться с API-ключами и переменными окружения

Если уже используете API — защитите себя:

  • Установите лимит расходов в Anthropic Console → Settings → Limits
  • Следите за расходами командой /cost в Claude Code

Рекомендация: Если вы не разработчик и не строите автоматизацию — всегда выбирайте подписку Pro или Max. API нужен только для программной интеграции.

Экономия токенов

CLAUDE.md раздувает контекст

Файл CLAUDE.md перечитывается при каждом сообщении. Большой CLAUDE.md съедает до 90% квоты.

  • Держите CLAUDE.md до 500 строк
  • Выносите подробности во внешние файлы
  • Используйте /compact для сжатия контекста

Медленный поиск по проекту

Папки node_modules и build тормозят индексацию.

  • Эти папки должны быть в .gitignore
  • Установите ripgrep для ускорения
  • /clear очищает контекст

«Rate limit exceeded»

  • /model haiku — для простых задач
  • /compact — уменьшить контекст
  • Подождите 1–5 минут

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

Настройте автоформатирование через хук:

data.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "prettier --write $CLAUDE_FILE_PATH"
      }
    ]
  }
}
Dmitrij Tamarov
Dmitrij Tamarov

AI architect