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

Вопрос

Ответ

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

Самый простой способ: загрузите Claude Desktop, войдите с вашим планом и откройте вкладку «Code». Claude Code встроен, поэтому больше ничего устанавливать не нужно.

Терминал:

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 в мой план?

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

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

1.6 Claude Code или чат в Claude?

Claude Code: агент кодирования, который читает ваш репозиторий, редактирует файлы и выполняет команды. Это вкладка «Code» в Claude Desktop, а также работает в вашем терминале или IDE.
​Чат в Claude (веб, Claude Desktop или мобильное приложение): чат для разговоров и разовых вопросов.
Одинаковые модели под капотом, разные формы инструмента.

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

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 Укажите конкретный файл без копирования

Введите @ и путь (с автодополнением). Указанный файл будет прочитан перед ответом 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 ждёт вас). Первый популярный хук: хук Notification, который отправляет уведомление на рабочий стол, когда 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 по отдельным аспектам или одновременное создание конкурирующих реализаций. Основной сеанс агрегирует результаты.

Справка: Subagents

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 читает только файлы, необходимые для задачи; он не сканирует весь репозиторий. Чтобы жёстко заблокировать определённые файлы, добавьте правило Read deny в .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