Часто задаваемые вопросы 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: агент терминала, который читает ваш репозиторий, редактирует файлы, запускает команды.
​Десктоп / 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 для переключения режимов:
• default · спрашивает перед рискованными правками или командами
• accept-edits · правки файлов проходят; всё ещё спрашивает перед запуском команд
• plan · только для чтения; предлагает план и ждёт одобрения
• auto (если включено вашей организацией) · автоматически одобряет с проверкой безопасности в фоне

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

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

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

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

2.4 Что входит в CLAUDE.md?

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

Справка: Memory and CLAUDE.md

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

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

Справка: Best practices

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

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

Справка: Common workflows

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

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

Справка: Working with images

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

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

2.9 Восстановите предыдущую сессию

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

Справка: Common workflows: resume

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

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

Справка: Model configuration

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

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

Справка: Extended thinking

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 setup

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

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

Справка: Hooks guide

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

Поместите файл markdown в .claude/commands/. Имя файла становится командой: .claude/commands/ship.md становится /ship. Простой английский, без специального синтаксиса. Самый простой способ: попросите Claude написать это для вас.

Справка: Slash commands

3.5 Навыки против команд слэша

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

Справка: Skills

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

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

Справка: Subagents

3.7 Запуск без интерфейса (CI / скрипты)

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

Справка: Unix-style usage

3.8 Отменить то, что он сделал

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

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

3.9 Поделитесь своей конфигурацией с командой

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

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

Вопрос

Ответ

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

Claude Code использует ripgrep. Если его нет, поиск работает хуже. Установите его (brew install ripgrep или apt install ripgrep) и установите USE_BUILTIN_RIPGREP=0, чтобы использовать системную копию.

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

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 работает иначе

• Серверы MCP, требующие OAuth, не могут запрашивать в режиме без интерфейса
• Интерактивные одобрения не переносятся
Для режима без интерфейса/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 Что может делать режим "accept-edits" без моего разрешения?

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

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

Ресурс

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

/help

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

/bug

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

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

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

Канал #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