Установите NodeJS 18+, затем выполните: 
npm install -g @anthropic-ai/claude-code
НЕ используйте sudo npm install -g, так как это может привести к проблемам с разрешениями и рискам безопасности. Если вы столкнулись с ошибками разрешений, см. настройка Claude Code для рекомендуемых решений.
Claude Code — это агентный инструмент для программирования, который работает в вашем терминале, понимает вашу кодовую базу и помогает вам программировать быстрее с помощью команд на естественном языке. Благодаря прямой интеграции с вашей средой разработки Claude Code оптимизирует ваш рабочий процесс без необходимости в дополнительных серверах или сложной настройке. Ключевые возможности Claude Code включают:
  • Редактирование файлов и исправление ошибок в вашей кодовой базе
  • Ответы на вопросы об архитектуре и логике вашего кода
  • Выполнение и исправление тестов, линтинга и других команд
  • Поиск в истории git, разрешение конфликтов слияния, создание коммитов и PR
Исследовательский предпросмотрCode находится в бета-версии как исследовательский предпросмотр. Мы собираем отзывы разработчиков о предпочтениях в сотрудничестве с ИИ, о том, какие рабочие процессы больше всего выигрывают от помощи ИИ, и о том, как улучшить опыт работы с агентом.Эта ранняя версия будет развиваться на основе отзывов пользователей. В ближайшие недели мы планируем улучшить надежность выполнения инструментов, поддержку долго выполняющихся команд, отображение в терминале и самопознание Claude о своих возможностях.Сообщайте об ошибках напрямую с помощью команды /bug или через наш репозиторий GitHub.

​
Перед началом работы

​
Проверьте системные требования

  • Операционные системы: macOS 10.15+, Ubuntu 20.04+/Debian 10+ или Windows через WSL
  • Аппаратное обеспечение: минимум 4 ГБ ОЗУ
  • Программное обеспечение:
    • Node.js 18+
    • git 2.23+ (опционально)
    • GitHub или GitLab CLI для рабочих процессов с PR (опционально)
    • ripgrep (rg) для улучшенного поиска файлов (опционально)
  • Сеть: Требуется подключение к интернету для аутентификации и обработки ИИ
  • Местоположение: Доступно только в поддерживаемых странах
Устранение неполадок при установке WSLВ настоящее время Claude Code не работает напрямую в Windows и требует WSL. Если вы столкнулись с проблемами в WSL:
  1. Проблемы с определением ОС/платформы: Если вы получаете ошибку во время установки, WSL может использовать Windows npm. Попробуйте:
    • Выполните npm config set os linux перед установкой
    • Установите с помощью npm install -g @anthropic-ai/claude-code --force --no-os-check (НЕ используйте sudo)
  2. Ошибки “node not found”: Если вы видите exec: node: not found при запуске claude, ваша среда WSL может использовать Windows-установку Node.js. Вы можете проверить это с помощью which npm и which node, которые должны указывать на пути Linux, начинающиеся с /usr/, а не с /mnt/c/. Чтобы исправить это, попробуйте установить Node через менеджер пакетов вашего дистрибутива Linux или через nvm.

​
Установка и аутентификация

1

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

Выполните в терминале: npm install -g @anthropic-ai/claude-code
НЕ используйте sudo npm install -g, так как это может привести к проблемам с разрешениями и рискам безопасности. Если вы столкнулись с ошибками разрешений, см. настройка Claude Code для рекомендуемых решений.
2

Перейдите в ваш проект

cd директория-вашего-проекта
3

Запустите Claude Code

Выполните claude для запуска
4

Завершите аутентификацию

Claude Code предлагает два варианта аутентификации:
  • Anthropic Console: Вариант по умолчанию. Подключитесь через Anthropic Console и завершите процесс OAuth. Требуется активный биллинг на console.anthropic.com.
  • Тарифный план Max: Подпишитесь на тарифный план Claude Max для единой подписки, которая включает как Claude Code, так и веб-интерфейс. Получите больше ценности по той же цене, управляя своей учетной записью в одном месте. Войдите с вашей учетной записью Claude.ai. Во время запуска выберите вариант, соответствующий вашему типу подписки.

