> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Руководство по использованию Claude Code для JetBrains IDE

> Claude Code 集成指南 - Ace Data Cloud

Claude Code — это инструмент **Agentic Coding**, выпущенный компанией Anthropic, также известный как один из самых мощных программных агентов в мире. Claude Code предоставляет специальный плагин для JetBrains IDE, поддерживающий полный спектр JetBrains IDE, включая IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm, Android Studio и другие.

В этом документе в основном описывается, как настроить и использовать Claude Code в JetBrains IDE через прокси-сервис AceData Cloud.

## Процесс подачи заявки

Чтобы использовать Claude Code, сначала перейдите на [страницу сервиса Claude Messages](https://platform.acedata.cloud/documents/claude-messages) и нажмите кнопку «Acquire», чтобы получить необходимые учетные данные для запроса:

![](https://cdn.acedata.cloud/nyq0xz.png)

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

При первой подаче заявки предоставляется бесплатный лимит, чтобы вы могли бесплатно опробовать сервис Claude Code.

## Поддерживаемые IDE

Плагин Claude Code поддерживает следующие JetBrains IDE:

| IDE                | Подходящие языки/сценарии                      |
| ------------------ | ---------------------------------------------- |
| **IntelliJ IDEA**  | Java, Kotlin, Scala и др.                      |
| **PyCharm**        | Python                                         |
| **WebStorm**       | JavaScript, TypeScript                         |
| **GoLand**         | Go                                             |
| **PhpStorm**       | PHP                                            |
| **Android Studio** | Разработка для Android                         |
| **Другие**         | Большинство JetBrains IDE также поддерживаются |

## Установка

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

Плагин Claude Code для JetBrains зависит от Claude Code CLI, поэтому сначала убедитесь, что CLI установлен:

```bash theme={null}
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Или с помощью Homebrew
brew install claude-code
```

После завершения установки можно проверить:

```bash theme={null}
claude --version
```

### Установка плагина

![Плагин Claude Code в JetBrains Marketplace](https://cdn.acedata.cloud/de78fd305b.png)

1. Откройте JetBrains IDE
2. Перейдите в **Settings** → **Plugins** → **Marketplace**
3. Найдите **Claude Code**
4. Нажмите **Install** для установки плагина
5. Перезагрузите IDE

Или перейдите напрямую на [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) для онлайн-установки.

> **Важно**: После установки плагина необходимо **полностью перезагрузить IDE** (возможно, потребуется перезагрузить несколько раз), чтобы изменения вступили в силу.

## Настройка AceData Cloud API

Плагин Claude Code для JetBrains выполняет команду `claude` через интегрированный терминал, поэтому способ настройки переменных окружения такой же, как и для CLI.

### Шаг 1: Создание config.json

Создайте файл конфигурации для Claude Code:

| Система           | Путь                                              |
| ----------------- | ------------------------------------------------- |
| **macOS / Linux** | `~/.claude/config.json`                           |
| **Windows**       | `C:\Users\{имя_пользователя}\.claude\config.json` |

Запишите в этот файл следующее содержимое и сохраните:

```json theme={null}
{
  "primaryApiKey": "self"
}
```

Команда для быстрого создания на macOS / Linux:

```bash theme={null}
mkdir -p ~/.claude && echo '{"primaryApiKey": "self"}' > ~/.claude/config.json
```

### Шаг 2: Настройка переменных окружения

**Способ 1: Установите в конфигурационном файле Shell (рекомендуется)**

Добавьте следующее содержимое в ваш `~/.zshrc` или `~/.bashrc`, заменив `{token}` на ваш API токен:

```bash theme={null}
# AceData Cloud - Конфигурация прокси Claude Code
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"
```

После изменения выполните `source ~/.zshrc`, чтобы изменения вступили в силу, затем **перезагрузите JetBrains IDE**.

**Способ 2: Установите в settings.json Claude Code**

Отредактируйте `~/.claude/settings.json` (если не существует, создайте):

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}
```

> **Подсказка**: API токен можно просмотреть в [консоли AceData Cloud](https://platform.acedata.cloud/console).

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

### Запуск из интегрированного терминала IDE

Откройте интегрированный терминал JetBrains IDE и выполните:

```bash theme={null}
claude
```

При запуске в интегрированном терминале IDE все интегрированные функции (представление Diff, выбор контекста и т. д.) будут автоматически активированы.

### Подключение из внешнего терминала

Если вы запускаете Claude Code из внешнего терминала, вы можете использовать команду `/ide` для подключения к JetBrains IDE:

```bash theme={null}
claude
> /ide
```

Убедитесь, что вы запускаете Claude Code из той же директории, что и корень проекта IDE, чтобы Claude мог получить доступ к тем же файлам.

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

| Горячая клавиша                                     | Функция                                          |
| --------------------------------------------------- | ------------------------------------------------ |
| `Cmd+Esc` (Mac) / `Ctrl+Esc` (Windows/Linux)        | Быстрый запуск Claude Code                       |
| `Cmd+Option+K` (Mac) / `Alt+Ctrl+K` (Windows/Linux) | Вставка ссылки на файл (например, `@File#L1-99`) |

### Интегрированные функции

Плагин Claude Code для JetBrains предоставляет следующие интегрированные функции:

* **Представление Diff**: изменения кода отображаются непосредственно в просмотрщике Diff IDE
* **Выбор контекста**: текущий выделенный код и вкладки автоматически передаются Claude
* **Ссылки на файлы**: быстрое упоминание файлов и номеров строк с помощью горячих клавиш
* **Обмен диагностикой**: информация о диагностике, такая как Lint и синтаксические ошибки, автоматически передается Claude

## Настройки плагина

В **Settings** → **Tools** → **Claude Code \[Beta]** можно настроить:

| Настройка                     | Описание                                                                   |
| ----------------------------- | -------------------------------------------------------------------------- |
| **Claude command**            | Пользовательский путь к команде Claude (например, `/usr/local/bin/claude`) |
| **Enable automatic updates**  | Автоматическая проверка и установка обновлений плагина                     |
| **Enable using Option+Enter** | Использовать Option+Enter для переноса строки в диалоговом окне на macOS   |

### Настройки для пользователей WSL

Если вы используете среду WSL, необходимо установить команду Claude как:

```
wsl -d Ubuntu -- bash -lic "claude"
```

(замените `Ubuntu` на название вашего дистрибутива WSL)

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

### Что делать, если соединение не удалось?

1. Проверьте, правильно ли создан файл `~/.claude/config.json`
2. Убедитесь, что переменные окружения настроены правильно
3. Убедитесь, что API токен действителен (можно проверить в [консоли](https://platform.acedata.cloud/console))
4. Перезагрузите JetBrains IDE и повторите попытку

### Плагин не работает?

1. Убедитесь, что Claude Code запущен из корня проекта
2. Проверьте, включен ли плагин в настройках IDE
3. Полностью перезагрузите IDE (возможно, потребуется несколько раз)
4. Если вы используете режим удаленной разработки, убедитесь, что плагин установлен на удаленном хосте (Settings → Plugin (Host))

### IDE не обнаружена?

1. Убедитесь, что плагин установлен и включен
2. Перезагрузите IDE
3. Убедитесь, что Claude Code запущен в интегрированном терминале
4. Пользователи WSL, пожалуйста, ознакомьтесь с [руководством по устранению неполадок WSL](https://code.claude.com/docs/en/troubleshooting#jetbrains-ide-not-detected-on-wsl2)

### command not found

Если при нажатии на иконку Claude появляется сообщение "command not found":

1. Убедитесь, что CLI установлен: `which claude`
2. Установите полный путь к команде Claude в настройках плагина
3. Пользователи WSL используют указанный выше формат команд для WSL

### Как посмотреть остаток лимита?

Войдите в [консоль AceData Cloud](https://platform.acedata.cloud/console), чтобы увидеть текущий остаток лимита и использование вашего аккаунта.

## Узнать больше

* 📖 [Официальная документация Claude Code JetBrains](https://code.claude.com/docs/en/jetbrains)
* 🔧 [Служба Claude Code AceData Cloud](https://platform.acedata.cloud/documents/claude-messages)
* 💬 Если у вас есть вопросы, пожалуйста, свяжитесь с нами через службу поддержки платформы.
