Claude Code для начинающих: установка и настройка в 2026 году

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

Claude Code — агентный инструмент для программирования от Anthropic, который работает в терминале. Чтобы установить его в 2026 году, убедитесь, что у вас стоит Node.js 22 LTS (минимум 18+), выполните npm install -g @anthropic-ai/claude-code, авторизуйтесь через подписку Claude или API-ключ и запустите claude в папке любого проекта. Самый гладкий путь для новичка — направить Claude Code на шлюз вроде TeamoRouter: один API-ключ отвечает за авторизацию, кэширование промптов держит расходы низкими, а сетевые ограничения не мешают работе. В этом руководстве разобран каждый шаг, включая Windows, типичные ошибки и первую сессию.

Что такое Claude Code?

Claude Code — это агент командной строки, который работает прямо внутри вашего проекта. В отличие от веб-чата claude.ai, у него есть доступ к файловой системе, истории git и оболочке — поэтому он может читать кодовую базу, править файлы, запускать тесты и создавать коммиты под вашим присмотром.

Считайте его напарником по парному программированию, который живёт в терминале: вы описываете задачу, он изучает код, вносит изменения, запускает команды и итерирует, пока работа не будет сделана. В 2026 году он поддерживает несколько моделей Claude (Sonnet, Opus, Haiku), MCP-серверы для подключения внешних инструментов и полную интеграцию с git.

Что понадобится

Перед установкой проверьте три вещи:

1. Node.js 18+ (рекомендуется 22 LTS)

Claude Code — это npm-пакет. Минимальная версия — Node.js 18, но рекомендуется Node.js 22 LTS: он заметно быстрее в CLI-операциях, и свежие релизы Claude Code собираются именно под него. Проверьте свою версию:

node --version

Если нужно установить или обновить Node.js, используйте менеджер версий (рекомендуется) или Homebrew:

# macOS / Linux via nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts

# macOS via Homebrew
brew install node

На Windows установите Node.js с nodejs.org или командой winget install OpenJS.NodeJS.LTS.

Вариант без Node: у Anthropic есть и нативный установщик, которому Node.js не нужен: curl -fsSL https://claude.ai/install.sh | bash. Если вы вообще не хотите возиться с Node, используйте его.

2. Аккаунт Anthropic с доступом

Для Claude Code нужен платный план Claude (Pro, Max, Team или Enterprise) или кредиты API в Anthropic Console. Бесплатный план claude.ai не включает Claude Code. Если вы не можете платить Anthropic напрямую (нет иностранной карты, регион не поддерживается), практичный обходной путь — шлюз, принимающий локальные способы оплаты; см. Как оплатить Claude, если карту отклоняют.

3. Git

Claude Code использует git для отслеживания изменений и откатов. Подойдёт любая свежая версия git (2.30+). Проверьте командой git --version.

Шаг 1: установите Claude Code

Установите глобально через npm:

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

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

claude --version

Можно попробовать и без установки:

npx @anthropic-ai/claude-code

Типичные ошибки установки

Шаг 2: авторизуйтесь

Есть два варианта авторизации:

Вариант A — вход по подписке Claude (самый простой)

Запустите claude и в приветственном диалоге выберите «Login to Claude». Откроется браузер для входа в ваш аккаунт Claude (Pro/Max). После этого сессия привязывается к сессионным лимитам вашей подписки.

Вариант B — API-ключ (самый гибкий)

Экспортируйте API-ключ Anthropic и задайте base URL:

export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_BASE_URL="https://api.anthropic.com"
claude

Чтобы настройка сохранялась, добавьте эти строки в ~/.zshrc (macOS/Linux) или задайте их в системных переменных среды Windows.

Вариант C — ключ шлюза (лучший выбор для регионов с ограничениями и для экономии)

Если вы находитесь за пределами поддерживаемых Anthropic регионов или хотите держать расходы предсказуемыми, направьте Claude Code на шлюз:

export ANTHROPIC_API_KEY="your-teamorouter-key"
export ANTHROPIC_BASE_URL="https://gateway.teamorouter.com"
claude

Один и тот же ключ работает для Claude Code, Codex и Gemini CLI. Поскольку шлюз сохраняет кэширование промптов и применяет скидки по плавающей ставке, фактическая стоимость сессии заметно падает — расчёты см. в статье Подписка Claude или API: что дешевле в 2026 году?.

Шаг 3: особенности Windows

Claude Code работает на Windows 10/11 через Windows Terminal, PowerShell или Git Bash.

• Используйте Windows Terminal — это самая надёжная оболочка для интерактивного интерфейса Claude Code.
• Выбирайте Git Bash или WSL2 ради лучшей интеграции с git. Некоторые функции, зависящие от оболочки (например, отдельные git-хуки), надёжнее всего работают в Git Bash или WSL (Windows Subsystem for Linux).
• В случае WSL2 устанавливайте Claude Code внутри Linux-окружения, а не на стороне Windows.

Шаг 4: первая сессия

Создайте папку проекта и запустите в ней Claude Code:

mkdir my-project && cd my-project
claude

При первом запуске инструмент проведёт вас через оставшуюся настройку (вход, согласие на MCP-серверы, разрешения). Затем попробуйте первую задачу:

> Write a Python script that reads a CSV file and prints summary statistics.

Claude Code изучит папку, создаст скрипт и, возможно, предложит его запустить. Когда он запросит разрешение на запись или выполнение команд, просмотрите изменение и подтвердите.

Полезные команды для начала:

