Обзор Claude Code

Установите NodeJS 18+, затем выполните:

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

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

Ключевые возможности Claude Code включают:

• Редактирование файлов и исправление ошибок в вашей кодовой базе
• Ответы на вопросы об архитектуре и логике вашего кода
• Выполнение и исправление тестов, линтинга и других команд
• Поиск в истории git, разрешение конфликтов слияния, создание коммитов и PR

​

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

​

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

• Операционные системы: macOS 10.15+, Ubuntu 20.04+/Debian 10+ или Windows через WSL
• Аппаратное обеспечение: минимум 4 ГБ ОЗУ
• Программное обеспечение:
  • Node.js 18+
  • git 2.23+ (опционально)
  • GitHub или GitLab CLI для рабочих процессов с PR (опционально)
  • ripgrep (rg) для улучшенного поиска файлов (опционально)
• Сеть: Требуется подключение к интернету для аутентификации и обработки ИИ
• Местоположение: Доступно только в поддерживаемых странах

​

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

​

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

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 о вашей задаче и позволить ему собрать контекст из вашего проекта. Затем попросите его “подумать”, чтобы создать план.

​

Автоматизация рабочих процессов 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

Флаги CLI:

• --print (-p): Вывод ответа без интерактивного режима
• --json: Возврат вывода JSON в режиме --print, полезно для скриптов и автоматизации
• --verbose: Включение подробного логирования, показывает полный пошаговый вывод (полезно для отладки как в режиме печати, так и в интерактивном режиме)
• --dangerously-skip-permissions: Пропуск запросов разрешений

​

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

Управление поведением Claude в рамках сессии:

​

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

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

​

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

Claude Code предлагает три места хранения памяти, каждое из которых служит разным целям:

Все файлы памяти автоматически загружаются в контекст 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 использует многоуровневую систему разрешений для баланса между мощностью и безопасностью:

​

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

Claude Code имеет доступ к набору мощных инструментов, которые помогают ему понимать и изменять вашу кодовую базу:

Правила разрешений можно настроить с помощью /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 поддерживает следующие переменные окружения для управления своим поведением:

​

Настройка 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>:

​

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

Когда 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):

Например:

# Разрешить запуск 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:
  • Проверьте историческое использование в Anthropic Console (требуется роль Admin или Billing)
  • Установите лимиты расходов рабочего пространства для рабочего пространства Claude Code (требуется роль Admin)
• Пользователи тарифного плана 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 третьих сторон

​

Подключение к 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 для кэширования промптов для снижения затрат и повышения лимитов скорости.

​

Подключение к 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

Требуются стандартные учетные данные 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 для обхода запросов разрешений для автономной работы. Мы включили эталонную реализацию, которую вы можете настроить для своих нужд.

​

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

• 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 предоставляется как бета-версия исследовательского предпросмотра в соответствии с Коммерческими условиями обслуживания Anthropic.

​

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

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

​

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

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

​

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

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

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

​

Лицензия

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