​
Основные функции и рабочие процессы

Claude Code работает непосредственно в вашем терминале, понимая контекст вашего проекта и выполняя реальные действия. Нет необходимости вручную добавлять файлы в контекст - Claude будет исследовать вашу кодовую базу по мере необходимости.

​
Безопасность и конфиденциальность по дизайну

Безопасность вашего кода имеет первостепенное значение. Архитектура Claude Code обеспечивает:
  • Прямое подключение к API: Ваши запросы идут прямо в API Anthropic без промежуточных серверов
  • Работает там, где работаете вы: Работает непосредственно в вашем терминале
  • Понимает контекст: Поддерживает осведомленность о всей структуре вашего проекта
  • Предпринимает действия: Выполняет реальные операции, такие как редактирование файлов и создание коммитов

​
От вопросов к решениям за секунды

# Задавайте вопросы о вашей кодовой базе
claude
> как работает наша система аутентификации?

# Создавайте коммит одной командой
claude commit

# Исправляйте проблемы в нескольких файлах
claude "исправь ошибки типов в модуле аутентификации"

​
Инициализируйте ваш проект

Для пользователей, использующих впервые, мы рекомендуем:
  1. Запустите Claude Code с помощью claude
  2. Попробуйте простую команду, например summarize this project
  3. Сгенерируйте руководство по проекту CLAUDE.md с помощью /init
  4. Попросите Claude зафиксировать сгенерированный файл CLAUDE.md в вашем репозитории

​
Используйте Claude Code для общих задач

Claude Code работает непосредственно в вашем терминале, понимая контекст вашего проекта и выполняя реальные действия. Нет необходимости вручную добавлять файлы в контекст - Claude будет исследовать вашу кодовую базу по мере необходимости.

​
Понимание незнакомого кода

> что делает система обработки платежей?
> найди, где проверяются разрешения пользователей
> объясни, как работает слой кэширования

​
Автоматизация операций Git

> commit my changes
> create a pr
> which commit added tests for markdown back in December?
> rebase on main and resolve any merge conflicts

​
Интеллектуальное редактирование кода

> add input validation to the signup form
> refactor the logger to use the new API
> fix the race condition in the worker queue

​
Тестирование и отладка вашего кода

> run tests for the auth module and fix failures
> find and fix security vulnerabilities
> explain why this test is failing

​
Поощрение более глубокого мышления

Для сложных проблем явно попросите Claude мыслить более глубоко: 
> think about how we should architect the new payment service
> think hard about the edge cases in our authentication flow
Claude Code покажет, когда Claude использует расширенное мышление (доступно на Claude Sonnet 3.7, Claude Opus 4). Вы можете проактивно попросить Claude “подумать” или “подумать глубоко” для задач, требующих более интенсивного планирования. Мы предлагаем сначала рассказать Claude о вашей задаче и позволить ему собрать контекст из вашего проекта. Затем попросите его “подумать”, чтобы создать план.
Claude будет думать больше в зависимости от используемых вами слов. Например, “думай усердно” вызовет более расширенное мышление, чем просто “подумай”.Для получения дополнительных советов см. Советы по расширенному мышлению.

​
Автоматизация рабочих процессов CI и инфраструктуры

Claude Code поставляется с неинтерактивным режимом для безголового выполнения. Это особенно полезно для запуска Claude Code в неинтерактивных контекстах, таких как скрипты, пайплайны и Github Actions. Используйте --print (-p) для запуска Claude в неинтерактивном режиме. В этом режиме вы можете установить переменную окружения ANTHROPIC_API_KEY для предоставления пользовательского API-ключа. Неинтерактивный режим особенно полезен, когда вы предварительно настраиваете набор команд, которые Claude может использовать: 
export ANTHROPIC_API_KEY=sk_...
claude -p "update the README with the latest changes" --allowedTools "Bash(git diff:*)" "Bash(git log:*)" Write --disallowedTools ...

​
Управление Claude Code с помощью команд

​
Команды CLI

