> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Руководство по терминалу для новых пользователей

> Пошаговое руководство по установке Claude Code для пользователей терминала, впервые использующих его, на macOS и Windows.

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

* [macOS и Linux](#macos-and-linux)
* [Windows](#windows)

<Note>
  Не хотите использовать терминал? Приложение Claude Code для рабочего стола позволяет полностью пропустить терминал. Загрузите его для [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) или [Linux](https://claude.com/download?utm_source=claude_code\&utm_medium=docs), затем см. [Быстрый старт для рабочего стола](/ru/desktop-quickstart), чтобы начать работу.
</Note>

<h2 id="macos-and-linux">
  macOS и Linux
</h2>

Выполните эти шаги для установки и запуска Claude Code из терминала macOS или Linux. Claude Code требует macOS 13.0 или более поздней версии. См. [системные требования](/ru/setup#system-requirements) для поддерживаемых дистрибутивов Linux.

<Steps>
  <Step title="Откройте терминал">
    **macOS**: Нажмите `Cmd + Space`, чтобы открыть Spotlight Search, введите `Terminal` и нажмите `Enter`.

    **Linux**: Откройте приложение терминала. На большинстве дистрибутивов нажмите `Ctrl + Alt + T` или найдите "Terminal" в меню приложений.

    Появится окно с мигающим курсором. Это ваш терминал, где вы вводите команды.
  </Step>

  <Step title="Установите Claude Code">
    Скопируйте эту строку, вставьте её в терминал (`Cmd + V` на macOS, `Ctrl + Shift + V` на Linux) и нажмите `Enter`:

    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    ```

    Это загружает и запускает установщик Claude Code с claude.ai. Вы увидите прокручивающийся текст во время работы. Когда это будет сделано, вы увидите "Claude Code successfully installed!" Если вместо этого вы видите ошибку, проверьте [раздел устранения неполадок](#macos-and-linux-troubleshooting) ниже.
  </Step>

  <Step title="Запустите Claude Code">
    Введите `claude` и нажмите `Enter`:

    ```bash theme={null}
    claude
    ```

    Вам будет предложено [войти](/ru/authentication) с помощью вашей учетной записи Claude. Следуйте инструкциям на экране. Откроется окно браузера для входа.
  </Step>

  <Step title="Начните использовать Claude Code">
    После входа вы можете начать задавать Claude вопросы о вашем коде или чем-либо еще. Claude Code работает полностью в текстовом режиме. Вы вводите сообщения и нажимаете `Enter` для их отправки. Несколько важных моментов:

    * Вы не можете нажимать на элементы в терминале. Используйте клавиши со стрелками для навигации.
    * Нажмите `Esc`, чтобы прервать Claude, если он работает.
    * Введите `exit` или нажмите `Ctrl + D`, чтобы выйти из Claude Code.
    * Введите `/help`, чтобы увидеть доступные команды.
  </Step>
</Steps>

***

<h2 id="windows">
  Windows
</h2>

Выполните эти шаги для дополнительной установки Git для Windows, настройки PowerShell и запуска Claude Code на Windows. Claude Code требует Windows 10 версии 1809 или более поздней. См. [системные требования](/ru/setup#system-requirements) для полной информации.

<Steps>
  <Step title="Установите Git для Windows (опционально)">
    Git для Windows предоставляет Git Bash, который включает инструмент Bash. Без него Claude Code использует PowerShell вместо этого. Вам не нужно самостоятельно изучать Git.

    Если у вас его еще нет:

    1. Перейдите на [git-scm.com/downloads/win](https://git-scm.com/downloads/win) и загрузите установщик
    2. Запустите установщик. Нажимайте Next на каждом экране, чтобы принять значения по умолчанию. Установщик имеет много экранов, но вам не нужно ничего менять.
    3. Если он попросит вас выбрать редактор, оставьте значение по умолчанию и нажмите Next.
    4. Когда вы увидите "Adjusting your PATH environment", оставьте рекомендуемый вариант выбранным.

    <Note>
      Уже есть Git? Вы можете пропустить этот шаг. Если вы не уверены, установите его в любом случае. Переустановка не вызовет проблем.
    </Note>
  </Step>

  <Step title="Откройте PowerShell">
    PowerShell — это встроенный терминал Windows для ввода команд. Он предустановлен на каждом компьютере Windows.

    Нажмите `Win + X` и выберите **Windows PowerShell** (или **Terminal**) из меню. Появится окно с мигающим курсором. Здесь вы будете вводить команды.

    <Note>
      Windows имеет две программы командной строки: PowerShell и CMD. Они выглядят похоже, но используют разные команды. Убедитесь, что вы находитесь в PowerShell для следующего шага.

      Как определить, в каком из них вы находитесь:

      * **PowerShell**: показывает `PS C:\Users\YourName>` в начале каждой строки
      * **CMD**: показывает `C:\Users\YourName>` без `PS`
    </Note>
  </Step>

  <Step title="Установите Claude Code">
    Скопируйте эту строку, вставьте её в PowerShell с помощью `Ctrl + V` или щелкните правой кнопкой мыши и нажмите `Enter`:

    ```powershell theme={null}
    irm https://claude.ai/install.ps1 | iex
    ```

    Это загружает и запускает установщик Claude Code. `irm` загружает файл, а `iex` его запускает. Вы увидите прокручивающийся текст во время работы. Когда это будет сделано, вы увидите "Claude Code successfully installed!" Если вместо этого вы видите ошибку, проверьте [раздел устранения неполадок](#windows-troubleshooting) ниже.

    <Note>
      Если вы находитесь в CMD вместо PowerShell, используйте эту команду:

      ```batch theme={null}
      curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
      ```
    </Note>
  </Step>

  <Step title="Запустите Claude Code">
    Запустите `claude`. Если PowerShell говорит `'claude' is not recognized`, то каталог установки еще не находится в вашем PATH. Следуйте исправлению ['claude is not recognized'](#windows-troubleshooting) ниже, затем откройте новое окно PowerShell и попробуйте снова.

    ```powershell theme={null}
    claude
    ```

    Вам будет предложено [войти](/ru/authentication) с помощью вашей учетной записи Claude. Следуйте инструкциям на экране. Откроется окно браузера для входа.
  </Step>

  <Step title="Начните использовать Claude Code">
    После входа вы можете начать задавать Claude вопросы о вашем коде или чем-либо еще. Claude Code работает полностью в текстовом режиме. Вы вводите сообщения и нажимаете `Enter` для их отправки. Несколько важных моментов:

    * Вы не можете нажимать на элементы в терминале. Используйте клавиши со стрелками для навигации.
    * Нажмите `Esc`, чтобы прервать Claude, если он работает.
    * Введите `exit` или нажмите `Ctrl + D`, чтобы выйти из Claude Code.
    * Введите `/help`, чтобы увидеть доступные команды.
  </Step>
</Steps>

***

<h2 id="what’s-next">
  Что дальше?
</h2>

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

<h3 id="build-something">
  Создайте что-нибудь
</h3>

Claude может создавать проекты из описания:

```text theme={null}
make me a simple webpage that says hello world
```

Claude создает файлы для вас. Дважды щелкните файл HTML, чтобы открыть его в браузере.

<h3 id="work-with-files-on-your-computer">
  Работайте с файлами на вашем компьютере
</h3>

Claude может читать и организовывать файлы, которые у вас уже есть:

```text theme={null}
look at the screenshots on my Desktop and rename them based on what's in each image
```

<h3 id="ask-questions">
  Задавайте вопросы
</h3>

Claude может объяснять вещи, помогать вам учиться или планировать проект:

```text theme={null}
I want to build a personal budget tracker. What would I need?
```

Если у вас еще нет проекта, это нормально. Claude может помочь вам начать новый.

<h3 id="other-ways-to-use-claude-code">
  Другие способы использования Claude Code
</h3>

Вам не обязательно использовать терминал. Claude Code также доступен в:

* [VS Code](/ru/vs-code) и [JetBrains IDEs](/ru/jetbrains) как расширения редактора
* [Приложение для рабочего стола](/ru/desktop-quickstart), без необходимости использования терминала
* [Веб](/ru/claude-code-on-the-web) на claude.ai/code для удаленных сеансов
* [GitHub Actions](/ru/github-actions) и [GitLab CI/CD](/ru/gitlab-ci-cd) для автоматизации

<h3 id="learn-more">
  Узнайте больше
</h3>

* [Быстрый старт](/ru/quickstart): пошаговое руководство по вашему первому проекту с Claude Code
* [Как работает Claude Code](/ru/how-claude-code-works): поймите, как Claude читает ваши файлы, запускает команды и вносит изменения
* [Лучшие практики](/ru/best-practices): получайте лучшие результаты с эффективным запросом и настройкой проекта
* [Общие рабочие процессы](/ru/common-workflows): пошаговые руководства по отладке, тестированию, рефакторингу и многому другому
* [Конфигурация терминала](/ru/terminal-config): настройте ваш терминал для лучшего опыта работы с Claude Code

***

<h2 id="troubleshooting">
  Устранение неполадок
</h2>

<h3 id="macos-and-linux-troubleshooting">
  Устранение неполадок macOS и Linux
</h3>

Если у вас возникли проблемы при установке на macOS или Linux, проверьте эти распространенные проблемы:

<Accordion title="'command not found: claude'">
  Если вы видите `command not found: claude` после установки, папка, в которую установщик поместил `claude`, отсутствует в вашем PATH. Установщик выводит точное исправление в разделе `Setup notes` в конце установки, поэтому запустите эту команду или используйте одну из приведённых ниже для вашей оболочки.

  Для Zsh, оболочки macOS по умолчанию:

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  ```

  Для Bash, оболочки Linux по умолчанию:

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  source ~/.bashrc
  ```

  Затем откройте новый терминал и попробуйте `claude` снова. Если он всё ещё не найден, проверьте, что файл `~/.local/bin/claude` существует. Если его нет, установка не завершилась. Для получения дополнительной информации см. [исправьте ваш PATH](/ru/troubleshoot-install#verify-your-path).
</Accordion>

<Accordion title="Ошибка с кодом HTML или 'syntax error near unexpected token'">
  Если вы видите `bash: line 1: syntax error near unexpected token '<'` или код HTML, такой как `<!DOCTYPE html>` в вашем терминале, URL установки вернул веб-страницу вместо скрипта установщика.

  Если на странице написано "App unavailable in region", Claude Code недоступен в вашей стране. См. [поддерживаемые страны](https://www.anthropic.com/supported-countries).

  В противном случае попробуйте запустить команду снова. Если это продолжает происходить, установите с помощью [Homebrew](https://brew.sh) вместо этого:

  ```bash theme={null}
  brew install --cask claude-code
  ```
</Accordion>

<Accordion title="Ошибка 'dyld' или 'built for Mac OS X 13.0'">
  Если вы видите `dyld: cannot load`, `dyld: Symbol not found` или `built for Mac OS X 13.0`, ваша версия macOS, вероятно, старше, чем поддерживает Claude Code.

  Откройте меню Apple и выберите About This Mac, чтобы проверить вашу версию. Если она старше 13.0, обновите macOS через Software Update. Для получения дополнительной информации см. [руководство по устранению неполадок macOS](/ru/troubleshoot-install#dyld-cannot-load-on-macos).
</Accordion>

Для других ошибок см. полное [руководство по устранению неполадок установки](/ru/troubleshoot-install).

<h3 id="windows-troubleshooting">
  Устранение неполадок Windows
</h3>

Если у вас возникли проблемы при установке на Windows, проверьте эти распространенные проблемы:

<Accordion title="'irm is not recognized'">
  Вы находитесь в CMD, а не в PowerShell. Закройте это окно и откройте PowerShell вместо этого (`Win + X`, затем выберите Windows PowerShell).

  Кроме того, используйте команду установки CMD:

  ```batch theme={null}
  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  ```
</Accordion>

<Accordion title="Ошибка SSL/TLS или 'Could not create SSL/TLS secure channel'">
  Это обычно происходит на старых системах Windows 10. Сначала запустите эту строку, затем повторите попытку установки:

  ```powershell theme={null}
  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  irm https://claude.ai/install.ps1 | iex
  ```
</Accordion>

<Accordion title="'Claude Code on Windows requires either Git for Windows (for bash) or PowerShell'">
  Ни PowerShell, ни Git Bash не найдены. Claude Code требует хотя бы одну оболочку.

  1. Убедитесь, что `powershell.exe` находится в вашем `PATH`. Его расположение по умолчанию — `C:\Windows\System32\WindowsPowerShell\v1.0\`. Кроме того, установите [PowerShell 7](https://aka.ms/powershell), который предоставляет `pwsh`.
  2. Если вы предпочитаете использовать Git Bash, установите [Git for Windows](https://git-scm.com/downloads/win) согласно [первому шагу в разделе Windows](#windows).
  3. Если Git установлен, но Claude Code не может его найти, скажите ему, где искать:
     ```powershell theme={null}
     $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
     ```
     Затем запустите `claude` снова. Если ваш Git установлен в другом месте, найдите путь, запустив:
     ```powershell theme={null}
     Get-Command git | Select-Object Source
     ```
     Найдите папку `Git\bin` в этом пути и используйте её вместо этого.

  Чтобы сделать это постоянным, чтобы вам не пришлось устанавливать его каждый раз, см. [настройте путь Git Bash](/ru/troubleshoot-install#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell).
</Accordion>

<Accordion title="'claude is not recognized'">
  Эта ошибка означает, что каталог установки отсутствует в вашем PATH. Запустите эти команды в PowerShell, чтобы добавить его:

  ```powershell theme={null}
  $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
  [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
  ```

  Закройте PowerShell, откройте новое окно и попробуйте `claude` снова. Для получения дополнительной информации см. [проверьте ваш PATH](/ru/troubleshoot-install#verify-your-path).
</Accordion>

Для других ошибок см. полное [руководство по устранению неполадок установки](/ru/troubleshoot-install).