Установите 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 your-project-directory
3

Запустите Claude Code

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

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

Следуйте одноразовому процессу OAuth с вашей учетной записью Console. Вам потребуется активная тарификация на console.anthropic.com.


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

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

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

Безопасность вашего кода имеет первостепенное значение. Архитектура 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

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

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

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

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

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

Для сложных проблем явно попросите 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 может использовать:

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

КомандаОписаниеПример
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: Включение подробного логирования, показывает полный пошаговый вывод (полезно для отладки в обоих режимах - print и интерактивном)
  • --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 для чередования режимов вставки и команд

[Продолжение перевода следует в следующем сообщении из-за ограничений длины]