КомандаОписаниеПример
claudeЗапуск интерактивного REPLclaude
claude "query"Запуск REPL с начальным запросомclaude "explain this project"
claude -p "query"Выполнение одноразового запроса, затем выходclaude -p "explain this function"
cat file | claude -p "query"Обработка переданного содержимогоcat logs.txt | claude -p "explain"
claude configНастройка параметровclaude config set --global theme dark
claude updateОбновление до последней версииclaude update
claude mcpНастройка серверов Model Context ProtocolСм. раздел MCP в руководствах
Флаги CLI:
  • --print (-p): Вывод ответа без интерактивного режима
  • --json: Возврат вывода JSON в режиме --print, полезно для скриптов и автоматизации
  • --verbose: Включение подробного логирования, показывает полный пошаговый вывод (полезно для отладки как в режиме печати, так и в интерактивном режиме)
  • --dangerously-skip-permissions: Пропуск запросов разрешений

​
Слэш-команды

Управление поведением Claude в рамках сессии:
КомандаНазначение
/bugСообщение об ошибках (отправляет разговор в Anthropic)
/clearОчистка истории разговора
/compact [instructions]Сжатие разговора с опциональными инструкциями фокусировки
/configПросмотр/изменение конфигурации
/costПоказ статистики использования токенов
/doctorПроверка работоспособности вашей установки Claude Code
/helpПолучение справки по использованию
/initИнициализация проекта с руководством CLAUDE.md
/loginПереключение учетных записей Anthropic
/logoutВыход из вашей учетной записи Anthropic
/memoryРедактирование файлов памяти CLAUDE.md
/pr_commentsПросмотр комментариев к pull request
/reviewЗапрос на проверку кода
/terminal-setupУстановка привязки клавиш Shift+Enter для новых строк (только для iTerm2 и VSCode)
/vimВход в режим vim для чередования режимов вставки и команд

​
Управление памятью Claude

Claude Code может запоминать ваши предпочтения между сессиями, такие как руководства по стилю и общие команды в вашем рабочем процессе.

​
Определение типа памяти

Claude Code предлагает три места хранения памяти, каждое из которых служит разным целям:
Тип памятиРасположениеНазначениеПримеры использования
Память проекта./CLAUDE.mdОбщие для команды соглашения и знанияАрхитектура проекта, стандарты кодирования, общие рабочие процессы
Память проекта (локальная)./CLAUDE.local.mdЛичные предпочтения для конкретного проектаВаши URL-адреса песочницы, предпочтительные тестовые данные
Память пользователя~/.claude/CLAUDE.mdГлобальные личные предпочтенияПредпочтения по стилю кода, личные ярлыки для инструментов
Все файлы памяти автоматически загружаются в контекст Claude Code при запуске.

​
Как Claude ищет воспоминания

Claude Code читает воспоминания рекурсивно: начиная с текущего рабочего каталога, Claude Code рекурсивно поднимается до / и читает любые файлы CLAUDE.md или CLAUDE.local.md, которые он находит. Это особенно удобно при работе в больших репозиториях, где вы запускаете Claude Code в foo/bar/, и у вас есть воспоминания как в foo/CLAUDE.md, так и в foo/bar/CLAUDE.md.

​
Быстрое добавление воспоминаний с помощью ярлыка #

Самый быстрый способ добавить воспоминание — начать ввод с символа #: 
# Всегда используйте описательные имена переменных
Вам будет предложено выбрать, в какой файл памяти сохранить это.

​
Прямое редактирование воспоминаний с помощью /memory

Используйте слэш-команду /memory во время сессии, чтобы открыть любой файл памяти в вашем системном редакторе для более обширных дополнений или организации.

​
Лучшие практики для памяти

  • Будьте конкретны: “Используйте отступ в 2 пробела” лучше, чем “Правильно форматируйте код”.
  • Используйте структуру для организации: Форматируйте каждое отдельное воспоминание как маркированный пункт и группируйте связанные воспоминания под описательными заголовками markdown.
  • Периодически пересматривайте: Обновляйте воспоминания по мере развития вашего проекта, чтобы убедиться, что Claude всегда использует самую актуальную информацию и контекст.

​
Управление разрешениями и безопасностью

