Вот пошаговая, проверенная инструкция для macOS + Rider. Я собрал только то, что реально нужно, с проверками на каждом шаге и краткими пояснениями. # 1) Установите CLI Claude Code > Плагин Rider — это «мост». Сначала нужен сам CLI-инструмент `claude`. ([docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code/ide-integrations "Add Claude Code to your IDE - Anthropic")) ```bash # Без sudo, чтобы не ловить права на глобальные пакеты npm install -g @anthropic-ai/claude-code claude doctor ``` > Частая причина «command not found» — не тот регистр/опечатка. Команда строго в нижнем регистре: `claude` (не `Claude` и не `Cloude`). # 2) Аутентифицируйтесь Запустите в терминале IDE Rider: ```bash claude ``` Вас проведёт через одно из подключений: - через Anthropic Console (OAuth, нужен активный биллинг); - через подписку Claude Pro/Max (аккаунт на claude.ai); - для компаний — через Bedrock/Vertex AI. ([docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code/setup "Set up Claude Code - Anthropic")) # 3) Поставьте плагин «Claude Code [Beta]» в Rider 1. Rider → **Preferences** → **Plugins** → **Marketplace**. 2. Найдите **“Claude Code [Beta]”** (издатель Anthropic PBC) → **Install** → **Restart IDE**. ([JetBrains Marketplace](https://plugins.jetbrains.com/plugin/27310-claude-code-beta- "Claude Code [Beta] - IntelliJ IDEs Plugin | Marketplace")) 3. (Альтернатива) Иногда плагин ставится сам, если запустить `claude` во **встроенном** терминале IDE — но всё равно требуется полная перезагрузка IDE. ([docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code/ide-integrations "Add Claude Code to your IDE - Anthropic")) # 5) Настройки плагина Claude Code в Rider (по желанию) Rider → **Settings** → **Tools** → **Claude Code [Beta]**: - **Claude command** — можно явно указать путь, если нужно (например `~/.local/bin/claude`). - **ESC key**: если ESC не прерывает работу агента во встроенном терминале — снимите «Move focus to editor with Escape» в **Settings → Tools → Terminal**, либо удалите этот шорткат. ([docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code/ide-integrations "Add Claude Code to your IDE - Anthropic")) # 6) Подключение плагина к запущенному Claude Code Есть два способа, оба работают: **A. Из Rider (рекомендуется):** 1. Откройте проект в Rider. 2. Откройте встроенный терминал (внизу IDE), убедитесь, что Вы в корне проекта. 3. Запустите: ```bash claude ``` 4. Дождитесь, пока плагин «увидит» IDE (обычно автоматически). Затем можно вызывать окно/кнопку Claude Code и пользоваться фичами (диффы, контекст выделения, и т.п.). ([docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code/ide-integrations "Add Claude Code to your IDE - Anthropic")) **B. Из внешнего терминала:** - Запустите `claude` в терминале и выполните команду: ``` /ide ``` чтобы подключиться к текущей IDE. (Удобно, если привыкли стартовать агента вне IDE.) ([docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code/ide-integrations "Add Claude Code to your IDE - Anthropic")) # 7) Базовая конфигурация в самом Claude Code Внутри сессии `claude` выполните: ``` /config ``` - Включите **diff viewer** в режим `auto` — тогда изменения будут показываться в стандартном дифф-вьюере JetBrains, а не в терминале. - Остальные опции (модели, память, статус-строка) — по вкусу. ([docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code/ide-integrations "Add Claude Code to your IDE - Anthropic")) # 8) Клавиши и «как пользоваться» - **Cmd+Esc** — быстро открыть Claude Code из редактора (в JetBrains). - **Cmd+Opt+K** — вставка ссылок на файлы/диапазоны строк (`@File#L1-99`) в запрос. - Выделяете код → вызываете Claude → просите рефактор/объяснение → получаете дифф прямо в IDE. ([docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code/ide-integrations "Add Claude Code to your IDE - Anthropic")) # 9) Проверка, что всё работает ```bash which claude # путь виден в macOS и во встроенном терминале Rider claude doctor # всё должно быть OK ``` Если плагин «не подхватывается»: - Убедитесь, что запускаете `claude` **из корня проекта**. - Проверьте, что плагин включён и **полностью** перезапустите Rider (иногда 1–2 раза). ([docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code/ide-integrations "Add Claude Code to your IDE - Anthropic")) # 10) Частые проблемы и решения (коротко) - **`command not found`** — проверьте регистр (`claude`), PATH (`~/.local/bin`), запустите `claude doctor`. При желании переедьте на нативный инсталлер `curl … | bash`. ([docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code/troubleshooting "Troubleshooting - Anthropic")) - **Поиск/упоминания @file не работают** — установите `ripgrep`: `brew install ripgrep` и задайте `USE_BUILTIN_RIPGREP=0` в окружении. ([docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code/troubleshooting "Troubleshooting - Anthropic")) - **ESC не прерывает агента** — настройте Terminal в Rider как выше. ([docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code/ide-integrations "Add Claude Code to your IDE - Anthropic")) --- ## Шпаргалка команд ```bash # Установка (нативный инсталлер) curl -fsSL https://claude.ai/install.sh | bash # Или установка через npm npm install -g @anthropic-ai/claude-code # Проверки which claude claude doctor # Запуск в проекте cd /path/to/project claude # Подключение IDE из внешнего терминала /ide # Конфигурация /config # Сброс авторизации, если что-то пошло не так /logout ``` Если по ходу возникнет конкретная ошибка в Rider (например, плагин виден, но «не коннектится», или IDE не ловит горячие клавиши) — пришлите точный текст/скрин, я дам точный фикс под Вашу конфигурацию.