• /help — список всех команд
• /model — переключение моделей (Sonnet для повседневной работы, Opus для сложной архитектуры, Haiku для быстрого шаблонного кода)
• /undo — откат последнего изменения
• /clear — начать диалог с чистым контекстом
• /cost — расход токенов и стоимость сессии

Шаг 5: добавьте файл CLAUDE.md

Создайте в корне проекта файл CLAUDE.md с описанием соглашений — стиль кода, фреймворк, команды тестирования, заметки по архитектуре. Claude Code автоматически читает его в начале сессии, и это резко повышает качество результата:

# Project: my-project

## Stack
- Node.js 22 + Express, tests with Vitest

## Conventions
- Use async/await, never callbacks
- One component per file
- Run `npm test` before committing

Для новичка это шаг с самой большой отдачей: хороший CLAUDE.md избавляет от необходимости заново объяснять проект в каждом промпте.

Шаг 6: подключите MCP-серверы (необязательно, но мощно)

Model Context Protocol (MCP) позволяет Claude Code общаться с внешними инструментами — базами данных, трекерами задач, документацией, веб-поиском, вашим браузером. Новичкам больше всего пользы сразу дадут два сервера:

• Filesystem MCP — безопасный структурированный доступ к папкам за пределами проекта.
• Web search MCP — позволяет Claude прямо по ходу задачи подтягивать актуальную документацию и ответы со Stack Overflow.

Claude Code управляет MCP-серверами через интерактивный диалог (/mcp), либо их можно объявить в конфигурационном файле:

{
  "mcpServers": {
    "websearch": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-{provider}"]
    }
  }
}

MCP — это разница между агентом, который гадает, и агентом, который проверяет. Начинайте с малого — по одному серверу за раз, — чтобы точно видеть, что даёт каждое подключение.

Типичные ошибки новичков

1. Запуск вне git-репозитория. Без git неудачную правку в нескольких файлах трудно отменить. Всегда сначала делайте git init.
2. Слишком раннее отключение разрешений. Запросы «спросить перед записью» и «спросить перед выполнением» — это страховочные колёсики, которые стоит оставить, пока вы не начнёте доверять агенту.
3. Игнорирование кэширования промптов. Повторная отправка большой кодовой базы на каждом ходу многократно увеличивает расходы. Шлюз, сохраняющий кэширование, держит сессии дешёвыми.
4. Один промпт на все случаи. Расплывчатые промпты дают расплывчатый результат. Указывайте файл, суть сбоя и критерии приёмки.
5. Отсутствие CLAUDE.md. Без файла с контекстом проекта соглашения придётся объяснять заново в каждой сессии.

Шаг 7: что дальше

1. Возьмите реальную задачу. Исправьте баг, добавьте правило валидации или напишите юнит-тест — настоящая работа учит быстрее игрушечных примеров.
2. Добавьте ещё MCP-серверов. Когда освоитесь с основами, подключите трекер задач или базу данных.
3. Интегрируйте с редактором. Запускайте Claude Code параллельно с VS Code или JetBrains — работа в терминале дополняет ИИ-инструменты редактора, а не заменяет их.
4. Присмотритесь к шлюзу. Если вы начинали с прямого ключа Anthropic, переход на TeamoRouter даст единый доступ к Claude, Codex и Gemini по одному ключу, а также кэширование и доступность по всему миру.

FAQ

Claude Code бесплатный?

Сам инструмент устанавливается бесплатно, но для работы нужен платный план Claude или кредиты API. Типичная сессия программирования стоит от $0.50 до $5.00 при включённом кэшировании промптов; без кэширования (например, через некачественного реселлера) расходы могут быть в 5-10 раз выше. Шлюз, гарантирующий долю попаданий в кэш >99%, удерживает вас у нижней границы.

Чем Claude Code отличается от Claude Pro?

Claude Pro ($20/мес.) — это подписка на веб-интерфейс и приложение claude.ai. Claude Code — терминальный агент, который по состоянию на 2026 год входит в платные планы, а также работает с оплатой через API. Для разработки ПО Claude Code мощнее: у него есть доступ к файловой системе, он выполняет команды и интегрируется с git.

Можно ли использовать Claude Code на Windows?

Да — на Windows 10 и 11, через Windows Terminal, PowerShell или Git Bash. Установка через npm одинакова на всех платформах. Лучшую интеграцию с git дают Git Bash или WSL2.

Нужна ли банковская карта, чтобы начать работу со шлюзом?

Нет. TeamoRouter принимает Alipay и WeChat Pay с низким порогом минимального пополнения, так что начать можно без иностранной карты.

Как переключать модели?

Используйте команду /model внутри сессии или задайте переменную окружения ANTHROPIC_MODEL. По умолчанию Claude Code использует сбалансированную модель (Sonnet) и позволяет перейти на Opus для сложных задач на рассуждение.

Что делать, если Claude Code ошибся?

Всегда работайте в git-репозитории. Используйте /undo для отката последнего изменения или git checkout ., чтобы откатить всё. Держите систему разрешений включённой, пока не освоитесь, — это ваша страховка.

С чего начать

1. Зарегистрируйтесь в TeamoRouter и получите API-ключ
2. Задайте в ANTHROPIC_API_KEY и ANTHROPIC_BASE_URL значения шлюза
3. Запустите claude и начните первую сессию программирования с ИИ

Настроить Claude Code бесплатно →

Стабильный доступ к Claude, Codex и Gemini через TeamoRouter.