Обзор Claude Code

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 по умолчанию использует claude-3-7-sonnet-20250219.

​

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

Безопасность вашего кода имеет первостепенное значение. Архитектура Claude Code обеспечивает:

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

​

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

# Задавайте вопросы о вашей кодовой базе
claude
> how does our authentication system work?

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

# Исправляйте проблемы в нескольких файлах
claude "fix the type errors in the auth module"

​

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

Для новых пользователей мы рекомендуем:

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

​

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

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

​

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

> what does the payment processing system do?
> find where user permissions are checked
> explain how the caching layer works

​

Автоматизация операций 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 (3.7 Sonnet) использует расширенное мышление. Вы можете проактивно побуждать 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:*)" Edit

​

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

​

Команды CLI

Флаги CLI:

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

​

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

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

​

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

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

​

Доступные инструменты для Claude

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

​

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

Инъекция промптов - это техника, при которой атакующий пытается переопределить или манипулировать инструкциями ИИ-ассистента путем вставки вредоносного текста. 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 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 prefix (требуется для автоматических обновлений), вы увидите предупреждение, указывающее на эту страницу документации. Для подробных решений проблем с автообновлением см. руководство по устранению неполадок.

​

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

# Сначала сохраните список существующих глобальных пакетов для последующей миграции
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/**"

​

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

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. Включите “Отключить звуковой сигнал” и “Отправлять уведомление при бездействии”
4. Установите предпочтительную задержку уведомлений

Обратите внимание, что эти уведомления специфичны для iTerm 2 и недоступны в стандартном терминале macOS.

​

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

При работе с обширным кодом или длинными инструкциями:

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

Настроив эти параметры, вы создадите более плавный и эффективный рабочий процесс с Claude Code.

​

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

Claude Code потребляет токены для каждого взаимодействия. Типичное использование стоит от 5 до 10 долларов на разработчика в день, но может превышать 100 долларов в час при интенсивном использовании.

​

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

• Используйте /cost для просмотра текущего использования сессии
• Просматривайте сводку затрат при выходе
• Проверяйте историческое использование в Anthropic Console
• Установите Лимиты расходов

​

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

• Сжатие разговоров: Используйте /compact, когда контекст становится большим
• Пишите конкретные запросы: Избегайте расплывчатых запросов, которые вызывают ненужное сканирование
• Разбивайте сложные задачи: Разделяйте большие задачи на сфокусированные взаимодействия
• Очищайте историю между задачами: Используйте /clear для сброса контекста

Затраты могут значительно варьироваться в зависимости от:

• Размера анализируемой кодовой базы
• Сложности запросов
• Количества файлов для поиска или модификации
• Длины истории разговора
• Частоты сжатия разговоров

​

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

​

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

CLAUDE_CODE_USE_BEDROCK=1

Если вы хотите переопределить модель по умолчанию, вы можете передать переменную среды ANTHROPIC_MODEL (по умолчанию используется Claude 3.7 Sonnet):

ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

Если вы хотите получить доступ к 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

Если вы хотите переопределить модель по умолчанию, вы можете передать переменную среды ANTHROPIC_MODEL (по умолчанию используется Claude 3.7 Sonnet):

ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

Если вы хотите получить доступ к 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 предоставляет конфигурацию контейнера разработки для команд, которым нужны согласованные, безопасные среды. Эта предварительно настроенная установка 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. При появлении запроса нажмите “Reopening in Container” (или используйте Command Palette: 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.