Claude Code на Windows

Установка Claude Code, подключение к claud.sale, выбор модели и работа в VS Code на Windows.

Подключите Claude Code к claud.sale и работайте с проектами из PowerShell или панели VS Code. Для подключения нужен отдельный API-ключ группы claude_max и положительный баланс на claud.sale.

Перед началом

• Windows 10 версии 1809 или новее, Windows 11 либо Windows Server 2019+, процессор x64/ARM64 и минимум 4 ГБ памяти.
• PowerShell: откройте меню «Пуск» и найдите Windows PowerShell. В начале строки будет PS.
• Войдите или зарегистрируйтесь, затем на странице API-ключей создайте ключ с группой claude_max. Ключ GPT из группы codex_pro для этого подключения не подходит.

Для привычных Bash-команд полезен Git for Windows. Актуальный Claude Code умеет работать и через PowerShell; Git Bash остаётся удобным вариантом для проектов с Unix-скриптами. Официальные требования описаны в документации установки.

1. Установите Claude Code

В обычном PowerShell выполните официальный установщик Anthropic:

irm https://claude.ai/install.ps1 | iex

Закройте PowerShell, откройте новое окно и проверьте команду:

claude --version
claude doctor

Должны появиться номер версии и диагностика установки. Для этого способа отдельная установка Node.js не требуется. Если claude не найден, перейдите к исправлению PATH.

2. Подключите claud.sale

Замените api_key в команде на свой Claude-ключ группы claude_max и выполните блок целиком в PowerShell. Настройщик получит ключ через ANTHROPIC_AUTH_TOKEN и сразу запишет настройки. Можно войти и скопировать команду с ключом на главной и скопировать готовую команду.

$env:ANTHROPIC_AUTH_TOKEN='api_key'; powershell -NoProfile -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12; iex (irm 'https://claud.sale/install/claude.ps1' -ErrorAction Stop)"

После успешной настройки полностью закройте все окна Windows Terminal, PowerShell и VS Code. Откройте PowerShell заново через «Пуск», затем запустите редактор: так процессы получат сохранённые переменные подключения. Новая вкладка в уже открытом Windows Terminal может унаследовать старые значения. Параметр -ExecutionPolicy Bypass действует только для этого запуска скрипта.

Скрипт сохраняет исходные настройки и пользовательские переменные Windows в %USERPROFILE%\.claude\claudsale-backups. Если задан CLAUDE_CONFIG_DIR, настройки и копии находятся в этом каталоге. Старые ANTHROPIC_API_KEY, ANTHROPIC_MODEL и переключатели Bedrock/Vertex/Foundry убираются из управляемого подключения после создания копии.

Если конфликтующая переменная задана на системном уровне Windows, настройщик остановится до изменений и покажет её имя. Уберите прежнее системное значение или обратитесь к администратору компьютера, затем повторите настройку.

Для смены ключа подставьте новый ключ вместо api_key и повторите весь блок подключения. Команда задаст новое значение ANTHROPIC_AUTH_TOKEN.

Ключ хранится на вашем компьютере в настройках клиента. Его не нужно вставлять в адрес сайта или отправлять в чат. Посмотреть текст скрипта настройки.

Ручная настройка

По умолчанию параметры находятся в %USERPROFILE%\.claude\settings.json. Если используете CLAUDE_CONFIG_DIR, в ручных командах подставьте этот каталог. Откройте файл через PowerShell:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null
$claudSettings = "$env:USERPROFILE\.claude\settings.json"
if (Test-Path $claudSettings) {
  Copy-Item $claudSettings "$claudSettings.before-claud-sale-$(Get-Date -Format yyyyMMdd-HHmmss).bak"
}
notepad $claudSettings

Для нового файла используйте пример целиком. В существующем объедините блок env и параметр model с вашими настройками, сохранив остальные поля. Замените ВАШ_CLAUDE_КЛЮЧ:

