Claude Code на Windows: установка и частые ошибки
Большинство проблем с Claude Code на Windows из-за того, что команды для macOS не работают в PowerShell и CMD. Вот установка, которая работает с первого раза, и разбор частых ошибок.
Установка
- Установите Node.js 18 или новее с nodejs.org (кнопка LTS), затем закройте и снова откройте терминал.
- Установите Claude Code:
npm install -g @anthropic-ai/claude-code. - Откройте терминал в папке проекта. Узнайте, какой он: синий PowerShell (по умолчанию в Windows 10/11 и VS Code) или чёрный CMD.
Подключение ключа в PowerShell
$env:ANTHROPIC_BASE_URL="https://api.klinch.cloud"
$env:ANTHROPIC_AUTH_TOKEN="kl_live_…"
claudeПодключение ключа в CMD
set ANTHROPIC_BASE_URL=https://api.klinch.cloud
set ANTHROPIC_AUTH_TOKEN=kl_live_…
claudeЭти команды действуют, пока открыто окно. Чтобы не вводить их каждый раз, создайте файл C:\Users\имя\.claude\settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.klinch.cloud",
"ANTHROPIC_AUTH_TOKEN": "kl_live_…",
"ANTHROPIC_MODEL": "claude-sonnet-5-5"
}
}Частые ошибки
| Что видите | Что сделать |
|---|---|
| Просит войти в Anthropic или выбрать подписку | Переменные не дошли. export на Windows не работает: в PowerShell нужен $env:, в CMD set. Надёжнее всего settings.json. |
| Auth conflict, работает старый аккаунт | Выполните /logout в Claude Code, закройте его и удалите переменную ANTHROPIC_API_KEY. |
| 404 Not found | ANTHROPIC_BASE_URL без /v1 и без слеша в конце. |
| 401 Invalid API key | В ключ попал пробел или кавычка. Скопируйте его кнопкой копирования, ключ начинается с kl_live_. |
| Вчера работало, сегодня просит войти | $env: и set живут до закрытия окна. Используйте settings.json или setx. |
| «claude» не является командой | Терминал открыт до установки. Закройте все окна терминала и откройте новое. |
Подробная инструкция с кнопкой проверки ключа есть в кабинете, в разделе «Подключение». Больше о работе без подписки на странице Claude Code без VPN.