Claude Code использует многоуровневую систему разрешений для баланса между мощностью и безопасностью:
Тип инструментаПримерТребуется одобрениеПоведение “Да, больше не спрашивать”
Только для чтенияЧтение файлов, LS, GrepНетН/Д
Команды BashВыполнение оболочкиДаПостоянно для каталога проекта и команды
Модификация файловРедактирование/запись файловДаДо конца сессии

​
Инструменты, доступные для Claude

Claude Code имеет доступ к набору мощных инструментов, которые помогают ему понимать и изменять вашу кодовую базу:
ИнструментОписаниеТребуется разрешение
AgentЗапускает суб-агента для обработки сложных, многоэтапных задачНет
BashВыполняет команды оболочки в вашей средеДа
GlobНаходит файлы на основе сопоставления с шаблономНет
GrepИщет шаблоны в содержимом файловНет
LSПеречисляет файлы и каталогиНет
ReadЧитает содержимое файловНет
EditДелает целевые правки в конкретных файлахДа
WriteСоздает или перезаписывает файлыДа
NotebookEditИзменяет ячейки Jupyter notebookДа
NotebookReadЧитает и отображает содержимое Jupyter notebookНет
WebFetchПолучает содержимое с указанного URLДа
Правила разрешений можно настроить с помощью /allowed-tools или в настройках разрешений.

​
Защита от инъекций в промпты

Инъекция в промпты — это техника, при которой злоумышленник пытается переопределить или манипулировать инструкциями ИИ-ассистента, вставляя вредоносный текст. Claude Code включает несколько защитных мер против таких атак:
  • Система разрешений: Чувствительные операции требуют явного одобрения
  • Контекстно-зависимый анализ: Обнаруживает потенциально вредные инструкции, анализируя полный зап
  • Санитизация ввода: Предотвращает инъекцию команд путем обработки пользовательских вводов
  • Черный список команд: Блокирует рискованные команды, которые получают произвольный контент из веба, такие как curl и wget
Лучшие практики для работы с ненадежным содержимым:
  1. Просматривайте предлагаемые команды перед одобрением
  2. Избегайте прямой передачи ненадежного содержимого в Claude
  3. Проверяйте предлагаемые изменения в критических файлах
  4. Сообщайте о подозрительном поведении с помощью /bug
Хотя эти защиты значительно снижают риск, ни одна система не является полностью иммунной ко всем атакам. Всегда поддерживайте хорошие практики безопасности при работе с любым инструментом ИИ.

​
Настройка сетевого доступа

Claude Code требует доступа к:
  • api.anthropic.com
  • statsig.anthropic.com
  • sentry.io
Добавьте эти URL в белый список при использовании Claude Code в контейнеризированных средах.

​
Переменные окружения

Claude Code поддерживает следующие переменные окружения для управления своим поведением:
ПеременнаяНазначение
DISABLE_AUTOUPDATERУстановите в 1, чтобы отключить автоматическое обновление
DISABLE_BUG_COMMANDУстановите в 1, чтобы отключить команду /bug
DISABLE_COST_WARNINGSУстановите в 1, чтобы отключить предупреждения о стоимости
DISABLE_ERROR_REPORTINGУстановите в 1, чтобы отказаться от отчетов об ошибках Sentry
DISABLE_TELEMETRYУстановите в 1, чтобы отказаться от телеметрии Statsig (обратите внимание, что события Statsig не включают пользовательские данные, такие как код, пути к файлам или команды bash)
HTTP_PROXYУкажите HTTP-прокси-сервер для сетевых подключений
HTTPS_PROXYУкажите HTTPS-прокси-сервер для сетевых подключений
MCP_TIMEOUTТайм-аут в миллисекундах для запуска сервера MCP
MCP_TOOL_TIMEOUTТайм-аут в миллисекундах для выполнения инструмента MCP

​
Настройка Claude Code

Настройте Claude Code, выполнив claude config в вашем терминале или команду /config при использовании интерактивного REPL.

​
Параметры конфигурации

