Обзор Claude Code

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

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

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

​

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

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

​

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

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

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

​

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

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

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

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

​

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

​

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

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

​

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

​

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

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

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

​

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

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

​

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

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

​

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

> зафиксируй мои изменения
> создай pr
> какой коммит добавил тесты для markdown в декабре?
> выполни rebase на main и разреши конфликты слияния

​

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

> добавь валидацию ввода в форму регистрации
> рефакторинг логгера для использования нового API
> исправь состояние гонки в очереди worker'а

​

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

> запусти тесты для модуля аутентификации и исправь ошибки
> найди и исправь уязвимости безопасности
> объясни, почему этот тест не проходит

​

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

Для сложных проблем явно попросите Claude думать глубже:

> подумай о том, как нам следует спроектировать новый платежный сервис
> тщательно подумай о граничных случаях в нашем потоке аутентификации

​

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

Поддерживаемые оболочки:

• 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='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

Если у вас не включено кэширование промптов, также установите:

DISABLE_PROMPT_CACHING=1

Требуются стандартные учетные данные AWS SDK (например, ~/.aws/credentials или соответствующие переменные среды, такие как AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). Свяжитесь с Amazon Bedrock для кэширования промптов для снижения затрат и повышения лимитов запросов.

​

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

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

Требуются стандартные учетные данные GCP, настроенные через google-auth-library. Для наилучшего опыта свяжитесь с 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.