Установка Claude CLI в 2026 году: настройка на macOS, Windows и WSL2

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

Установка Claude CLI (Claude Code) зависит от платформы: на macOS он ставится через Homebrew (brew install claude-code), на Windows — через npm внутри WSL2 (npm install -g @anthropic-ai/claude-code), на Linux — через npm или как отдельный бинарный файл. Минимальная версия Node.js — 18. После установки настройте API-эндпоинт: либо напрямую на API Anthropic (нужен API-ключ и зарубежный способ оплаты), либо через единый шлюз вроде TeamoRouter (поддерживает Alipay/WeChat, VPN не нужен). Полная инструкция — ниже.

Что такое Claude CLI (Claude Code)?

Claude CLI — официальное название Claude Code — это агентный инструмент Anthropic для программирования в командной строке. Он работает в терминале и умеет читать, писать и рефакторить код во всём проекте, выполнять shell-команды, управлять операциями Git и взаимодействовать с MCP-серверами (Model Context Protocol), которые расширяют его возможности: доступ к базам данных, веб-поиск, интеграция с API.

В отличие от веб-интерфейса claude.ai, Claude CLI имеет прямой доступ к файловой системе, работает в окружении вашей оболочки и действует как агент: планирует многошаговые задачи, выполняет их, смотрит на результат и итерирует. Это основной инструмент для разработки с помощью ИИ в терминале; его конкуренты — Codex, Cursor CLI и GitHub Copilot CLI.

Требования

Перед установкой Claude CLI убедитесь, что система соответствует требованиям:

Claude CLI работает везде, где работает Node.js, но удобнее всего им пользоваться на macOS и Linux. Пользователям Windows сначала нужно установить WSL2: нативная Windows пока не поддерживается.

Установка: macOS

Вариант 1: Homebrew (рекомендуется)

Через Homebrew устанавливать и обновлять проще всего:

# Сначала установите Node.js (если он ещё не установлен)
brew install node@20

# Проверьте Node.js
node --version  # Должно быть v20.x.x или новее
npm --version   # Должно быть v10.x.x или новее

# Установите Claude Code
brew install claude-code

# Проверьте установку
claude --version

Homebrew автоматически подтягивает Node.js как зависимость. Обновление: brew upgrade claude-code.

Вариант 2: npm (глобальная установка)

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

На macOS для глобальной установки через npm может понадобиться sudo, если Node.js ставился официальным установщиком. С nvm этого не требуется: он устанавливает глобальные пакеты в домашний каталог.

Установка: Windows (через WSL2)

Нативную Windows Claude CLI пока не поддерживает. Нужен WSL2.

Шаг 1. Установите WSL2

Откройте PowerShell от имени администратора:

wsl --install

Перезагрузите компьютер. После перезагрузки откроется терминал Ubuntu.

Шаг 2. Установите Node.js внутри WSL2

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
node --version
npm --version

Шаг 3. Установите Claude Code

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

Для максимальной производительности держите файлы проекта в файловой системе WSL2 (~/projects/), а не на смонтированном диске Windows (/mnt/c/). Ввод-вывод между файловыми системами даёт накладные расходы, которые замедляют массовые операции с файлами.

Установка: Linux

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code

# Fedora/RHEL
sudo dnf module install nodejs:20
npm install -g @anthropic-ai/claude-code

# Arch Linux
sudo pacman -S nodejs npm
npm install -g @anthropic-ai/claude-code

Настройка при первом запуске

После установки настройте API-эндпоинт:

Вариант A: API Anthropic напрямую

export ANTHROPIC_API_KEY="sk-ant-api03-your-key-here"

Нужен аккаунт Anthropic с зарубежным способом оплаты.

Вариант B: шлюз TeamoRouter (рекомендуется)

export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"
export ANTHROPIC_API_KEY="tr-your-key-here"

TeamoRouter даёт доступ к Claude Fable 5, Sonnet 4, Opus 4, GPT-4o, Gemini и другим моделям через один API-ключ. Баланс можно пополнить через Alipay и WeChat Pay — зарубежная кредитная карта не нужна. Доля попаданий в кэш промптов превышает 99%, что резко снижает стоимость токенов.