Claude Code поддерживает глобальную конфигурацию и конфигурацию на уровне проекта. Для управления вашими конфигурациями используйте следующие команды:
  • Список настроек: claude config list
  • Просмотр настройки: claude config get <key>
  • Изменение настройки: claude config set <key> <value>
  • Добавление в настройку (для списков): claude config add <key> <value>
  • Удаление из настройки (для списков): claude config remove <key> <value>
По умолчанию config изменяет конфигурацию вашего проекта. Для управления глобальной конфигурацией используйте флаг --global (или -g).

​
Глобальная конфигурация

Для установки глобальной конфигурации используйте claude config set -g <key> <value>:
КлючЗначениеОписание
autoUpdaterStatusdisabled или enabledВключение или отключение автообновления (по умолчанию: enabled)
envJSON (например, '{"FOO": "bar"}')Переменные окружения, которые будут применяться к каждой сессии
preferredNotifChanneliterm2, iterm2_with_bell, terminal_bell или notifications_disabledГде вы хотите получать уведомления (по умолчанию: iterm2)
themedark, light, light-daltonized или dark-daltonizedЦветовая тема
verbosetrue или falseПоказывать ли полный вывод bash и команд (по умолчанию: false)

​
Параметры разрешений автообновления

Когда Claude Code обнаруживает, что у него недостаточно прав для записи в глобальный каталог префикса npm (необходимо для автоматических обновлений), вы увидите предупреждение, указывающее на эту страницу документации. Для подробных решений проблем с автообновлением см. руководство по устранению неполадок.

​
Рекомендуется: Создайте новый префикс npm с правами записи для пользователя

# Сначала сохраните список существующих глобальных пакетов для последующей миграции
npm list -g --depth=0 > ~/npm-global-packages.txt

# Создайте каталог для ваших глобальных пакетов
mkdir -p ~/.npm-global

# Настройте npm для использования нового пути к каталогу
npm config set prefix ~/.npm-global

# Примечание: Замените ~/.bashrc на ~/.zshrc, ~/.profile или другой соответствующий файл для вашей оболочки
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# Примените новую настройку PATH
source ~/.bashrc

# Теперь переустановите Claude Code в новом месте
npm install -g @anthropic-ai/claude-code

# Опционально: Переустановите ваши предыдущие глобальные пакеты в новом месте
# Посмотрите ~/npm-global-packages.txt и установите пакеты, которые вы хотите сохранить
# npm install -g package1 package2 package3...
Почему мы рекомендуем этот вариант:
  • Избегает изменения разрешений системных каталогов
  • Создает чистое, выделенное место для ваших глобальных пакетов npm
  • Следует лучшим практикам безопасности
Поскольку Claude Code активно разрабатывается, мы рекомендуем настроить автообновления, используя рекомендуемый выше вариант.

​
Отключение автообновления

Если вы предпочитаете отключить автообновление вместо исправления разрешений, вы можете использовать: 
claude config set -g autoUpdaterStatus disabled

​
Конфигурация проекта

Управляйте конфигурацией проекта с помощью claude config set <key> <value> (без флага -g):
КлючЗначениеОписание
allowedToolsмассив инструментовКакие инструменты могут запускаться без ручного одобрения
ignorePatternsмассив строк globКакие файлы/каталоги игнорируются при использовании инструментов
Например: 
# Разрешить запуск npm test без одобрения
claude config add allowedTools "Bash(npm test)"

# Разрешить запуск npm test и любых его подкоманд без одобрения
claude config add allowedTools "Bash(npm test:*)"

# Указать Claude игнорировать node_modules
claude config add ignorePatterns node_modules
claude config add ignorePatterns "node_modules/**"
См. Разрешения для формата правил allowedTools.

​
Оптимизация настройки терминала

Claude Code работает лучше всего, когда ваш терминал правильно настроен. Следуйте этим рекомендациям для оптимизации вашего опыта. Поддерживаемые оболочки:
  • Bash
  • Zsh
  • Fish

​
Темы и внешний вид

Claude не может управлять темой вашего терминала. Это обрабатывается вашим терминальным приложением. Вы можете сопоставить тему Claude Code с вашим терминалом во время онбординга или в любое время через команду /config

​
Разрывы строк

