# Руководство по установке

> ⚡ **Рекомендуется: установка в один клик** — одна команда выполняет все шаги этой страницы (замер endpoint, конфигурация, установка Node.js / Claude Code, проверка соединения; без sudo). Для ручной установки читайте дальше.

```bash
# macOS / Linux
curl -fsSL https://qcode.cc/install/claude-code.sh | bash
```

```powershell
# Windows PowerShell
irm https://qcode.cc/install/claude-code.ps1 | iex
```

> Подробнее: [Скрипт установки в один клик](/docs/getting-started/one-click-install) (флаги / диагностика / откат).

> 📖 Не уверены, что указывать в `ANTHROPIC_BASE_URL`, или какой из четырёх доменов выбрать? См. [Точки доступа и форматы API](./endpoints-and-api-paths).

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

## Предварительные требования

Для работы Claude Code необходима среда Node.js. Убедитесь, что на вашем компьютере установлен Node.js версии 18.0 или выше (рекомендуется **Node.js 22 LTS**).

<div data-os="windows" markdown="1">

## Windows

### Шаг 1: Установка Node.js

#### Способ 1: Скачивание с официального сайта (рекомендуется)

1. Откройте браузер и перейдите на [https://nodejs.org/](https://nodejs.org/)

2. Нажмите на версию "LTS" для скачивания (рекомендуемая версия с долгосрочной поддержкой)

3. После завершения загрузки дважды щёлкните по файлу `.msi`

4. Следуйте мастеру установки, используя настройки по умолчанию

#### Способ 2: С помощью менеджера пакетов

Если у вас уже установлен Chocolatey или Scoop:

```powershell
# С помощью Chocolatey
choco install nodejs

# Или с помощью Scoop
scoop install nodejs
```

#### Проверка установки

После завершения установки откройте PowerShell или CMD и введите:

```powershell
node --version
npm --version
```

Если отображаются номера версий — установка прошла успешно!

### Шаг 2: Установка Claude Code

Откройте PowerShell или CMD и выполните:

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

Проверка установки:

```powershell
claude --version
```

### Шаг 3: Настройка переменных окружения

#### Временная настройка (текущая сессия)

В PowerShell выполните:

```powershell
$env:ANTHROPIC_BASE_URL = "https://api.qcode.cc/api"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key"
```

#### Постоянная настройка (рекомендуется)

Установка переменных окружения на уровне пользователя:

```powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.qcode.cc/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-api-key", [System.EnvironmentVariableTarget]::User)
```

> Не забудьте заменить `your-api-key` на реальный ключ, созданный в [панели управления QCode.cc](https://qcode.cc/dashboard).

#### Проверка настройки

```powershell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
```

### Шаг 4: Начало работы

```powershell
# Перейдите в директорию вашего проекта
cd C:\path\to\your\project

# Запустите Claude Code
claude
```

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

**Ошибка прав доступа?**

- Запустите PowerShell от имени администратора

- Или настройте npm для использования пользовательской директории: `npm config set prefix %APPDATA%\npm`

**Ошибка политики выполнения PowerShell?**

```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

**Переменные окружения не применяются?**

- После установки постоянных переменных окружения перезапустите PowerShell или CMD

- Или выйдите из системы и войдите снова

</div>

<div data-os="macos" markdown="1">

## macOS

### Шаг 1: Установка Node.js

#### Способ 1: С помощью Homebrew (рекомендуется)

Если у вас уже установлен Homebrew:

```bash
# Обновление Homebrew
brew update

# Установка Node.js
brew install node
```

#### Способ 2: Скачивание с официального сайта

1. Перейдите на [https://nodejs.org/](https://nodejs.org/)

2. Скачайте LTS-версию для macOS

3. Откройте загруженный файл `.pkg`

4. Следуйте инструкциям по установке

#### Проверка установки

```bash
node --version
npm --version
```

### Шаг 2: Установка Claude Code

#### Способ 1: Homebrew (рекомендуется)

```bash
brew install --cask claude-code
```

#### Способ 2: Установка через npm

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

При ошибке прав доступа используйте sudo:

```bash
sudo npm install -g @anthropic-ai/claude-code
```

Проверка установки:

```bash
claude --version
```

### Шаг 3: Настройка переменных окружения

#### Временная настройка (текущая сессия)

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"
```

#### Постоянная настройка (рекомендуется)

Отредактируйте конфигурационный файл вашей оболочки:

```bash
# Для zsh (по умолчанию в macOS)
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc

# Для bash
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bash_profile
source ~/.bash_profile
```

> Не забудьте заменить `your-api-key` на реальный ключ, созданный в [панели управления QCode.cc](https://qcode.cc/dashboard).

### Шаг 4: Начало работы

```bash
# Перейдите в директорию вашего проекта
cd /path/to/your/project

# Запустите Claude Code
claude
```

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

**Ошибка прав доступа?**

- Установите с помощью sudo: `sudo npm install -g @anthropic-ai/claude-code`

- Или настройте npm для использования пользовательской директории: `npm config set prefix ~/.npm-global`

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

- Откройте "Системные настройки" -> "Конфиденциальность и безопасность"

- Нажмите "Всё равно открыть" или "Разрешить"

</div>

<div data-os="linux" markdown="1">

## Linux / WSL2

### Шаг 1: Установка Node.js

#### Способ 1: Официальный репозиторий NodeSource (рекомендуется)

```bash
# Добавление репозитория NodeSource
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# Установка Node.js
sudo apt-get install -y nodejs
```

#### Способ 2: Системный менеджер пакетов

```bash
# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm
```

#### Проверка установки

```bash
node --version
npm --version
```

### Шаг 2: Установка Claude Code

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

При ошибке прав доступа:

```bash
sudo npm install -g @anthropic-ai/claude-code
```

Проверка установки:

```bash
claude --version
```

### Шаг 3: Настройка переменных окружения

#### Временная настройка

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"
```

#### Постоянная настройка

```bash
# Для bash (по умолчанию)
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bashrc
source ~/.bashrc

# Для zsh
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc
```

### Шаг 4: Начало работы

```bash
cd /path/to/your/project
claude
```

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

**Отсутствуют библиотеки зависимостей?**

```bash
# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"
```

</div>

## Расширенная конфигурация (необязательные переменные окружения)

Помимо двух обязательных переменных, вы можете настроить дополнительные параметры с помощью следующих переменных:

### ANTHROPIC_MODEL

Укажите модель по умолчанию. Для повседневной работы рекомендуем явно задать Sonnet 5. Если переменная не задана, Claude Code использует встроенный default своей версии CLI — не опирайтесь на историческое имя с этой страницы. Идентификаторы 4.x (`claude-sonnet-4-6`, `claude-opus-4-8`) по-прежнему в продаже.

```bash
# Повседневная рекомендация (Sonnet 5)
export ANTHROPIC_MODEL=claude-sonnet-5

# Тяжёлая работа (Opus 5, дороже)
export ANTHROPIC_MODEL=claude-opus-5
```

### MAX_THINKING_TOKENS

Управляйте максимальным количеством токенов для процесса «мышления» модели (0 — отключить):

```bash
export MAX_THINKING_TOKENS=16000
```

### CLAUDE_CODE_EFFORT_LEVEL

Настройте уровень усердия Claude:

```bash
# Варианты: low / medium / high
export CLAUDE_CODE_EFFORT_LEVEL=high
```

### CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

Отключить необязательные сетевые запросы (телеметрию и т. д.):

```bash
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

## Следующие шаги

Поздравляем! Вы успешно установили Claude Code. Далее:

1. Ознакомьтесь с [быстрым стартом](/docs/getting-started/quick-start) для изучения базовых возможностей

2. Изучите [советы по использованию](/docs/usage/cli-tips) для повышения эффективности