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

Установка и настройка Claude Code на Windows, macOS и Linux

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

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

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

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

Windows ¶

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

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

Откройте браузер и перейдите на https://nodejs.org/
Нажмите на версию "LTS" для скачивания (рекомендуемая версия с долгосрочной поддержкой)
После завершения загрузки дважды щёлкните по файлу .msi
Следуйте мастеру установки, используя настройки по умолчанию

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

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

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

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

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

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

node --version
npm --version

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

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

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

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

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

claude --version

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

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

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

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

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

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

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

Не забудьте заменить your-api-key на реальный ключ, созданный в панели управления QCode.cc.

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

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

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

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

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

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

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

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

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

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

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

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

macOS ¶

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

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

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

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

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

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

Перейдите на https://nodejs.org/
Скачайте LTS-версию для macOS
Откройте загруженный файл .pkg
Следуйте инструкциям по установке

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

node --version
npm --version

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

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

brew install --cask claude-code

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

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

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

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

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

claude --version

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

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

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

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

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

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

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

Не забудьте заменить your-api-key на реальный ключ, созданный в панели управления QCode.cc.

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

# Перейдите в директорию вашего проекта
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

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

Откройте "Системные настройки" -> "Конфиденциальность и безопасность"
Нажмите "Всё равно открыть" или "Разрешить"

Linux / WSL2 ¶

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

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

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

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

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

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

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

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

node --version
npm --version

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

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

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

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

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

claude --version

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

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

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

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

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

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

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

cd /path/to/your/project
claude

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

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

# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"

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

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

ANTHROPIC_MODEL ¶

Укажите модель по умолчанию (без настройки используется Sonnet 4.6):

# Использовать Sonnet 4.6 (по умолчанию, рекомендуется)
export ANTHROPIC_MODEL=claude-sonnet-4-6-20250929

# Использовать Opus 4.6 (наиболее мощная, выше стоимость)
export ANTHROPIC_MODEL=claude-opus-4-6

MAX_THINKING_TOKENS ¶

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

export MAX_THINKING_TOKENS=16000

CLAUDE_CODE_EFFORT_LEVEL ¶

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

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

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ¶

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

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

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

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

Ознакомьтесь с быстрым стартом для изучения базовых возможностей
Изучите советы по использованию для повышения эффективности

← Предыдущая

Введение

Быстрый старт

🚀

Начните с QCode — ИИ-ассистент для программистов

Официальный ретранслятор Claude Code, быстро и надёжно

Посмотреть тарифы → Создать аккаунт