У вас есть несколько вариантов для ввода разрывов строк в Claude Code:
  • Быстрый выход: Введите \ с последующим Enter для создания новой строки
  • Сочетание клавиш: Нажмите Option+Enter (Meta+Enter) с правильной конфигурацией
Для настройки Option+Enter в вашем терминале: Для Mac Terminal.app:
  1. Откройте Настройки → Профили → Клавиатура
  2. Отметьте “Использовать Option как клавишу Meta”
Для iTerm2 и терминала VSCode:
  1. Откройте Настройки → Профили → Клавиши
  2. В разделе Общие установите левую/правую клавишу Option на “Esc+”
Совет для пользователей iTerm2 и VSCode: Запустите /terminal-setup в Claude Code для автоматической настройки Shift+Enter как более интуитивной альтернативы.

​
Настройка уведомлений

Никогда не пропускайте момент, когда Claude завершает задачу, с правильной конфигурацией уведомлений:
Уведомления звуковым сигналом терминала
Включите звуковые оповещения при завершении задач: 
claude config set --global preferredNotifChannel terminal_bell
Для пользователей macOS: Не забудьте включить разрешения на уведомления в Системных настройках → Уведомления → [Ваше приложение терминала].
Системные уведомления iTerm 2
Для оповещений iTerm 2 при завершении задач:
  1. Откройте Настройки iTerm 2
  2. Перейдите в Профили → Терминал
  3. Включите “Silence bell” и “Send notification when idle”
  4. Установите предпочтительную задержку уведомлений
Обратите внимание, что эти уведомления специфичны для iTerm 2 и недоступны в стандартном терминале macOS.

​
Обработка больших вводов

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

​
Режим Vim

Claude Code поддерживает подмножество привязок клавиш Vim, которые можно включить с помощью /vim или настроить через /config. Поддерживаемое подмножество включает:
  • Переключение режимов: Esc (в NORMAL), i/I, a/A, o/O (в INSERT)
  • Навигация: h/j/k/l, w/e/b, 0/$/^, gg/G
  • Редактирование: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (повтор)

​
Эффективное управление затратами

Claude Code потребляет токены для каждого взаимодействия. Средняя стоимость составляет $6 на разработчика в день, при этом дневные затраты остаются ниже $12 для 90% пользователей.

​
Отслеживание ваших затрат

  • Используйте /cost для просмотра использования в текущей сессии
  • Пользователи Anthropic Console:
  • Пользователи тарифного плана Max: Использование включено в вашу подписку на тарифный план Max

​
Снижение использования токенов

  • Сжатие разговоров:
    • Claude использует автоматическое сжатие по умолчанию, когда контекст превышает 95% емкости
    • Переключение автоматического сжатия: Запустите /config и перейдите к “Auto-compact enabled”
    • Используйте /compact вручную, когда контекст становится большим
    • Добавьте пользовательские инструкции: /compact Focus on code samples and API usage
    • Настройте сжатие, добавив в CLAUDE.md: 
      # Summary instructions

When you are using compact, please focus on test output and code changes
  • Пишите конкретные запросы: Избегайте расплывчатых запросов, которые вызывают ненужное сканирование
  • Разбивайте сложные задачи: Разделяйте большие задачи на сфокусированные взаимодействия
  • Очищайте историю между задачами: Используйте /clear для сброса контекста
Затраты могут значительно варьироваться в зависимости от:
  • Размера анализируемой кодовой базы
  • Сложности запросов
  • Количества файлов, которые ищутся или изменяются
  • Длины истории разговора
  • Частоты сжатия разговоров
Для командных развертываний мы рекомендуем начинать с небольшой пилотной группы для установления шаблонов использования перед более широким развертыванием.

​
Конфигурация модели

По умолчанию Claude Code использует claude-opus-4-20250514. Вы можете переопределить это, используя следующие переменные окружения: 
# Anthropic API
ANTHROPIC_MODEL='claude-opus-4-20250514'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku-20241022'

# Amazon Bedrock
ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# Google Vertex AI
ANTHROPIC_MODEL='claude-opus-4@20250514'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku@20241022'
Вы также можете установить эти переменные, используя глобальную конфигурацию: 
# Настройка для Anthropic API
claude config set --global env '{"ANTHROPIC_MODEL": "claude-opus-4-20250514"}'

