Claude Code: часто задаваемые вопросы

Вопрос

Ответ

1.1 Как его установить?

macOS/Linux: curl -fsSL https://claude.ai/install.sh | bash
​Windows PowerShell: irm https://claude.ai/install.ps1 | iex
​Homebrew: brew install --cask claude-code
​WinGet: winget install Anthropic.ClaudeCode
Затем запустите claude из любого репозитория.

Справка: Быстрый старт

1.2 Установлено, но ошибка "claude: command not found"

Встроенный установщик размещает бинарный файл в ~/.local/bin/claude (Windows: %USERPROFILE%\.local\bin). Добавьте этот каталог в PATH, например export PATH="$PATH:$HOME/.local/bin" в ~/.zshrc или ~/.bashrc, затем перезагрузите терминал.

Справка: Устранение неполадок: PATH

1.3 Вход открывает браузер на другой машине / я подключен через SSH

Нажмите c на экране входа, чтобы скопировать URL аутентификации. Откройте его в локальном браузере, затем вставьте код обратно в терминал.

Справка: Устранение неполадок: аутентификация

1.4 Ошибки аутентификации сразу после входа, но у меня есть доступ

400 "organization disabled": переменная окружения ANTHROPIC_API_KEY переопределяет ваш вход. Удалите её, удалите из профиля оболочки, перезагрузитесь. Запустите /status, чтобы проверить, какая аутентификация активна.
​403 Forbidden: ваш администратор ещё не включил Claude Code для вашего рабочего пространства, или корпоративный прокси мешает.

Справка: Устранение неполадок: аутентификация

1.5 Входит ли Claude Code в мой план?

Да. Он включен в Team и Enterprise места и в Console (API) доступ. Войдите с рабочей учетной записью; SSO обрабатывается автоматически. Ошибка 403 после входа обычно означает, что администратор ещё должен включить её для рабочего пространства.

Справка: Аутентификация

1.6 Claude Code vs. десктопное приложение vs. claude.ai?

Claude Code: агент терминала, который читает ваш репозиторий, редактирует файлы, запускает команды.
​Desktop / claude.ai: интерфейсы чата для разговоров и разовых вопросов.
Одно семейство моделей, разные формы инструмента.

Справка: Обзор

1.7 Работает ли это в моей IDE?

Да. Расширения доступны для VS Code и JetBrains IDE (IntelliJ, PyCharm и т.д.). Те же функции, встроенные в редактор вместо отдельного терминала.

Справка: VS Code · JetBrains

1.8 Чем это отличается от автодополнения Copilot/Cursor?

Автодополнение предлагает следующие несколько строк. Claude Code — это агент: дайте ему задачу ("исправить падающие тесты") и он читает файлы, запускает команды и делает многофайловые правки до завершения. Меньше "закончи мою фразу", больше "вот проблема, иди работай".

Справка: Обзор

1.9 С чего начать?

Укажите на скучную, но не сложную ошибку, которую вы откладывали. Пример: "тест в [файл] нестабилен, выясни почему." Позвольте ему читать код вместо того, чтобы вы объясняли код.

Справка: Типичные варианты использования

1.10 Как его обновить?

Встроенные установки автоматически обновляются в фоне. Чтобы принудительно обновить сейчас, запустите claude update.
Homebrew/WinGet не обновляются автоматически: периодически запускайте brew upgrade claude-code или winget upgrade Anthropic.ClaudeCode.

Справка: Настройка: обновления

Вопрос

Ответ

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

Одобрения действуют только в текущем сеансе по умолчанию. Чтобы сделать их постоянными:
• Выберите "всегда разрешать" в подсказке
• Добавьте шаблон в permissions.allow в .claude/settings.json
• Или запустите /permissions для интерактивного управления

Справка: Разрешения

2.2 Режимы разрешений и как переключаться

Нажмите Shift+Tab для переключения режимов:

Справка: Режимы разрешений

2.3 Что такое /init и когда его запускать?

Запустите один раз в начале в любом репозитории, с которым вы будете работать несколько раз. Он сканирует проект и записывает CLAUDE.md с командами сборки, архитектурой и соглашениями. Каждый следующий сеанс загружает его автоматически, поэтому Claude начинает с контекста.

Справка: Память и CLAUDE.md

2.4 Что писать в CLAUDE.md?

Вещи, которые инструменты не могут обеспечить и которые новый коллега ошибёт в первый день: «развёртывайте из release, а не из main», «все ID — строки», «никогда не обращайтесь к БД напрямую из обработчика маршрута». Держите это в пределах двух экранов; более длинное будет пропущено.

