Установка, поверхности и окружения

Прежде чем агентный цикл Claude Code сделает первый шаг — прочитает файл, запустит команду, зафиксирует изменение — его нужно запустить. Звучит банально, но здесь есть нюансы: способ установки влияет на то, насколько оперативно вы получаете обновления, а выбор поверхности определяет, какие возможности доступны под рукой.

Установка CLI

Native-инсталлятор (рекомендуется)

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

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

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Главное преимущество native-установки — автоматические обновления в фоне. Вы всегда на актуальной версии без лишних команд. На Windows без WSL рекомендуется установить Git for Windows: без него Claude Code использует PowerShell вместо Bash-инструментов, что сужает функциональность.

Homebrew

brew install --cask claude-code

Homebrew предлагает два канала:

claude-code — стабильный, чуть отстаёт от bleeding edge (обычно около недели), пропускает релизы с критическими регрессиями.
claude-code@latest — получает новые версии сразу после выхода.

Автообновления нет: нужно запускать brew upgrade claude-code (или brew upgrade claude-code@latest) вручную.

WinGet

winget install Anthropic.ClaudeCode

Обновление: winget upgrade Anthropic.ClaudeCode. Также без автоапдейта.

Linux-пакетные менеджеры

На Debian/Ubuntu — apt, на Fedora/RHEL — dnf, на Alpine — apk. Детали и репозитории описаны в документации по расширенной настройке.

npm

Пакет @anthropic-ai/claude-code доступен в npm-реестре — тот же бинарник, удобен для CI-сценариев или програмной интеграции:

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

Проверь себя

Вы устанавливаете Claude Code через Homebrew командой `brew install --cask claude-code`. Нужно ли вам вручную обновлять его? Какой канал вы получаете — стабильный или самый свежий?

Быстрое повторение

Почему native-инсталлятор Claude Code рекомендуется использовать вместо пакетных менеджеров на macOS и Linux?

Пять поверхностей, один движок

Claude Code живёт в пяти основных средах. Ключевая деталь — все они работают на одном движке: CLAUDE.md, настройки (settings.json) и MCP-серверы единые независимо от поверхности.

flowchart TB subgraph surf["Поверхности"] T["Terminal CLI"] VS["VS Code / Cursor"] JB["JetBrains"] DA["Desktop App"] WEB["Web (claude.ai/code)"] end E["Единый движок Claude Code"] T --> E VS --> E JB --> E DA --> E WEB --> E subgraph shared["Общие ресурсы"] CM["CLAUDE.md"] ST["settings.json"] MCP["MCP-серверы"] end subgraph prov["Провайдеры моделей"] AN["Anthropic API"] BR["Amazon Bedrock"] VX["Google Vertex AI"] FD["Microsoft Foundry"] end E --> shared E --> prov

flowchart TB
    subgraph surf["Поверхности"]
        T["Terminal CLI"]
        VS["VS Code / Cursor"]
        JB["JetBrains"]
        DA["Desktop App"]
        WEB["Web (claude.ai/code)"]
    end

    E["Единый движок Claude Code"]

    T --> E
    VS --> E
    JB --> E
    DA --> E
    WEB --> E

    subgraph shared["Общие ресурсы"]
        CM["CLAUDE.md"]
        ST["settings.json"]
        MCP["MCP-серверы"]
    end

    subgraph prov["Провайдеры моделей"]
        AN["Anthropic API"]
        BR["Amazon Bedrock"]
        VX["Google Vertex AI"]
        FD["Microsoft Foundry"]
    end

    E --> shared
    E --> prov

Все пять поверхностей используют один движок, общие CLAUDE.md, settings и MCP-серверы, но подключаются к разным провайдерам моделей

Terminal (CLI)

Флагман и основная среда. Именно здесь новые возможности появляются первыми. Запустить в проекте:

cd your-project
claude

CLI поддерживает headless-режим (claude -p "...") для скриптов и CI, пайпы, JSON-вывод. Подробнее — в статье Headless-режим и скриптинг через CLI.

VS Code / Cursor

