Обзор Claude Code
Узнайте о Claude Code, инструменте агентного программирования от Anthropic. В настоящее время находится в бета-версии как исследовательский предварительный релиз.
НЕ используйте 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 ГБ ОЗУ
- Программное обеспечение:
- Сеть: Требуется подключение к интернету для аутентификации и обработки ИИ
- Местоположение: Доступно только в поддерживаемых странах
Устранение неполадок при установке WSL
В настоящее время Claude Code не работает напрямую в Windows и требует WSL. Если у вас возникли проблемы в WSL:
-
Проблемы с определением ОС/платформы: Если вы получаете ошибку во время установки, WSL может использовать Windows
npm
. Попробуйте:- Выполните
npm config set os linux
перед установкой - Установите с помощью
npm install -g @anthropic-ai/claude-code --force --no-os-check
(НЕ используйтеsudo
)
- Выполните
-
Ошибки “Node not found”: Если вы видите
exec: node: not found
при запускеclaude
, ваша среда WSL может использовать Windows-установку Node.js. Вы можете проверить это с помощьюwhich npm
иwhich node
, которые должны указывать на Linux-пути, начинающиеся с/usr/
, а не с/mnt/c/
. Чтобы исправить это, попробуйте установить Node через менеджер пакетов вашего дистрибутива Linux или черезnvm
.
Установка и аутентификация
Установите Claude Code
Выполните в терминале: npm install -g @anthropic-ai/claude-code
НЕ используйте sudo npm install -g
, так как это может привести к проблемам с разрешениями и
рискам безопасности. Если вы столкнулись с ошибками разрешений, см. настройка Claude
Code для рекомендуемых решений.
Перейдите в ваш проект
cd your-project-directory
Запустите Claude Code
claude
для запускаЗавершите аутентификацию
Следуйте одноразовому процессу OAuth с вашей учетной записью Console. Вам понадобится активный биллинг на console.anthropic.com.
Основные функции и рабочие процессы
Claude Code работает непосредственно в вашем терминале, понимая контекст вашего проекта и выполняя реальные действия. Нет необходимости вручную добавлять файлы в контекст - Claude будет исследовать вашу кодовую базу по мере необходимости. Claude Code по умолчанию использует claude-3-7-sonnet-20250219
.
Безопасность и конфиденциальность по дизайну
Безопасность вашего кода имеет первостепенное значение. Архитектура Claude Code обеспечивает:
- Прямое API-соединение: Ваши запросы идут прямо к API Anthropic без промежуточных серверов
- Работает там, где работаете вы: Работает непосредственно в вашем терминале
- Понимает контекст: Поддерживает осведомленность о всей структуре вашего проекта
- Предпринимает действия: Выполняет реальные операции, такие как редактирование файлов и создание коммитов
От вопросов к решениям за секунды
Инициализируйте ваш проект
Для новых пользователей мы рекомендуем:
- Запустите Claude Code с помощью
claude
- Попробуйте простую команду, например
summarize this project
- Сгенерируйте руководство по проекту CLAUDE.md с помощью
/init
- Попросите Claude зафиксировать сгенерированный файл CLAUDE.md в вашем репозитории
Используйте Claude Code для общих задач
Claude Code работает непосредственно в вашем терминале, понимая контекст вашего проекта и выполняя реальные действия. Нет необходимости вручную добавлять файлы в контекст - Claude будет исследовать вашу кодовую базу по мере необходимости.
Понимание незнакомого кода
Автоматизация операций Git
Интеллектуальное редактирование кода
Тестирование и отладка кода
Поощрение глубокого мышления
Для сложных проблем явно попросите Claude думать глубже:
Claude Code покажет, когда Claude (3.7 Sonnet) использует расширенное мышление. Вы можете проактивно побуждать Claude “думать” или “думать глубоко” для задач, требующих более интенсивного планирования. Мы предлагаем сначала рассказать Claude о вашей задаче и позволить ему собрать контекст из вашего проекта. Затем попросите его “подумать”, чтобы создать план.
Claude будет думать больше в зависимости от используемых вами слов. Например, “думай усердно” вызовет более расширенное мышление, чем просто сказать “думай”.
Для получения дополнительных советов см. Советы по расширенному мышлению.
Автоматизация рабочих процессов CI и инфраструктуры
Claude Code поставляется с неинтерактивным режимом для безголового выполнения. Это особенно полезно для запуска Claude Code в неинтерактивных контекстах, таких как скрипты, пайплайны и Github Actions.
Используйте --print
(-p
) для запуска Claude в неинтерактивном режиме. В этом режиме вы можете установить переменную среды ANTHROPIC_API_KEY
для предоставления пользовательского API-ключа.
Неинтерактивный режим особенно полезен, когда вы предварительно настраиваете набор команд, которые Claude может использовать:
Управление Claude Code с помощью команд
Команды CLI
Команда | Описание | Пример |
---|---|---|
claude | Запуск интерактивного REPL | claude |
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
: Вывод ответа без интерактивного режима--verbose
: Включение подробного логирования--dangerously-skip-permissions
: Пропуск запросов разрешений (только в контейнерах Docker без интернета)
Слэш-команды
Управление поведением Claude в рамках сессии:
Команда | Назначение |
---|---|
/bug | Сообщить об ошибках (отправляет разговор в Anthropic) |
/clear | Очистить историю разговора |
/compact | Сжать разговор для экономии пространства контекста |
/config | Просмотр/изменение конфигурации |
/cost | Показать статистику использования токенов |
/doctor | Проверяет состояние вашей установки Claude Code |
/help | Получить справку по использованию |
/init | Инициализировать проект с руководством CLAUDE.md |
/login | Переключить учетные записи Anthropic |
/logout | Выйти из вашей учетной записи Anthropic |
/pr_comments | Просмотр комментариев к pull request |
/review | Запросить проверку кода |
/terminal-setup | Установить привязку клавиш Shift+Enter для новых строк (только iTerm2 и VSCode) |
/vim | Войти в режим vim для чередования режимов вставки и команд |
Управление разрешениями и безопасностью
Claude Code использует многоуровневую систему разрешений для баланса мощности и безопасности:
Тип инструмента | Пример | Требуется одобрение | Поведение “Да, больше не спрашивать” |
---|---|---|---|
Только чтение | Чтение файлов, LS, Grep | Нет | Н/П |
Команды Bash | Выполнение оболочки | Да | Постоянно для каждой директории проекта и команды |
Модификация файлов | Редактирование/запись файлов | Да | До конца сессии |
Доступные инструменты для Claude
Claude Code имеет доступ к набору мощных инструментов, которые помогают ему понимать и модифицировать вашу кодовую базу:
Инструмент | Описание | Требуется разрешение |
---|---|---|
AgentTool | Запускает под-агента для обработки сложных, многошаговых задач | Нет |
BashTool | Выполняет команды оболочки в вашей среде | Да |
GlobTool | Находит файлы на основе сопоставления шаблонов | Нет |
GrepTool | Ищет шаблоны в содержимом файлов | Нет |
LSTool | Перечисляет файлы и директории | Нет |
FileReadTool | Читает содержимое файлов | Нет |
FileEditTool | Делает целевые правки в конкретных файлах | Да |
FileWriteTool | Создает или перезаписывает файлы | Да |
NotebookReadTool | Читает и отображает содержимое Jupyter notebook | Нет |
NotebookEditTool | Модифицирует ячейки Jupyter notebook | Да |
Защита от инъекции промптов
Инъекция промптов - это техника, при которой атакующий пытается переопределить или манипулировать инструкциями ИИ-ассистента путем вставки вредоносного текста. Claude Code включает несколько защитных мер против этих атак:
- Система разрешений: Чувствительные операции требуют явного одобрения
- Контекстно-зависимый анализ: Обнаруживает потенциально вредные инструкции путем анализа полного запроса
- Санитизация ввода: Предотвращает инъекцию команд путем обработки пользовательского ввода
- Черный список команд: Блокирует рискованные команды, которые получают произвольный контент из веба, такие как
curl
иwget
Лучшие практики при работе с недоверенным контентом:
- Проверяйте предложенные команды перед одобрением
- Избегайте прямой передачи недоверенного контента в Claude
- Проверяйте предлагаемые изменения в критических файлах
- Сообщайте о подозрительном поведении с помощью
/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>
:
Ключ | Значение | Описание |
---|---|---|
autoUpdaterStatus | disabled или enabled | Включить или отключить автообновление (по умолчанию: enabled ) |
preferredNotifChannel | iterm2 , iterm2_with_bell , terminal_bell , или notifications_disabled | Где вы хотите получать уведомления (по умолчанию: iterm2 ) |
theme | dark , light , light-daltonized , или dark-daltonized | Цветовая тема |
verbose | true или false | Показывать ли полный вывод bash и команд (по умолчанию: false ) |
Параметры разрешений автообновления
Когда Claude Code обнаруживает, что у него недостаточно разрешений для записи в глобальную директорию npm prefix (требуется для автоматических обновлений), вы увидите предупреждение, указывающее на эту страницу документации. Для подробных решений проблем с автообновлением см. руководство по устранению неполадок.
Рекомендуется: Создать новый доступный для записи npm prefix
Почему мы рекомендуем этот вариант:
- Избегает модификации разрешений системной директории
- Создает чистое, выделенное место для ваших глобальных npm пакетов -Следует лучшим практикам безопасности
Поскольку Claude Code активно разрабатывается, мы рекомендуем настроить автообновления, используя рекомендуемый вариант выше.
Отключение автообновления
Если вы предпочитаете отключить автообновление вместо исправления разрешений, вы можете использовать:
Конфигурация проекта
Управляйте конфигурацией проекта с помощью claude config set <key> <value>
(без флага -g
):
Ключ | Значение | Описание |
---|---|---|
allowedTools | массив инструментов | Какие инструменты могут запускаться без ручного одобрения |
ignorePatterns | массив строк glob | Какие файлы/директории игнорируются при использовании инструментов |
Например:
Оптимизация настройки терминала
Claude Code работает лучше всего, когда ваш терминал правильно настроен. Следуйте этим рекомендациям для оптимизации вашего опыта.
Поддерживаемые оболочки:
- Bash
- Zsh
- Fish
Темы и внешний вид
Claude не может управлять темой вашего терминала. Это обрабатывается вашим терминальным приложением. Вы можете сопоставить тему Claude Code с вашим терминалом во время начальной настройки или в любое время через команду /config
Разрывы строк
У вас есть несколько вариантов для ввода разрывов строк в Claude Code:
- Быстрый выход: Введите
\
с последующим Enter для создания новой строки - Сочетание клавиш: Нажмите Option+Enter (Meta+Enter) с правильной конфигурацией
Для настройки Option+Enter в вашем терминале:
Для Mac Terminal.app:
- Откройте Настройки → Профили → Клавиатура
- Отметьте “Использовать Option как клавишу Meta”
Для iTerm2 и терминала VSCode:
- Откройте Настройки → Профили → Клавиши
- В разделе Общие установите левую/правую клавишу Option на “Esc+”
Совет для пользователей iTerm2 и VSCode: Запустите /terminal-setup
в Claude Code для автоматической настройки Shift+Enter как более интуитивной альтернативы.
Настройка уведомлений
Никогда не пропускайте момент, когда Claude завершает задачу, с правильной настройкой уведомлений:
Уведомления звуковым сигналом терминала
Включите звуковые оповещения при завершении задач:
Для пользователей macOS: Не забудьте включить разрешения на уведомления в Системных настройках → Уведомления → [Ваше терминальное приложение].
Системные уведомления iTerm 2
Для оповещений iTerm 2 при завершении задач:
- Откройте Настройки iTerm 2
- Перейдите в Профили → Терминал
- Включите “Отключить звуковой сигнал” и “Отправлять уведомление при бездействии”
- Установите предпочтительную задержку уведомлений
Обратите внимание, что эти уведомления специфичны для iTerm 2 и недоступны в стандартном терминале macOS.
Обработка больших входных данных
При работе с обширным кодом или длинными инструкциями:
- Избегайте прямой вставки: Claude Code может испытывать трудности с очень длинным вставленным содержимым
- Используйте файловые рабочие процессы: Записывайте содержимое в файл и просите Claude прочитать его
- Учитывайте ограничения VS Code: Терминал VS Code особенно склонен к усечению длинных вставок
Настроив эти параметры, вы создадите более плавный и эффективный рабочий процесс с Claude Code.
Эффективное управление затратами
Claude Code потребляет токены для каждого взаимодействия. Типичное использование стоит от 5 до 10 долларов на разработчика в день, но может превышать 100 долларов в час при интенсивном использовании.
Отслеживание затрат
- Используйте
/cost
для просмотра текущего использования сессии - Просматривайте сводку затрат при выходе
- Проверяйте историческое использование в Anthropic Console
- Установите Лимиты расходов
Снижение использования токенов
- Сжатие разговоров: Используйте
/compact
, когда контекст становится большим - Пишите конкретные запросы: Избегайте расплывчатых запросов, которые вызывают ненужное сканирование
- Разбивайте сложные задачи: Разделяйте большие задачи на сфокусированные взаимодействия
- Очищайте историю между задачами: Используйте
/clear
для сброса контекста
Затраты могут значительно варьироваться в зависимости от:
- Размера анализируемой кодовой базы
- Сложности запросов
- Количества файлов для поиска или модификации
- Длины истории разговора
- Частоты сжатия разговоров
Для развертывания в команде мы рекомендуем начать с небольшой пилотной группы для установления паттернов использования перед более широким развертыванием.
Использование с API третьих сторон
Claude Code требует доступ как к моделям Claude 3.7 Sonnet, так и Claude 3.5 Haiku, независимо от того, какого провайдера API вы используете.
Подключение к Amazon Bedrock
Если вы хотите переопределить модель по умолчанию, вы можете передать переменную среды ANTHROPIC_MODEL
(по умолчанию используется Claude 3.7 Sonnet):
Если вы хотите получить доступ к Claude Code через прокси, вы можете использовать переменную среды ANTHROPIC_BEDROCK_BASE_URL
:
Если у вас не включено кэширование промптов, также установите:
Требуются стандартные учетные данные AWS SDK (например, ~/.aws/credentials
или соответствующие переменные среды, такие как AWS_ACCESS_KEY_ID
, AWS_SECRET_ACCESS_KEY
). Для настройки учетных данных AWS выполните:
Свяжитесь с Amazon Bedrock для кэширования промптов для снижения затрат и повышения лимитов скорости.
Пользователям потребуется доступ как к моделям Claude 3.7 Sonnet, так и Claude 3.5 Haiku в их учетной записи AWS. Если у вас есть роль доступа к модели, вам может потребоваться запросить доступ к этим моделям, если они еще не доступны.
Подключение к Google Vertex AI
Если вы хотите переопределить модель по умолчанию, вы можете передать переменную среды ANTHROPIC_MODEL
(по умолчанию используется Claude 3.7 Sonnet):
Если вы хотите получить доступ к Claude Code через прокси, вы можете использовать переменную среды ANTHROPIC_VERTEX_BASE_URL
:
Если у вас не включено кэширование промптов, также установите:
Claude Code на Vertex AI в настоящее время поддерживает только регион us-east5
. Убедитесь,
что ваш проект имеет выделенную квоту в этом конкретном регионе.
Пользователям потребуется доступ как к моделям Claude 3.7 Sonnet, так и Claude 3.5 Haiku в их проекте Vertex AI.
Требуются стандартные учетные данные GCP, настроенные через google-auth-library. Для настройки учетных данных GCP выполните:
Для наилучшего опыта свяжитесь с Google для повышенных лимитов скорости.
Эталонная реализация контейнера разработки
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 шага
- Установите VS Code и расширение Remote - Containers
- Клонируйте репозиторий эталонной реализации Claude Code
- Откройте репозиторий в VS Code
- При появлении запроса нажмите “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
Пошаговые руководства для общих задач
Устранение неполадок
Решения для общих проблем с Claude Code
Эталонная реализация
Клонируйте нашу эталонную реализацию контейнера разработки.
Лицензия и использование данных
Claude Code предоставляется как бета-версия исследовательского предварительного релиза в соответствии с Коммерческими условиями использования Anthropic.
Как мы используем ваши данные
Мы стремимся быть полностью прозрачными в том, как мы используем ваши данные. Мы можем использовать отзывы для улучшения наших продуктов и услуг, но мы не будем обучать генеративные модели, используя ваши отзывы из Claude Code. Учитывая их потенциально конфиденциальный характер, мы храним транскрипты отзывов пользователей только в течение 30 дней.
Транскрипты отзывов
Если вы решите отправить нам отзыв о Claude Code, например, транскрипты вашего использования, Anthropic может использовать этот отзыв для отладки связанных проблем и улучшения функциональности Claude Code (например, для снижения риска возникновения подобных ошибок в будущем). Мы не будем обучать генеративные модели, используя эти отзывы.
Меры защиты конфиденциальности
Мы внедрили несколько мер защиты для защиты ваших данных, включая ограниченные периоды хранения конфиденциальной информации, ограниченный доступ к данным пользовательских сессий и четкие политики против использования отзывов для обучения моделей.
Для получения полной информации, пожалуйста, ознакомьтесь с нашими Коммерческими условиями использования и Политикой конфиденциальности.
Лицензия
© Anthropic PBC. Все права защищены. Использование регулируется Коммерческими условиями использования Anthropic.
Was this page helpful?