Справка: Память и CLAUDE.md

2.5 Claude не следует моему CLAUDE.md

• Слишком длинный или расплывчатый: сократите до правил, которые действительно важны
• Спрятан в прозе: поместите жёсткие правила в начало, используйте повелительное наклонение («Никогда не X. Всегда Y.»)

Справка: Лучшие практики

2.6 Укажите на конкретный файл без его вставки

Введите @, затем путь (автодополнение по Tab). Упомянутый файл читается перед ответом Claude.

Справка: Типичные рабочие процессы

2.7 Вставьте скриншот в подсказку

Перетащите изображение в терминал или нажмите Ctrl+V. На Mac это Ctrl, а не Cmd (Cmd+V вставляет текст). Работает для диалогов ошибок, макетов UI, фотографий доски.

Справка: Работа с изображениями

2.8 Скопируйте ответ Claude из терминала

/copy помещает последний ответ в буфер обмена. /export записывает весь разговор в файл.

2.9 Вернитесь к предыдущему сеансу

claude --continue возобновляет самый последний. claude --resume открывает список для выбора. Сеансы хранятся локально в каталоге проекта.

Справка: Типичные рабочие процессы: возобновление

2.10 Переключение моделей

/model открывает выбор. Установите значение по умолчанию в .claude/settings.json, если вы хотите одну и ту же модель в каждом сеансе.

Справка: Конфигурация модели

2.11 Расширенное мышление

Включено по умолчанию. Само рассуждение скрыто в обычном представлении; нажмите Ctrl+O, чтобы переключиться на подробную стенограмму, если хотите её прочитать. Используйте /effort для регулировки глубины вверх или вниз. Стоит дополнительной задержки для сложной отладки или архитектурных решений.

Справка: Расширенное мышление

2.12 Остановите его в середине задачи

Нажмите Ctrl+C, чтобы отменить текущее поколение, затем скажите ему, что делать вместо этого. Нет необходимости начинать разговор заново.

Вопрос

Ответ

3.1 Что такое MCP?

MCP подключает Claude Code к вашим внешним инструментам: GitHub, Linear, Slack, вашей базе данных, вашему стеку наблюдаемости. Одна конфигурация .mcp.json и Claude может читать ваши проблемы, запрашивать ваши данные и работать с теми же инструментами, что и вы. Первый обычный разъём: ваш трекер проблем.

Справка: MCP

3.2 Подключите свой первый сервер MCP

• Добавьте .mcp.json в корень проекта или используйте claude mcp add
• Каждая запись называет пакет сервера плюс любые переменные окружения (обычно токен аутентификации)
• Перезагрузите Claude Code и запустите /mcp, чтобы подтвердить подключение

Справка: Настройка MCP

3.3 Для чего нужны хуки?

Скрипты оболочки, которые срабатывают на события (перед запуском инструмента, после редактирования файла, когда Claude ждёт вас). Первый обычный хук: хук Уведомления, который отправляет уведомление на рабочий стол, когда Claude нуждается в вводе. Тот же механизм может запустить ваш линтер после каждого редактирования, опубликовать в Slack или заблокировать редактирование защищённых путей.

Справка: Руководство по хукам

3.4 Создайте переиспользуемую подсказку / навык

Создайте .claude/skills/ship/SKILL.md и имя папки становится командой: /ship. Простой английский, без специального синтаксиса. Самый простой способ: попросите Claude написать это для вас. (Устаревший путь .claude/commands/ship.md всё ещё работает.)

Справка: Навыки

3.5 Навыки против устаревших команд

Один и тот же механизм; команды были объединены в навыки. .claude/commands/foo.md и .claude/skills/foo/SKILL.md оба создают /foo. Форма навыка предпочтительна и даёт вам папку для вспомогательных файлов (справочные документы, шаблоны, вспомогательные скрипты).

Справка: Навыки

3.6 Для чего хороши подагенты?

Параллельная работа: поиск в разных частях кодовой базы, проверка diff по отдельным измерениям или одновременное создание конкурирующих реализаций. Основной сеанс объединяет результаты.

Справка: Подагенты

3.7 Запуск в неинтерактивном режиме (CI / скрипты)

claude -p "ваш запрос" выполняется один раз и выводит результат. Подходит для CI хуков, проверок перед коммитом или передачи данных в другие инструменты. Аутентификация через вашу активную сессию или ANTHROPIC_API_KEY.

Справка: Использование в стиле Unix

3.8 Отменить выполненные действия