{
  "model": "opus",
  "env": {
    "ANTHROPIC_BASE_URL": "https://claud.sale",
    "ANTHROPIC_AUTH_TOKEN": "ВАШ_CLAUDE_КЛЮЧ",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Уберите старый ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN, чужой apiKeyHelper и настройки другого API из конфигурации, если они мешают подключению. Для текущего PowerShell:

Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:CLAUDE_CODE_OAUTH_TOKEN -ErrorAction SilentlyContinue

Если переменные возвращаются после перезапуска, проверьте пользовательские переменные среды Windows, профиль PowerShell и env в файлах .claude/settings.json и .claude/settings.local.json проекта. Удаляйте только прежние настройки подключения. Правила применения переменных описаны в инструкции Anthropic для шлюзов.

3. Проверьте первый ответ

Перейдите в папку своего проекта и запустите клиент:

Set-Location "C:\путь\к\проекту"
claude --model opus

Подтвердите доверие знакомой папке. Внутри Claude Code выполните /status: адрес API должен быть https://claud.sale, а источник авторизации — ваш ANTHROPIC_AUTH_TOKEN. Затем отправьте: «Ответь одним словом: готово. Файлы не меняй».

Успешная проверка — завершённый текстовый ответ и новый запрос в истории использования. Проверочный запрос тоже учитывается в расходе. Итоговые списания смотрите на claud.sale: локальные оценки Claude Code могут отличаться от наших тарифов.

Выбор модели

Настройка выше закрепляет короткие имена за моделями claud.sale:

Команда /model открывает выбор. Для одного запуска можно указать полный идентификатор: claude --model claude-sonnet-5. Если после перезапуска снова выбирается старая модель, проверьте ANTHROPIC_MODEL в окружении и настройки проекта. Подробнее о выборе моделей.

Claude Code в VS Code

1. Откройте расширения VS Code сочетанием Ctrl+Shift+X. Установите Claude Code от Anthropic, идентификатор anthropic.claude-code.
2. Через Ctrl+Shift+P откройте Preferences: Open User Settings (JSON).
3. Добавьте приведённые поля в пользовательские настройки, сохранив остальные. Вставьте тот же Claude-ключ.

{
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://claud.sale" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "ВАШ_CLAUDE_КЛЮЧ" }
  ]
}

Сохраните файл и выполните Developer: Reload Window. Откройте панель командой Claude Code: Open in New Tab и отправьте короткую проверку. Общие настройки моделей берутся из %USERPROFILE%\.claude\settings.json.

Параметры claudeCode.environmentVariables нужны самому расширению для проверки подключения до запуска. Не сохраняйте ключ в файле .vscode/settings.json репозитория; исключите настройки с ключом из Settings Sync, если не хотите переносить его на другие устройства. Встроенный терминал VS Code тоже подходит: откройте его и выполните claude. Официальная настройка шлюза в расширении.

Если проект находится в WSL

Откройте терминал своей Linux-системы WSL и выполните инструкцию для Linux. У WSL собственные домашняя папка, установка CLI и настройки. При работе через VS Code подключитесь к проекту командой WSL: Open Folder in WSL и установите расширение в WSL-окружение; ключ настройте в том окружении, где запускается Claude.

Если что-то не работает

# Добавить путь только для текущего PowerShell
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"
claude --version

# При необходимости указать установленный Git Bash
$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"

Чтобы сохранить PATH, откройте в Windows «Изменение переменных среды текущего пользователя», измените Path и добавьте %USERPROFILE%\.local\bin. Дубликаты установки покажет where.exe claude. Официальная диагностика установки.

Обновление, восстановление и удаление

Для установки через официальный скрипт доступны фоновые обновления и ручная команда:

claude update
claude --version

Для смены ключа повторите настройку claud.sale с новым ключом и обновите его также в пользовательских настройках расширения. После этого начните новую сессию.

Для отмены автоматической настройки закройте Claude Code и VS Code и запустите восстановление последнего снимка. Если временный файл уже удалён, сначала заново скачайте скрипт командой из шага 2:

powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\claud-sale-claude.ps1" -Restore

Откат возвращает состояние перед последним применением; перед заменой текущие файлы тоже сохраняются. При нескольких запусках это может быть уже настроенное ранее подключение к claud.sale.

Файл settings.json восстанавливается целиком: правки, сделанные после снимка, останутся в копии before-restore. Если они нужны, перенесите их в восстановленный файл вручную.

При ручной настройке восстановите сохранённую до изменений копию settings.json. Отдельно уберите добавленные claudeCode.environmentVariables и claudeCode.disableLoginPrompt из пользовательских настроек VS Code. Если вводили переменные вручную, уберите их из профиля и переменных среды Windows. Полностью закройте Windows Terminal и откройте PowerShell через «Пуск». Сохранённый вход Anthropic снова может использоваться после удаления ключа шлюза.

Удаление CLI, установленного официальным скриптом:

Remove-Item "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item "$env:USERPROFILE\.local\share\claude" -Recurse -Force

История и пользовательская конфигурация в .claude сохраняются. Расширение удаляется отдельно через список расширений VS Code. Другие способы установки имеют свои команды удаления.

Официальные источники

Инструкция сверена 9 сентября 2026 года: установка и обновления, подключение к шлюзу, модели, VS Code, переменные среды, скачивание файлов в Windows PowerShell.