Установка Claude Code и выбор рабочего интерфейса

Перед началом работы важно выбрать официальный способ установки Claude Code, войти в учётную запись и запускать агент из правильной директории проекта.

Краткий ответ

Перед началом работы важно выбрать официальный способ установки Claude Code, войти в учётную запись и запускать агент из правильной директории проекта. От директории зависят доступные файлы, Git-состояние и найденные проектные инструкции.

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

Для macOS, Linux и WSL документация рекомендует нативный установщик:

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

На macOS доступен Homebrew:

brew install --cask claude-code

На Windows доступен WinGet:

winget install Anthropic.ClaudeCode

Нативная установка обновляется в фоне. Homebrew и WinGet требуют периодического обновления соответствующим пакетным менеджером.

Первый вход и запуск

Перейдите в корень репозитория и выполните:

cd /path/to/project
claude

При первом запуске откроется сценарий авторизации. В работающем сеансе команда /login позволяет войти заново или сменить учётную запись, а /doctor помогает диагностировать проблемы установки и конфигурации.

Как выбрать интерфейс

CLI подходит, когда важны команды, логи и полный рабочий цикл в терминале. IDE удобна для одновременного просмотра файлов и diff. Desktop поддерживает несколько изолированных сеансов и визуальный обзор. Web полезен для делегирования работы в облачной среде, а Remote Control — для удалённого управления локальным исполнением.

Выбирайте не «самый мощный» интерфейс, а тот, где видны последствия действий и удобно принимать изменения.

Сеанс и рабочая директория

Сеанс связан с директорией. claude --continue продолжает последний сеанс текущего проекта, а claude --resume открывает выбор сохранённых сеансов. Новый сеанс получает свежий контекст, поэтому постоянные правила следует хранить в CLAUDE.md, а не надеяться на старый диалог.

Чек-лист первого запуска

Команда claude --version выводит версию.
Агент запущен из корня нужного репозитория.
git status не показывает неожиданных изменений.
Вы понимаете, локально или в облаке выполняется код.
В проекте нет открытых секретов, которые агенту не нужны.
Первый запрос не затрагивает production и внешние данные.

Частые вопросы

Нужно ли устанавливать Node.js для нативной версии?

Официальный quickstart рекомендует нативный установщик и не требует npm-команды для этого способа. Следуйте системным требованиям выбранного варианта установки.

Почему Claude Code не видит мой файл?

Сначала проверьте текущую директорию и права доступа. Файл может находиться вне рабочей директории либо исключаться настройками разрешений.

Когда использовать web вместо локального CLI?

Web подходит для работы с подключённым репозиторием в облачной среде. Локальный CLI предпочтительнее, когда нужны локальные сервисы, незакоммиченные файлы или инструменты, установленные только на вашей машине.

Что важно запомнить

Устанавливайте Claude Code официальным способом и проверяйте версию.
Запускайте сеанс из осознанно выбранной директории.
CLI, IDE, Desktop и web решают разные задачи поверх одного агентного цикла.
Постоянные знания проекта не следует хранить только в истории чата.

https://yadro-code.ru/lessons/without-university/claude-code-workflows/claude-code-02