/rewind откатывает к более ранней контрольной точке. Контрольные точки создаются автоматически при каждом отправленном запросе. Для уже закоммиченных изменений используйте обычную команду git revert.

Справка: Контрольные точки

3.9 Поделитесь настройками с командой

Добавьте .claude/ в репозиторий (CLAUDE.md, команды, конфигурация MCP). Каждый, кто клонирует репозиторий, получит ту же настройку автоматически. Навыки также можно упаковать в виде плагина, который команды устанавливают через /plugin.

Справка: Плагины

Вопрос

Ответ

4.1 Не удаётся найти файлы / поиск ничего не возвращает

Claude Code поставляется с встроенной копией ripgrep, поэтому вам не нужно его устанавливать. Встроенный бинарный файл может не работать на системах Alpine/musl; в этом случае установите системную копию (apk add ripgrep) и установите USE_BUILTIN_RIPGREP=0, чтобы Claude использовал её вместо этого.

Справка: Устранение неполадок: поиск

4.2 Копирование/вставка и прокрутка не работают через SSH или в tmux

Интерфейс терминала захватывает события мыши. Удерживайте Shift при выделении, чтобы обойти это, или настройте tmux на передачу событий мыши. /copy и /export полностью решают проблему.

4.3 Медленная работа на WSL

Чтение файлов Windows через /mnt/c/ — известное узкое место. Переместите репозиторий в файловую систему WSL (~/ вместо /mnt/c/...). Разница в скорости значительна.

Справка: Устранение неполадок: WSL

4.4 Вставка изображений не работает на Mac

Используйте Ctrl+V, а не Cmd+V. Cmd+V вставляет текст; Ctrl+V — это способ вставки изображения из буфера обмена.

4.5 Правило разрешения с подстановочным знаком не совпадает

Создавайте правила постепенно: сначала одобрите команды в интерактивном режиме, проверьте, что было записано в настройки, затем обобщите.

Справка: Шаблоны разрешений

4.6 Неинтерактивный режим -p ведёт себя иначе

Для неинтерактивных/CI запусков предпочитайте аутентификацию по API-ключу и серверы MCP, настроенные с токенами переменных окружения.

4.7 Контекст закончился во время выполнения задачи

/compact суммирует предыдущий разговор, чтобы освободить место. /clear начинает заново, сохраняя загруженные CLAUDE.md и настройки. Для длительных задач разбейте их на этапы с /clear между фазами.

Справка: Управление контекстом

Вопрос

Ответ

5.1 Anthropic обучает модели на моём коде?

Нет. В соответствии с условиями Team/Enterprise вашей организации ваш код и разговоры не используются для обучения моделей.

Справка: Использование данных

5.2 Куда на самом деле отправляется мой код?

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

Справка: Использование данных

5.3 Может ли кто-нибудь ещё видеть мои разговоры?

Нет. Сессии хранятся локально на вашей машине, по каталогам проектов, и не передаются коллегам или не видны ни в каких панелях управления. Используйте /export, если вы хотите поделиться разговором.

Справка: Использование данных

5.4 Как я могу исключить секреты и файлы .env из разговора?

Claude читает только файлы, необходимые для задачи; он не сканирует весь репозиторий. Чтобы жёстко заблокировать определённые файлы, добавьте правило запрета на чтение в .claude/settings.json (например "Read(.env*)"). Заблокированные файлы не могут быть прочитаны, даже если вы случайно их запросите.

Справка: Разрешения

5.5 Что может делать режим "acceptEdits" без моего разрешения?

Редактирование файлов происходит без запроса. Он всё ещё запрашивает разрешение перед запуском команд оболочки, выполнением сетевых вызовов или изменением чего-либо вне вашего рабочего каталога. Для более строгого контроля оставайтесь в режиме по умолчанию.

Справка: Разрешения

Ресурс

Для чего это нужно

/help

Встроенная команда, которая показывает, что доступно в вашей сессии

/feedback

Сообщить об ошибке из терминала (псевдоним для /bug)

Полная документация

Всё здесь, подробно

Канал #claude-code вашей команды

Здесь уместны как небольшие успехи, так и странные ошибки

Страница

Ссылка

Быстрый старт

code.claude.com/docs/en/quickstart

Устранение неполадок

code.claude.com/docs/en/troubleshooting

Разрешения

code.claude.com/docs/en/permissions

Память и CLAUDE.md

code.claude.com/docs/en/memory

MCP

code.claude.com/docs/en/mcp

Использование данных

code.claude.com/docs/en/data-usage