Установка 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 он работает нативно, если установлены Node.js и Git for Windows; WSL2 — по желанию.

Установка: 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 10 и 11). Установите Node.js (LTS) и Git for Windows, откройте PowerShell или командную строку и выполните:

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

Права администратора и WSL не нужны. Пошагово со скриншотами — в руководстве по установке Claude Code.

Через WSL2 (по желанию). Если вам удобнее Linux-оболочка или проекты уже лежат в WSL, установите Claude Code там:

Шаг 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"
export ANTHROPIC_AUTH_TOKEN="sk-teamo-your-key-here"
export ANTHROPIC_API_KEY=""   # оставьте пустым, иначе Claude Code уйдёт на вход Anthropic

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"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-teamo-your-key"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=""' >> ~/.zshrc
source ~/.zshrc

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

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

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.teamorouter.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-teamo-your-key",
    "ANTHROPIC_API_KEY": ""
  }
}

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

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?

Да. Claude Code работает в Windows 10 и 11 нативно: установите Node.js и Git for Windows и выполните npm install -g @anthropic-ai/claude-code в PowerShell. WSL2 остаётся вариантом, если вам удобнее Linux-оболочка.

Как обновить 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-ключей (sk-teamo-).

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

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

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

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

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

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