Чтобы сохранить конфигурацию:

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

# Для bash (по умолчанию в Linux)
echo 'export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="tr-your-key"' >> ~/.bashrc
source ~/.bashrc

Или отредактируйте ~/.claude/settings.json:

{
  "apiKey": "tr-your-key",
  "baseUrl": "https://api.teamorouter.com/anthropic"
}

Проверьте настройку

echo "Write a Python function that reverses a string" | claude

Если пришёл нормальный ответ, всё готово.

Сравнение конфигураций: напрямую или через шлюз

Подробнее — на странице AI API-шлюза TeamoRouter.

Решение типичных проблем при установке

«command not found: claude»

Глобальный каталог bin от npm не входит в ваш PATH:

npm config get prefix
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Ошибки прав доступа при глобальной установке через npm (macOS/Linux)

Управляйте Node.js через nvm (он устанавливает глобальные пакеты без sudo):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 20
nvm use 20
npm install -g @anthropic-ai/claude-code

Слишком старая версия Node.js

# Установите nvm и обновитесь
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 20
nvm use 20
nvm alias default 20

«Authentication failed» при первом запуске

1. Убедитесь, что ключ скопирован целиком (без потерянных символов)
2. Проверьте, что в конце base URL нет лишнего слеша
3. Проверьте в консоли, что ключ не отозван
4. Попробуйте запустить без кастомного base URL, чтобы сначала убедиться, что ключ работает с официальным эндпоинтом

WSL2: проблемы с производительностью файловой системы

Перенесите проект из файловой системы Windows в нативную файловую систему WSL2:

cp -r /mnt/c/Users/YourName/Projects/my-project ~/projects/my-project
cd ~/projects/my-project
claude

macOS: предупреждение «Developer cannot be verified»

Откройте System Settings > Privacy & Security и нажмите Allow Anyway рядом с заблокированным приложением. Это стандартное поведение macOS для инструментов, которые распространяются не через App Store.

Удаление и обновление

# Удаление (Homebrew)
brew uninstall claude-code

# Удаление (npm)
npm uninstall -g @anthropic-ai/claude-code

# Удалить всю локальную конфигурацию
rm -rf ~/.claude

# Обновление
brew upgrade claude-code      # Homebrew
npm update -g @anthropic-ai/claude-code  # npm

FAQ

Нужен ли Node.js для работы с Claude CLI?

Да. Claude Code — это приложение на Node.js, которое распространяется через npm и Homebrew. Минимальная версия — Node.js 18. Писать на JavaScript не придётся: это просто среда выполнения.

Можно ли установить Claude Code на Windows без WSL?

Нет. Нативной поддержки Windows пока нет. WSL2 — обязательный и официально поддерживаемый путь для пользователей Windows. На современном компьютере настройка занимает около 10 минут.

Как обновить Claude CLI до последней версии?

brew upgrade claude-code (macOS/Homebrew) или npm update -g @anthropic-ai/claude-code (Linux/npm). Узнать текущую версию можно командой claude --version.

Можно ли пользоваться Claude CLI без API-ключа Anthropic?

Можно — с любым совместимым с Anthropic API-эндпоинтом, заданным через ANTHROPIC_BASE_URL. Например, TeamoRouter предоставляет Anthropic-совместимый эндпоинт с собственным форматом API-ключей (tr-).

Как настроить Claude Code на работу с несколькими API-провайдерами?

Используйте ~/.claude/settings.json или переключайтесь, меняя ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY. Инструменты вроде клиента TeamoRouter позволяют переключать провайдеров на лету, без ручной правки конфигов.

Отличается ли установка через Homebrew от установки через npm?

Функциональной разницы нет. Homebrew оборачивает npm-пакет и сам разбирается с зависимостями Node.js. Оба способа устанавливают одну и ту же команду claude.

Работает ли Claude CLI офлайн?

Нет. Claude Code для каждого действия нужно сетевое подключение к API-эндпоинту. Ни локальной модели, ни офлайн-режима нет.