Расширение устанавливается через маркетплейс (Cmd+Shift+X → поиск «Claude Code») или по прямым ссылкам:

VS Code: vscode:extension/anthropic.claude-code
Cursor: cursor:extension/anthropic.claude-code

После установки: Command Palette → Claude Code: Open in New Tab. Расширение добавляет инлайн-диффы прямо в редактор, @-упоминания файлов, режим plan review и историю разговоров. Cursor — форк VS Code, расширение работает без изменений.

JetBrains

Плагин для IntelliJ IDEA, PyCharm, WebStorm и всего семейства. Устанавливается через JetBrains Marketplace («Claude Code Beta»). Важно: плагин требует отдельно установленного CLI — он не поставляется в комплекте. Особенность плагина — интерактивный просмотр диффов и передача контекста из выделенного текста.

Desktop App

Standalone-приложение для macOS (Intel и Apple Silicon) и Windows (x64 и ARM64). Не требует открытого терминала: визуальный просмотр диффов, параллельные сессии рядом на одном экране, запуск задач по расписанию, cloud-сессии. Требует платной подписки. Приложение доступно для скачивания с claude.ai.

Web (claude.ai/code)

Браузерный вариант без локальной установки. Удобен для длительных фоновых задач («запустить и вернуться позже»), работы с репозиториями, которых нет локально, или мобильного доступа через Claude iOS App. Функция claude --teleport позволяет перенести web-сессию в терминал и продолжить там.

Проверь себя

Перечислите, что является общим для всех пяти поверхностей Claude Code. Почему это важно на практике?

Навигация между поверхностями

Поверхности не изолированы — можно переключаться без потери контекста:

Команда / механизм	Что делает
`/desktop` в CLI	Передаёт сессию в Desktop App для визуального review
`claude --teleport`	Подтягивает web-сессию в терминал
`/remote-control`	Управление локальной сессией с телефона или другого устройства
Dispatch (Desktop)	Отправить задачу с телефона — Desktop создаёт сессию

Аутентификация

При первом запуске CLI открывает браузер для авторизации. Доступны два пути:

claude.ai — личная подписка (Pro, Max) или командный тариф (Teams/Enterprise). Именно здесь живёт доступ к Desktop и Web-поверхностям.

Anthropic Console — API-ключ с PAYG-биллингом для индивидуальных разработчиков.

CLI и VS Code — единственные поверхности с поддержкой сторонних провайдеров моделей. Desktop и Web работают только через Anthropic.

Сторонние провайдеры моделей

Если ваша команда работает в инфраструктуре AWS, GCP или Azure — Claude Code поддерживает нативную интеграцию. Модели те же, биллинг идёт через вашего облачного провайдера.

Amazon Bedrock

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
# Стандартные AWS credentials: IAM role, ~/.aws/credentials и т.д.

Аутентификация через IAM — никаких отдельных ключей Anthropic не нужно. Аудит через CloudTrail включается автоматически.

Google Vertex AI

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id
# gcloud auth application-default login — для dev-окружения

Для production используйте Service Account с нужными ролями Vertex AI.

Microsoft Foundry

export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource
export ANTHROPIC_FOUNDRY_API_KEY=your-api-key   # или без него — тогда Microsoft Entra ID

Foundry поддерживает оба варианта аутентификации: API-ключ и Entra ID (бывший Azure AD) для сценариев с SSO.

Claude Platform on AWS

Отличается от Bedrock: это фактически Anthropic API с биллингом через AWS Marketplace. Новые версии моделей появляются там быстрее, чем в Bedrock, и сохраняются все функции Claude API (например, расширенные возможности prompt-кэширования).

Фиксация версий моделей

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

export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5-20250929
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-5-20251101

Алиасы типа claude-sonnet-latest могут разрешаться в разные версии у разных провайдеров и нередко отстают от последних релизов. Фиксация даёт полный контроль над тем, когда команда переходит на новую модель.

Проверить активную конфигурацию: команда /status прямо в Claude Code.

Проверь себя

Команда переходит на Amazon Bedrock для Claude Code. Какие три переменные окружения нужны как минимум, и нужен ли при этом API-ключ Anthropic?