# Настройка для Bedrock
claude config set --global env '{"CLAUDE_CODE_USE_BEDROCK": "true", "ANTHROPIC_MODEL": "us.anthropic.claude-opus-4-20250514-v1:0"}'

# Настройка для Vertex AI
claude config set --global env '{"CLAUDE_CODE_USE_VERTEX": "true", "ANTHROPIC_MODEL": "claude-opus-4@20250514"}'
См. наш справочник по названиям моделей для всех доступных моделей у разных провайдеров.

​
Использование с API третьих сторон

Claude Code требует доступа как к моделям Claude Sonnet 3.7, так и Claude Haiku 3.5, независимо от того, какого провайдера API вы используете.

​
Подключение к Amazon Bedrock

CLAUDE_CODE_USE_BEDROCK=1
Если вы хотите получить доступ к Claude Code через прокси, вы можете использовать переменную окружения ANTHROPIC_BEDROCK_BASE_URL: 
ANTHROPIC_BEDROCK_BASE_URL='https://your-proxy-url'
Если у вас не включено кэширование промптов, также установите: 
DISABLE_PROMPT_CACHING=1
Требуются стандартные учетные данные AWS SDK (например, ~/.aws/credentials или соответствующие переменные окружения, такие как AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). Для настройки учетных данных AWS выполните: 
aws configure
Обратитесь в Amazon Bedrock для кэширования промптов для снижения затрат и повышения лимитов скорости.
Пользователям потребуется доступ как к моделям Claude Sonnet 3.7, так и Claude Haiku 3.5 в их учетной записи AWS. Если у вас есть роль доступа к модели, вам может потребоваться запросить доступ к этим моделям, если они еще не доступны. Доступ к Bedrock в каждом регионе необходим, потому что профили вывода требуют возможности кросс-региональной работы.

​
Подключение к Google Vertex AI

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=your-project-id
Если вы хотите получить доступ к Claude Code через прокси, вы можете использовать переменную окружения ANTHROPIC_VERTEX_BASE_URL: 
ANTHROPIC_VERTEX_BASE_URL='https://your-proxy-url'
Если у вас не включено кэширование промптов, также установите: 
DISABLE_PROMPT_CACHING=1
Claude Code на Vertex AI в настоящее время поддерживает только регион us-east5. Убедитесь, что в вашем проекте выделена квота именно в этом регионе.
Пользователям потребуется доступ как к моделям Claude Sonnet 3.7, так и Claude Haiku 3.5 в их проекте Vertex AI.
Требуются стандартные учетные данные GCP, настроенные через google-auth-library. Для настройки учетных данных GCP выполните: 
gcloud auth application-default login
Для наилучшего опыта обратитесь в Google для повышенных лимитов скорости.

​
Подключение через прокси

При использовании Claude Code с прокси LLM (например, LiteLLM), вы можете управлять поведением аутентификации с помощью следующих переменных окружения и конфигураций. Обратите внимание, что вы можете комбинировать их с настройками, специфичными для Bedrock и Vertex.

​
Переменные окружения

  • ANTHROPIC_AUTH_TOKEN: Пользовательское значение для заголовков Authorization и Proxy-Authorization (значение, которое вы здесь установите, будет иметь префикс Bearer )
  • ANTHROPIC_CUSTOM_HEADERS: Пользовательские заголовки, которые вы хотите добавить к запросу (в формате Name: Value)
  • HTTP_PROXY: Установите URL HTTP-прокси
  • HTTPS_PROXY: Установите URL HTTPS-прокси
Если вы предпочитаете настраивать через файл вместо переменных окружения, вы можете добавить любую из этих переменных в объект env в вашей глобальной конфигурации Claude (в ~/.claude.json).

​
Параметры глобальной конфигурации

  • apiKeyHelper: Пользовательский скрипт обол

​
Эталонная реализация контейнера разработки

