# Интеграция с JetBrains IDE

> **Последняя проверка**: 2026-09-18 · 📄 По официальной документации (плагин Claude Code для JetBrains 0.1.14-beta (Marketplace; нужна IDE ≥2024.2))

## Кратко

| Параметр | Описание |
|---|---|
| Доступные модели | Claude ✅ (плагин Claude Code, общий конфиг с CLI) · GPT / китайские ⚠️ см. раздел про AI Assistant · Gemini ❌ |
| Протокол и Base URL | Anthropic: `https://api.qcode.cc/api` (в окружении / settings.json кли `claude`) |
| Где настраивается | Settings → Tools → Claude Code [Beta]; внутри — общий `~/.claude/` |
| Официальная документация | [code.claude.com/docs/en/jetbrains](https://code.claude.com/docs/en/jetbrains) |

Claude Code предоставляет официальный плагин для JetBrains. Документация называет шесть IDE (в том числе Android Studio, которой нужен Ladybug 2024.2.1 или новее; отдельно JetBrains MPS требует 2024.3+), а в списке совместимости Marketplace есть RubyMine, CLion, Rider, DataGrip и другие IDE на платформе IntelliJ — так что «годится любая IDE на IntelliJ» мы не обещаем: проверьте страницу плагина внутри своей IDE перед установкой. В этом руководстве показано, как установить плагин и направить его на шлюз QCode, чтобы вызывать флагманские модели вроде Claude Opus 5 и Sonnet 5 с меньшими затратами.

Плагин использует ту же конфигурацию, что и версия для командной строки: если ваш CLI `claude` может подключиться к QCode, плагин для IDE тоже будет работать.

## Предварительные требования

1. **Claude Code CLI установлен и работает корректно** (проверяйте `claude --version`, не сверяйте с устаревшей цифрой на странице)
   - Выполните установку по [инструкции](/docs/getting-started/installation)
   - Настройте [переменные окружения](/docs/getting-started/environment) для QCode API
   - Выполните `claude --version` в терминале, чтобы убедиться в работоспособности

2. **JetBrains IDE версии 2024.2 или выше** (в записи Marketplace для плагина нижняя граница — сборка `242.0`, то есть 2024.2; на 2024.1 плагин показан как несовместимый)

3. **API-ключ QCode** (начинается с `cr_`) — один и тот же ключ работает для всех конечных точек

## Установка

### Шаг 1: Установка плагина Claude Code

1. Откройте JetBrains IDE

2. Перейдите в **Settings / Preferences** → **Plugins** → **Marketplace**

3. Найдите **Claude Code [Beta]** — это и есть официальное название в Marketplace (издатель **Anthropic PBC**, xmlId `com.anthropic.code.plugin`). ⚠️ Если искать просто "Claude Code", первыми выпадут несколько сторонних одноимённых плагинов; ставьте тот, что издан Anthropic PBC

4. Нажмите **Install**

5. Перезапустите IDE

> Подсказка: Если из вашей сети нет прямого доступа к JetBrains Marketplace, скачайте пакет `.zip` со страницы плагина и установите его офлайн через **Plugins** → значок шестерёнки → **Install Plugin from Disk...**. Подробности смотрите в официальной документации JetBrains.

### Шаг 2: Настройка доступа к QCode

Плагин повторно использует конфигурацию Claude Code CLI. Основа — две переменные окружения:

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_api_key"
```

> **Пользователям в материковом Китае**: замена `api.qcode.cc` на `asia.qcode.cc` обычно даёт более высокую скорость и стабильность:
>
> ```bash
> export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"
> ```
>
> Четыре домена `api` / `asia` / `us` / `eu` используют один и тот же API-ключ, поэтому выбирайте наиболее подходящий для вашего региона. В конце `BASE_URL` **не должно** быть слеша.

> **Подсказка**: JetBrains IDE наследует системные переменные окружения. Если вы уже настроили их в `~/.zshrc` или `~/.bashrc`, IDE подхватит их при запуске — при условии, что IDE запущена из окружения, в котором эта конфигурация была загружена (см. раздел вопросов ниже).

Если вы не хотите полагаться на глобальные переменные окружения, их можно задать для отдельного проекта (см. [Часто задаваемые вопросы](#переменные-окружения-не-подхватываются)).

### Шаг 3: Проверка

1. В IDE нажмите `Cmd+Esc` (macOS) или `Ctrl+Esc` (Windows/Linux), чтобы открыть панель Claude Code

2. Введите простое сообщение (например, «привет») для проверки подключения

3. Если вы получили нормальный ответ, значит плагин успешно подключился через QCode

Доступность самого шлюза можно также проверить с помощью `curl` (ответ `401` означает, что путь верен и не хватает только аутентификации, что ожидаемо):

```bash
curl -i https://api.qcode.cc/api/v1/messages
# HTTP/2 401  ← путь верен, как и ожидалось
```

## Использование

### Горячие клавиши

| Горячая клавиша | Функция |
|-----------------|---------|
| `Cmd+Esc` / `Ctrl+Esc` | Открыть / закрыть панель Claude Code |
| `Cmd+Option+K` / `Ctrl+Alt+K` | Вставить в запрос ссылку на текущий файл (@file) |
| `Esc` | Прервать текущую генерацию |

> Фактические сочетания клавиш зависят от версии плагина и вашей раскладки (keymap); для настройки найдите «Claude» в **Settings** → **Keymap**.

### Основные возможности

1. **Объяснение кода**: выделите код → правая кнопка → **Ask Claude**, чтобы он объяснил эту логику

2. **Генерация кода**: опишите задачу на естественном языке в панели Claude, чтобы он сгенерировал или изменил код

3. **Исправление ошибок**: отправьте трассировку стека или сообщение об ошибке Claude для анализа и исправления

4. **Рефакторинг кода**: выделите целевой код и попросите Claude улучшить его структуру, выделить функции или добавить тесты

### Нативный режим Diff

Плагин глубоко интегрирован с JetBrains: когда Claude предлагает изменения файлов, они отображаются в **нативном режиме параллельного сравнения (diff)** IDE, так что вы можете просмотреть каждое изменение, принять или отклонить его, а затем записать на диск. Это нагляднее и безопаснее, чем обычный diff в терминале.

### Совместное использование со встроенным терминалом

Встроенный терминал JetBrains IDE также позволяет запускать команду `claude` напрямую, с полной функциональностью CLI. Плагин автоматически передаёт CLI текущий открытый файл и выделение в качестве контекста, поэтому их лучше всего использовать вместе.

### Ввод изображений (визуальные возможности)

Модели с поддержкой зрения (Claude Opus 5 / Sonnet 5, а также семейство GPT-5.x) могут **читать изображения** в качестве ввода:

- Вставьте скриншот напрямую (`Ctrl+V`) в панель Claude
- Перетащите файл изображения в окно чата
- Укажите путь к файлу изображения в запросе

Типичные сценарии: воссоздание интерфейса по макету/скриншоту, отладка по скриншоту ошибки, чтение архитектурных диаграмм и графиков.

> Это **ввод изображений**, а не их генерация. Чтобы модель **генерировала** изображения, используйте модель `gpt-image-2` — см. [Генерация изображений gpt-image-2](/docs/usage/image-2).

### Выбор модели

В панели Claude модель можно переключать командой `/model`; все модели вызываются через один и тот же ключ QCode. Распространённые варианты:

| Модель | Контекст | Лучше всего для |
|--------|----------|-----------------|
| `claude-opus-5` | 1M | Флагман, сложный рефакторинг и архитектурные рассуждения |
| `claude-opus-4-7` | 1M | Альтернативный флагман |
| `claude-sonnet-5` | 1M | Повседневное кодирование, сбалансированная цена/качество |
| `claude-haiku-4-5` | 200K | Лёгкие задачи, быстрые вопросы и ответы |

Цены мы на эту страницу не переносим — смотрите актуальные значения на [qcode.cc/models](https://qcode.cc/models) (администратор может менять тарифы).

> QCode также поддерживает модели GPT-5.x и Gemini, но плагин Claude Code для JetBrains ориентирован на протокол Anthropic; GPT/Gemini лучше использовать в соответствующих инструментах, таких как Codex / Antigravity. Цены — на [qcode.cc/models](https://qcode.cc/models). Идентификаторы 4.x (`claude-sonnet-4-6`, `claude-opus-4-8`) по-прежнему в продаже.

### Продвинутое использование

- **Динамические рабочие процессы (Dynamic Workflows)**: включите в запрос ключевое слово **`ultracode`** (или просто попросите «запустить workflow»), чтобы оркестрировать от десятков до сотен фоновых субагентов параллельно для крупных задач (ревью кода по всему репозиторию, массовая миграция, исследование по множеству файлов и т. д.). Субагенты работают в фоне, пока вы продолжаете работу; проверяйте ход выполнения командой `/workflows`. Они работают на той модели, на которую настроен Claude Code, — поэтому работают и при направлении на QCode. См. [Субагенты](/docs/advanced/subagents).

- **Headless / автоматизация**: в терминале IDE также можно использовать `claude -p "<запрос>"` с `--output-format json|text|stream-json` для вызовов из скриптов. `json` возвращает структурированный объект с полями `result`, `total_cost_usd`, `usage` и `session_id`, который легко разобрать с помощью `jq`. См. [Автоматизация и CI/CD](/docs/advanced/headless).

## У плагина собственная страница настроек

Официально: **Settings → Tools → Claude Code [Beta]**. Перечисленные пункты:

- **Claude command** — какой командой плагин запускает Claude Code, например `claude`,
  `/usr/local/bin/claude`, `npx @anthropic-ai/claude-code`. **Если IDE не находит `claude`, официальный
  способ — прописать сюда абсолютный путь**, а не переделывать запуск оболочки
- **Suppress notification for when Claude Command is not found** — убрать уведомление о ненайденной команде
- **Enable using Option+Enter for multi-line prompts** — только macOS
- **Enable automatic updates** — автоматически искать и ставить обновления плагина (применяется после перезапуска)

## Подключение внешнего терминала: `/ide`

По официальной документации, команда `/ide` внутри Claude Code в любом внешнем терминале подключает его
к запущенной JetBrains IDE и включает все функции. При успехе Claude Code отвечает чем-то вроде
`Connected to IntelliJ IDEA.`; если обнаружена IDE без плагина, `/ide` сам ставит плагин и просит
перезапустить IDE. С QCode всё так же — внешний `claude` использует уже настроенный `ANTHROPIC_BASE_URL`.

## Удалённая разработка JetBrains: плагин ставится на хост

Документация требует прямо: при JetBrains Remote Development плагин нужно ставить **на удалённом хосте**
через **Settings → Plugins → Plugin (Host)**. Установка на локальном клиенте результата не даст.

## AI Assistant — это другой продукт

Эта страница про **плагин Claude Code**: он использует ваш собственный CLI `claude` по протоколу
Anthropic, а base URL берётся из переменной окружения. У JetBrains есть и **AI Assistant** — там тоже
можно подключить сторонние модели, но вход другой: **Settings | Tools | AI Assistant | Providers & API
keys**, и, согласно документации, **поле URL есть только у типа "OpenAI-compatible"** — у Anthropic и
Gemini API key поля только для ключа.

| Путь | Протокол | Своё поле URL | Что отдаёт QCode |
|---|---|---|---|
| Плагин Claude Code (эта страница) | Anthropic Messages | да, `ANTHROPIC_BASE_URL` = `https://api.qcode.cc/api` | модели Claude и китайские семейства (ветка Anthropic) |
| AI Assistant → OpenAI-compatible | OpenAI Chat Completions | да, поле URL есть | GPT и китайские семейства (`https://api.qcode.cc/openai/v1`) |
| AI Assistant → Anthropic / Gemini | нативный | **поля адреса в документации нет**, только ключ | на QCode направить нельзя |

AI completion в AI Assistant (автодополнение в строке / next edit) тоже работает только с эндпоинтом
"OpenAI Compatible", и документация предупреждает: для автодополнения нужна поддержка
Fill-in-the-Middle, которой у универсальных диалоговых моделей обычно нет.

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

### Плагин не отображает панель Claude Code?

1. Убедитесь, что плагин установлен и активирован (**Settings** → **Plugins** → **Installed**)

2. Убедитесь, что Claude Code CLI установлен глобально: выполните `claude --version` в терминале — должен появиться номер версии (см. [официальные Releases](https://github.com/anthropics/claude-code/releases))

3. Убедитесь, что версия IDE ≥ 2024.2

4. Перезапустите IDE; при необходимости выполните **File** → **Invalidate Caches / Restart**
### `Esc` не прерывает генерацию?

Официальная запись в разделе устранения неполадок: в терминалах JetBrains `Esc` перехватывает IDE, чтобы перенести фокус в редактор. Правится в **Settings → Tools → Terminal** — либо снимите галочку **"Move focus to the editor with Escape"**, либо нажмите **"Configure terminal keybindings"** и удалите сочетание "Switch focus to Editor".

### Переменные окружения не подхватываются?

JetBrains IDE может не считывать переменные окружения из конфигурационных файлов оболочки (процессы, запущенные из GUI, часто не загружают `~/.zshrc`). Решения:

- **macOS**: запускайте IDE из терминала (например, `open -a "IntelliJ IDEA"`), а не из Dock; либо используйте **Tools** → **Create Command-line Launcher** и запускайте из терминала

- **Все платформы**: добавьте `ANTHROPIC_BASE_URL` и `ANTHROPIC_AUTH_TOKEN` вручную в **Run/Debug Configurations** → **Environment variables**

- **Постоянство**: задайте их через JetBrains Toolbox, `*.vmoptions` или системные переменные окружения, чтобы они считывались при каждом запуске

### Ошибка аутентификации / 401 / 403?

1. Проверьте, что `ANTHROPIC_AUTH_TOKEN` — действительный ключ QCode, начинающийся с `cr_`, без лишних пробелов или кавычек

2. Убедитесь, что в конце `ANTHROPIC_BASE_URL` **нет** слеша, а путь — `/api` (протокол Anthropic)

3. Выполните `curl -i https://api.qcode.cc/api/v1/messages`: ответ `401` означает, что шлюз доступен (не хватает только аутентификации); ошибка соединения указывает на проблему с сетью/прокси

### Тайм-ауты соединения / блокировка за корпоративным прокси?

- Пользователям в материковом Китае сначала следует переключиться на `asia.qcode.cc`

- Если вы за корпоративным прокси, убедитесь, что в IDE правильно настроен **Settings** → **Appearance & Behavior** → **System Settings** → **HTTP Proxy**, либо задайте переменную окружения `HTTPS_PROXY` для терминала

- Убедитесь, что брандмауэр разрешает процессу IDE исходящий доступ к `*.qcode.cc:443`

### Изменили переменные окружения, но IDE их не замечает?

Переменные окружения считываются один раз при запуске процесса. После редактирования `~/.zshrc` или системных переменных нужно **полностью закрыть и перезапустить IDE** (а не просто открыть окно заново), чтобы изменения вступили в силу.

## Следующие шаги

- Ознакомьтесь с [конечными точками и форматами API](/docs/getting-started/endpoints-and-api-paths), чтобы узнать о четырёх доменах и base URL для каждого протокола

- Ознакомьтесь с [интеграцией с VS Code](/docs/ide/vscode) для использования расширения VS Code

- Ознакомьтесь с [интеграцией с Cline](/docs/ide/cline) — ещё одним AI-расширением для VS Code

- Изучите [советы по CLI](/docs/usage/cli-tips) для работы в терминале

> Хотите узнать, какую модель выгоднее всего запускать в JetBrains? Загляните на [страницу цен QCode](https://qcode.cc/pricing) и выберите Opus / Sonnet / Haiku под свой бюджет.