Claude Code — это AI-агент для разработки от Anthropic который живёт в вашем терминале и помогает писать код быстрее через естественные команды на языке. Понимает всю кодовую базу проекта, выполняет рутинные задачи, объясняет сложный код, управляет git workflows и интегрируется с вашим окружением разработки.
В этом гайде покажем как установить Claude Code на Windows тремя способами — через PowerShell (рекомендуется), WinGet и npm (устаревший). Без маркетинга — только практика: что работает, какие подводные камни, как решать типичные проблемы.
Что такое Claude Code
Claude Code — терминальный AI-ассистент который работает прямо в командной строке вашего проекта. Не плагин для IDE и не веб-интерфейс — полноценный агент в терминале который понимает контекст всего проекта и выполняет задачи через bash/PowerShell команды.
Как это работает:
Вы запускаете claude в директории проекта. Claude Code сканирует структуру файлов, читает код, понимает зависимости и архитектуру. Даёте команду естественным языком — "добавь валидацию email в форму регистрации" или "напиши тесты для AuthController". Claude анализирует код, предлагает изменения, показывает diff и применяет правки с вашего подтверждения.
Инструмент работает с любыми языками программирования и фреймворками — Python, jаvascript, TypeScript, Go, Rust, Java, C#, PHP, Ruby. Понимает контекст React, Vue, Django, Laravel, .NET, Rails проектов. Помогает с git — создаёт коммиты с осмысленными сообщениями, работает с ветками, решает конфликты.
Возможности из коробки:
Генерация кода по описанию задачи с учётом стиля проекта. Рефакторинг — улучшение существующего кода с сохранением функциональности. Написание тестов для функций и модулей. Объяснение сложного кода простым языком. Поиск и исправление багов. Git workflows — коммиты, ветки, pull requests. Работа с базами данных через MCP серверы. Интеграция с GitHub для управления issues и PR.
Чем отличается от GitHub Copilot:
GitHub Copilot работает внутри редактора и дополняет код построчно. Claude Code работает в терминале и понимает весь проект целиком. Copilot автокомплит на уровне функций. Claude выполняет задачи на уровне фич — добавляет новые эндпоинты, пишет миграции БД, создаёт компоненты UI.
Claude Code видит всю кодовую базу одновременно и понимает связи между файлами. Может изменять несколько файлов в рамках одной задачи. Работает с git из коробки. Copilot для автодополнения во время печати, Claude Code для делегирования целых задач AI агенту.
Модели под капотом:
По умолчанию используется Claude Opus 4.6 — самая мощная модель Anthropic для глубокого reasoning по большим кодовым базам. Можно переключиться на Claude Sonnet 4.6 для лучшего баланса скорость/качество или Claude Haiku для быстрых простых задач с меньшей стоимостью.
Opus даёт лучшее качество для сложной архитектуры, многофайловых изменений, рефакторинга legacy кода. Sonnet — оптимальный выбор для ежедневной разработки. Haiku для простых правок, документации, форматирования.
Системные требования
Claude Code официально поддерживает Windows 10 версия 1903+ и Windows 11. Работает в PowerShell 5.1+ (встроен в Windows), PowerShell Core 7+ или командной строке CMD. Git Bash также поддерживается.
Обязательные требования:
Git for Windows 2.34+ должен быть установлен. Claude Code использует Git Bash внутри для выполнения команд даже если запускаете из PowerShell. Скачайте с git-scm.com/download/win если ещё не установлен. Стандартная установка со всеми опциями по умолчанию работает отлично.
Подписка Claude Pro ($20/месяц), Claude Max ($100-200/месяц), Teams или Enterprise план. Либо API ключ от Anthropic Console с оплатой по токенам. Бесплатного доступа к Claude Code нет — инструмент требует мощных моделей которые потребляют много токенов.
Стабильное интернет-соединение. Claude Code отправляет код и контекст проекта на серверы Anthropic для обработки. Работа офлайн невозможна — каждая команда требует обращения к API.
Рекомендуемые компоненты:
Windows Terminal — современный терминал от Microsoft с вкладками, Unicode поддержкой, настраиваемыми темами. Устанавливается через Microsoft Store бесплатно. PowerShell выглядит и работает в нём намного лучше чем в стандартном терминале.
Visual Studio Code или другой редактор кода. Claude Code работает в терминале отдельно от редактора но удобнее всего когда терминал открыт рядом с кодом. VS Code имеет встроенный терминал — можно работать не переключаясь между окнами.
Node.js 18+ LTS нужен только для устаревшего npm метода установки. Нативный PowerShell установщик и WinGet не требуют Node.js вообще. Если всё же используете npm установку, берите LTS версию с nodejs.org/en/download.
Ресурсы системы:
Claude Code сам по себе лёгкий — занимает 50-100 MB на диске и потребляет минимум RAM в режиме ожидания. Основная нагрузка идёт на сеть при отправке кода на серверы Anthropic. Большие проекты (500+ файлов) требуют больше времени на первое сканирование — до 10-20 секунд.
Для комфортной работы нужен процессор любого поколения последних 5 лет, 4+ GB свободной RAM (сам Claude Code занимает 200-300 MB активной памяти), 500 MB свободного места на диске, широкополосный интернет от 5 Mbps для быстрой отправки кода.
Способ 1: PowerShell установка (рекомендуется)
Нативный PowerShell установщик — официально рекомендуемый метод от Anthropic. Не требует Node.js, автоматически обновляется в фоне, работает быстрее npm версии.
Шаг 1: Открываем PowerShell
Нажмите Win + X и выберите "Windows PowerShell" или "Terminal". Либо нажмите Win + R, введите powershell и Enter. Права администратора НЕ нужны — установка идёт в профиль пользователя.
Шаг 2: Запускаем установщик
Скопируйте и вставьте команду в PowerShell:
irm https://claude.ai/install.ps1 | iex
Нажмите Enter. Установщик скачает бинарник Claude Code и установит в %LOCALAPPDATA%\Programs\ClaudeCode. Процесс занимает 10-30 секунд в зависимости от скорости интернета.
Шаг 3: Проверяем установку
claude --version
Должна показаться версия типа 1.2.3. Если видите ошибку "команда не найдена", закройте и заново откройте PowerShell — PATH обновляется после перезапуска терминала.
Шаг 4: Первый запуск
Перейдите в любую директорию с кодом:
cd C:\Users\YourName\projects\my-app
claude
При первом запуске откроется браузер для OAuth авторизации. Войдите с аккаунтом Claude Pro/Max. После авторизации токен сохранится локально в ~/.claude/ и повторная авторизация не потребуется.
Автообновления:
Нативная установка обновляется автоматически в фоне. Новые версии скачиваются и применяются без вашего участия. Можете настроить канал обновлений: latest (по умолчанию) получает фичи сразу как выходят, stable использует версии примерно неделю старше пропуская релизы с критическими багами.
Переключение модели:
claude --model claude-sonnet-4-6
Настройка канала обновлений:
claude /config
Выберите "Auto-update channel" и укажите нужный.
Способ 2: WinGet установка
WinGet — официальный пакетный менеджер Windows. Встроен в Windows 11 и Windows 10 22H2+. Если команда winget не работает, установите App Installer из Microsoft Store.
Установка через WinGet:
winget install Anthropic.ClaudeCode
WinGet скачает и установит Claude Code автоматически. После установки:
claude --version
Обновление:
WinGet установки НЕ обновляются автоматически. Запускайте обновление вручную периодически:
winget upgrade Anthropic.ClaudeCode
Известная проблема: Claude Code может уведомить об обновлении раньше чем новая версия появится в WinGet репозитории. Если upgrade не находит обновление, подождите несколько часов и попробуйте снова.
Способ 3: npm установка (устаревший)
npm метод официально deprecated но всё ещё работает. Используйте только если нативная установка по какой-то причине не подходит.
Требования:
Node.js 18+ LTS. Проверьте версию:
node --version
Если Node.js нет или версия старее 18, скачайте LTS с nodejs.org/en/download.
Установка:
npm install -g @anthropic-ai/claude-code
НЕ используйте sudo на Windows — это вызывает проблемы с правами. Если получаете ошибки доступа, настройте npm использовать директорию пользователя:
mkdir $env:USERPROFILE\.npm-global
npm config set prefix "$env:USERPROFILE\.npm-global"
$env:PATH += ";$env:USERPROFILE\.npm-global"
После установки:
claude --version
Обновление npm версии:
npm update -g @anthropic-ai/claude-code
Миграция с npm на нативную установку:
Если сейчас используете npm версию и хотите перейти на нативную:
Установите нативную версию:
irm https://claude.ai/install.ps1 | iex
Удалите npm версию:
npm uninstall -g @anthropic-ai/claude-code
Настройки из ~/.claude/ сохранятся — ничего настраивать заново не нужно.
Аутентификация и настройка
OAuth через Claude.ai (рекомендуется):
При первом запуске claude в любой директории откроется браузер на странице авторизации. Войдите с аккаунтом Claude Pro, Max, Teams или Enterprise. После подтверждения токен сохранится локально и больше входить не придётся.
Токен хранится в %USERPROFILE%\.claude\session.json. Защищён правами доступа файловой системы Windows. Никогда не коммитьте этот файл в git и не делитесь им.
API ключ для CI/CD:
Для серверов, контейнеров или CI пайплайнов где нельзя открыть браузер, используйте переменную окружения с API ключом:
$env:ANTHROPIC_API_KEY = "sk-ant-api03-ваш-ключ"
claude
Получите API ключ на console.anthropic.com → API Keys → Create Key. Это платный метод — токены списываются по стандартным API расценкам Anthropic.
Для постоянного использования добавьте в переменные окружения Windows: Win + R → sysdm.cpl → вкладка "Дополнительно" → "Переменные среды" → создайте ANTHROPIC_API_KEY со значением вашего ключа.
Выбор модели:
По умолчанию используется Claude Opus 4.6. Переключение на другую модель:
Через команду при запуске:
claude --model claude-sonnet-4-6
Или в настройках:
claude /config
Выберите "Default model" и укажите нужную.
Доступные модели:
claude-opus-4-6— максимальное качество, медленнее, дорожеclaude-sonnet-4-6— баланс скорости и качества (рекомендуется)claude-3-5-haiku-20241022— быстрая и дешёвая для простых задач
Первые шаги и базовое использование
Создание тестового проекта:
Создаём папку проекта:
mkdir C:\projects\claude-test
cd C:\projects\claude-test
Инициализируем git (рекомендуется):
git init
Создаём простой файл:
"console.log('Hello World');" > app.js
Запускаем Claude Code:
claude
Основные команды:
Claude Code работает через slash-команды и естественный язык. Важные команды:
/help — показывает все доступные команды с описанием
/ask — задать вопрос о коде: /ask "объясни что делает функция parseUser"
/generate — сгенерировать код: /generate "создай Express сервер с роутом /api/users"
/test — написать тесты: /test "создай unit тесты для AuthService"
/refactor — рефакторинг кода: /refactor "преобразуй callbacks в async/await"
/bug — сообщить о баге в Claude Code (отправляет репорт в Anthropic)
/compact — сжать историю разговора чтобы освободить контекст
/exit — выйти из Claude Code
Работа через естественный язык:
Просто описывайте задачу без команд. Claude поймёт:
> добавь валидацию email в форму регистрации
> исправь баг где пользователь может отправить пустую форму
> создай API endpoint для получения списка постов с пагинацией
> напиши README с инструкциями по установке проекта
Claude покажет какие файлы изменит, предложит diff с изменениями. Вы подтверждаете или отклоняете каждое изменение. Можете попросить уточнить или переделать.
Пример сессии разработки:
PS C:\projects\blog-api> claude
Claude Code v1.2.3
> создай Express API с endpoints для постов: GET /posts, GET /posts/:id, POST /posts, DELETE /posts/:id
⏺ I'll create an Express API with CRUD endpoints for blog posts...
[Claude показывает какие файлы создаст: server.js, routes/posts.js, controllers/postsController.js]
Accept all changes? (y/n/show): y
✓ Created server.js
✓ Created routes/posts.js
✓ Created controllers/postsController.js
> добавь валидацию для POST /posts — title обязателен и минимум 5 символов
⏺ I'll add input validation for the POST endpoint...
[Показывает изменения в postsController.js]
Accept? (y/n): y
✓ Updated controllers/postsController.js
> создай тесты для этих endpoints
⏺ I'll write tests using Jest and supertest...
[Создаёт tests/posts.test.js с 10+ тест-кейсами]
CLAUDE.md файл — инструкции для проекта
CLAUDE.md — markdown файл в корне проекта который даёт Claude постоянный контекст: команды сборки, code conventions, архитектурные паттерны, специфику проекта.
Генерация CLAUDE.md:
cd C:\projects\your-app
claude /init
Claude проанализирует проект и создаст CLAUDE.md автоматически с информацией о:
- Структуре проекта и назначении директорий
- Технологиях и зависимостях
- Командах для запуска dev/build/test
- Code style и naming conventions
- Архитектурных решениях
Пример CLAUDE.md:
# Blog API Project
## Tech Stack
- Node.js 20 + Express 4.18
- PostgreSQL 16
- Jest для тестов
- Sequelize ORM
## Commands
- `npm run dev` — запуск dev сервера на порту 3000
- `npm test` — запуск тестов
- `npm run migrate` — миграции БД
## Code Conventions
- Используем async/await вместо промисов
- Именование файлов: camelCase для JS, kebab-case для директорий
- Все API ответы в формате {success: boolean, dаta: any, error?: string}
- Валидация через express-validator middleware
## Architecture
- MVC паттерн: controllers → services → models
- Роуты в routes/, бизнес-логика в services/
- Конфигурация в config/ через dotenv
После создания CLAUDE.md каждый раз когда запускаете claude, он читает этот файл и учитывает инструкции при генерации кода.
Интеграция с проектами
Работа с существующим проектом:
# Переходим в проект
cd C:\Users\YourName\workspace\existing-app
# Запускаем Claude
claude
# Просим проанализировать проект
> проанализируй этот проект и расскажи что он делает
Claude просканирует все файлы, поймёт структуру и технологии. Для больших проектов (1000+ файлов) первое сканирование занимает 20-60 секунд.
Git workflows:
Claude Code понимает git и помогает с версионным контролем:
> посмотри мои изменения и создай осмысленный commit message
> создай новую ветку feature/user-authentication
> помоги разрешить конфликт слияния в файле auth.js
Claude видит статус git, может читать diff, создавать коммиты с хорошими сообщениями соблюдая Conventional Commits.
GitHub интеграция:
Через MCP серверы Claude может работать с GitHub напрямую:
> создай issue на GitHub про этот баг
> посмотри открытые pull requests и дай мне саммари
> ответь на комментарий в PR #42
Требует настройки GitHub MCP сервера через claude mcp add.
Работа с базами данных:
С MCP серверами для БД Claude может:
> покажи схему таблицы users
> выполни SELECT * FROM posts WHERE status='published'
> создай миграцию для добавления поля avatar_url в таблицу users
Поддерживаются PostgreSQL, MySQL, MongoDB через соответствующие MCP серверы.
MCP серверы — расширение возможностей
MCP (Model Context Protocol) — протокол для подключения внешних инструментов к Claude Code. Превращает ассистента в полноценного агента который может работать не только с файлами но и с внешними системами.
Популярные MCP серверы:
GitHub MCP — работа с репозиториями, issues, pull requests. Создание PR, review кода, управление прямо из Claude Code.
PostgreSQL/MySQL MCP — запросы к БД, инспекция схем, выполнение миграций. Claude видит данные и использует их при генерации кода.
Slack MCP — отправка сообщений, чтение каналов. Можно автоматизировать уведомления или получать контекст из обсуждений команды.
File Search MCP — умный поиск по коду с RL-trained алгоритмами. Находит точные участки кода вместо вываливания целых файлов.
Установка MCP сервера:
HTTP серверы:
claude mcp add --transport http server-name http://localhost:8080
Локальные серверы:
claude mcp add github-mcp -- npx -y @modelcontextprotocol/server-github
Просмотр подключенных:
claude mcp list
После установки Claude получает доступ к функциям MCP сервера и может использовать их в ответах.
Решение проблем
Проблема: "claude: command not found"
После установки PowerShell не видит команду claude.
Решение: Закройте и заново откройте PowerShell. PATH обновляется только при старте новой сессии терминала. Если не помогло, проверьте что C:\Users\YourName\AppData\Local\Programs\ClaudeCode добавлен в PATH.
Проблема: "Git is not installed"
Claude Code требует Git for Windows но не может его найти.
Решение: Скачайте и установите Git for Windows с git-scm.com/download/win. Используйте стандартные настройки установщика. После установки перезапустите PowerShell и попробуйте снова.
Проблема: npm установка даёт ошибки доступа
При npm install -g получаете ошибки EACCES или permission denied.
Решение: НЕ используйте sudo на Windows. Настройте npm на локальную директорию:
mkdir $env:USERPROFILE\.npm-global
npm config set prefix "$env:USERPROFILE\.npm-global"
Добавьте в PATH:
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\.npm-global", "User")
Перезапустите PowerShell и установите снова.
Проблема: Claude Code не авторизуется
OAuth окно открывается но авторизация не проходит.
Решение: Убедитесь что у вас активная подписка Claude Pro/Max. Проверьте что файл %USERPROFILE%\.claude\session.json не readonly. Попробуйте удалить этот файл и авторизоваться заново. Если не помогает, используйте API ключ через переменную окружения.
Проблема: Очень медленная работа
Claude Code тормозит, команды выполняются минутами.
Решение: Проверьте скорость интернета — Claude отправляет много данных на серверы. Большие проекты (2000+ файлов) требуют времени на анализ. Попробуйте модель Haiku для простых задач — она быстрее.
Проблема: Ошибка "context window exceeded"
Claude говорит что превышен лимит контекста.
Решение: Используйте /compact чтобы сжать историю разговора. Разбейте большую задачу на несколько меньших сессий. Очистите старые сообщения через /clear. Не заливайте в контекст огромные файлы целиком — попросите Claude работать с конкретными функциями.
Проблема: Обновление не работает
claude update или winget upgrade ничего не обновляет.
Решение: Для WinGet установки новая версия может появиться в репозитории с задержкой. Подождите 1-2 дня и попробуйте снова. Для npm версии запустите npm update -g @anthropic-ai/claude-code. Нативная PowerShell установка обновляется автоматически в фоне — проверьте версию через claude --version.
Диагностика проблем:
claude doctor
Эта команда автоматически проверяет: версию Node.js (для npm установки), статус авторизации, здоровье MCP серверов, права доступа к файлам. Показывает что не так и как исправить.
Частые вопросы
Нужны ли права администратора для установки?
Нет. Нативная PowerShell установка и npm метод ставятся в профиль пользователя без admin прав. WinGet может потребовать прав для первого запуска но сама установка Claude Code идёт без них.
Работает ли Claude Code без интернета?
Нет. Каждая команда отправляет код на серверы Anthropic для обработки. Офлайн режим невозможен по архитектуре.
Сколько стоит использование?
С подпиской Claude Pro ($20/мес) или Max ($100-200/мес) Claude Code включён без дополнительной платы. При использовании API ключа платите за токены по стандартным API расценкам: Opus ~$15/$75 за миллион токенов input/output, Sonnet дешевле.
Безопасно ли отправлять код на серверы Anthropic?
Anthropic заявляет что не использует данные пользователей для обучения моделей. Код хранится ограниченное время для работы сессии. Для критичных проектов используйте self-hosted опции через AWS Bedrock или Google Vertex AI где данные остаются в вашей инфраструктуре.
Можно ли использовать на проектах компании?
Да если у компании есть Teams или Enterprise подписка.
Какие языки программирования поддерживаются?
Все популярные языки: jаvascript, TypeScript, Python, Java, C#, Go, Rust, Ruby, PHP, Swift, Kotlin, C++. Claude понимает фреймворки: React, Vue, Angular, Django, Flask, Spring Boot, .NET, Laravel, Rails.
Работает ли с WSL?
Да. Можете установить Claude Code в WSL Ubuntu и запускать оттуда. Это даёт нативный Linux опыт на Windows. Установка внутри WSL через bash скрипт: curl -fsSL https://claude.ai/install.sh | bash
Как удалить Claude Code?
PowerShell установка: удалите директорию %LOCALAPPDATA%\Programs\ClaudeCode и %USERPROFILE%\.claude. WinGet: winget uninstall Anthropic.ClaudeCode. npm: npm uninstall -g @anthropic-ai/claude-code.
Использование с THE.Hosting серверами
Хотя Claude Code работает локально на вашем Windows компьютере, разработчики часто разворачивают проекты на удалённых серверах для продакшна, стейджинга или CI/CD.
Сценарии использования THE.Hosting:
Development и staging серверы — VPS для тестирования приложения в production-like окружении перед релизом. Claude Code помогает написать код локально, потом деплоите на THE.Hosting VPS для проверки.
CI/CD пайплайны — автоматическая сборка и тесты при push в git. Разворачиваете GitHub Actions или GitLab CI на THE.Hosting runner серверах. Claude Code генерирует код, CI прогоняет тесты и деплоит на production.
Базы данных для разработки — PostgreSQL или MySQL на THE.Hosting VPS. Claude Code через MCP серверы может подключаться к удалённой БД для запросов и миграций.
API серверы — бэкенд на Node.js, Python, Go развёрнутый на THE.Hosting. Фронтенд разрабатываете локально с Claude Code, API крутится на VPS.
Рекомендуемые конфигурации VPS:
Для staging Node.js/Python проектов подойдёт Beryllium VPS: 2 vCPU / 2 GB RAM / 20 GB NVMe за €3.77/месяц. Достаточно для малых API и тестовых окружений.
Для production приложений берите Ruthenium VPS: 4 vCPU / 8 GB RAM / 80 GB NVMe за ~€20/месяц.
Для микросервисов или CI runners несколько Beryllium VPS дешевле и гибче чем один мощный сервер. Разные сервисы на разных VPS — изоляция и масштабируемость.
Выбор локации THE.Hosting:
THE.Hosting имеет 50+ локаций глобально. Для европейских пользователей оптимальны Нидерланды (Меппел) или Германия (Франкфурт) с минимальным пингом 10-30ms. Азиатский трафик лучше обслуживать из Японии или Гонконга.
Все VPS с полным root доступом, NVMe дисками и поддержкой 24/7 на всех языках. Можете установить Docker, настроить Nginx, развернуть БД — всё что нужно для production окружения.
Заключение
Claude Code — мощный AI инструмент для Windows разработчиков который ускоряет написание кода через делегирование рутинных задач AI агенту. Установка занимает 5 минут через PowerShell команду. Работает с любыми языками и фреймворками. Понимает контекст проекта и генерирует код учитывая архитектуру.
Изучив этот гайд вы получили: три метода установки на Windows (PowerShell, WinGet, npm), настройку авторизации через OAuth или API ключ, понимание основных команд и естественных запросов, знание про CLAUDE.md для кастомизации под проект, интеграцию с git и внешними системами через MCP, решения типичных проблем установки и работы.
Claude Code не заменяет разработчика но существенно ускоряет работу над рутинными задачами. Генерация кода, написание тестов, рефакторинг, документация — всё что отнимает время но не требует креативных решений. Оставляет больше времени на архитектурные решения и сложную бизнес-логику.
Для разворачивания проектов используйте THE.Hosting VPS в 50+ локациях — от Нидерландов до Японии , от Германии до США. Все серверы с NVMe дисками, root доступом и поддержкой 24/7 на всех языках мира.
Полезные ссылки
Claude Code:
THE.Hosting:
- VPS в 50+ странах — от €1/мес
- VPS в Нидерландах — интернет-хаб Европы
- База знаний — гайды и инструкции
- Telegram поддержка — 24/7 на русском и английском