Claude Code предоставляет конфигурацию контейнера разработки для команд, которым нужны согласованные, безопасные среды. Эта предварительно настроенная установка devcontainer работает без проблем с расширением VS Code Remote - Containers и аналогичными инструментами. Усиленные меры безопасности контейнера (изоляция и правила брандмауэра) позволяют запускать claude --dangerously-skip-permissions для обхода запросов разрешений для автономной работы. Мы включили эталонную реализацию, которую вы можете настроить для своих нужд.
Хотя devcontainer обеспечивает существенную защиту, ни одна система не полностью защищена от всех атак. Всегда поддерживайте хорошие практики безопасности и отслеживайте действия Claude.

​
Ключевые особенности

  • Node.js, готовый к производству: Построен на Node.js 20 с необходимыми зависимостями для разработки
  • Безопасность по дизайну: Пользовательский брандмауэр, ограничивающий сетевой доступ только необходимыми сервисами
  • Удобные для разработчика инструменты: Включает git, ZSH с улучшениями производительности, fzf и многое другое
  • Бесшовная интеграция с VS Code: Предварительно настроенные расширения и оптимизированные настройки
  • Сохранение сессии: Сохраняет историю команд и конфигурации между перезапусками контейнера
  • Работает везде: Совместим со средами разработки macOS, Windows и Linux

​
Начало работы за 4 шага

  1. Установите VS Code и расширение Remote - Containers
  2. Клонируйте репозиторий эталонной реализации Claude Code
  3. Откройте репозиторий в VS Code
  4. При появлении запроса нажмите “Reopen in Container” (или используйте палитру команд: Cmd+Shift+P → “Remote-Containers: Reopen in Container”)

​
Разбор конфигурации

Настройка devcontainer состоит из трех основных компонентов:
  • devcontainer.json: Управляет настройками контейнера, расширениями и монтированием томов
  • Dockerfile: Определяет образ контейнера и установленные инструменты
  • init-firewall.sh: Устанавливает правила сетевой безопасности

​
Функции безопасности

Контейнер реализует многоуровневый подход к безопасности с его конфигурацией брандмауэра:
  • Точный контроль доступа: Ограничивает исходящие соединения только доменами из белого списка (реестр npm, GitHub, API Anthropic и т.д.)
  • Политика запрета по умолчанию: Блокирует весь остальной внешний сетевой доступ
  • Проверка при запуске: Проверяет правила брандмауэра при инициализации контейнера
  • Изоляция: Создает безопасную среду разработки, отделенную от вашей основной системы

​
Варианты настройки

Конфигурация devcontainer разработана так, чтобы адаптироваться к вашим потребностям:
  • Добавляйте или удаляйте расширения VS Code в зависимости от вашего рабочего процесса
  • Изменяйте распределение ресурсов для различных аппаратных сред
  • Настраивайте разрешения сетевого доступа
  • Настраивайте конфигурации оболочки и инструменты разработчика

​
Следующие шаги

Руководства по Claude Code

Пошаговые руководства для общих задач

Устранение неполадок

Решения для общих проблем с Claude Code

Эталонная реализация

Клонируйте нашу эталонную реализацию контейнера разработки.

​
Лицензия и использование данных

Claude Code предоставляется как бета-версия исследовательского предпросмотра в соответствии с Коммерческими условиями обслуживания Anthropic.

​
Как мы используем ваши данные

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

​
Транскрипты отзывов

Если вы решите отправить нам отзыв о Claude Code, например, транскрипты вашего использования, Anthropic может использовать этот отзыв для отладки связанных проблем и улучшения функциональности Claude Code (например, для снижения риска возникновения подобных ошибок в будущем). Мы не будем обучать генеративные модели, используя эти отзывы.

​
Меры защиты конфиденциальности

Мы реализовали несколько мер защиты для защиты ваших данных, включая ограниченные периоды хранения конфиденциальной информации, ограниченный доступ к данным пользовательских сессий и четкие политики против использования отзывов для обучения моделей. Для получения полной информации, пожалуйста, ознакомьтесь с нашими Коммерческими условиями обслуживания и Политикой конфиденциальности.

​
Лицензия

© Anthropic PBC. Все права защищены. Использование регулируется Коммерческими условиями обслуживания Anthropic.