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

# Polza IDE (alpha)

> Открытая десктопная IDE с встроенным ИИ-агентом и нативной интеграцией с Polza.ai

Polza IDE — бесплатная десктопная среда разработки на базе Electron, React и Monaco Editor с встроенным ИИ-агентом, поддержкой MCP-серверов, терминалом, Git и расширениями в формате VSIX. Она нативно интегрирована с экосистемой Polza.ai: авторизация через аккаунт Polza, автоматическое создание API-ключа, отображение баланса и стоимости сессии прямо в интерфейсе.

<Frame>
  <img src="https://storage.yandexcloud.net/polza-docs/polza-docs/images/74dbec2bcd8c9f74c419a53e4d26b878d34d257ccc7b4cb0ca17c1d6e82bfb22.png" alt="Polza IDE — общий вид интерфейса" />
</Frame>

## Установка

### Шаг 1. Скачайте установщик

Перейдите на страницу последнего релиза и скачайте файл для вашей операционной системы:

<a href="https://github.com/polza-ai/polza-ide/releases/latest" target="_blank">
  → Скачать Polza IDE (alpha version)
</a>

* **Windows** — файл `.exe` (инсталлятор)
* **macOS** — файл `.dmg` или `.tar.gz`

### Шаг 2. Установите приложение

Запустите скачанный установщик и следуйте инструкциям на экране. На Windows потребуется подтвердить запрос UAC.

## Подключение к Polza.ai

### Шаг 3. Кнопка авторизации

После запуска IDE нажмите на **Войти через Polza** в правой части окна.

<Frame>
  <img src="https://storage.yandexcloud.net/polza-docs/polza-docs/images/8ea8bb9289d62e37f7a89e1473d2ee4d9d2fbb833325ed5d35c6222e338775f0.png" alt="Кнопка авторизации в правой части окна" />
</Frame>

### Шаг 4. Авторизуйтесь через Polza.ai

Пройдите авторизацию в браузере. После успешного входа **новый API-ключ будет создан автоматически** и привязан к вашему аккаунту — никаких ручных действий не требуется.

<Frame>
  <img src="https://storage.yandexcloud.net/polza-docs/polza-docs/images/a297e43374b4f86029216cd46c2337890589db27c095212f4cc94ee51fa0339e.png" alt="Экран авторизации Polza.ai" />
</Frame>

<Note>
  Ключ создаётся один раз и сохраняется в IDE. При следующем запуске авторизация не потребуется.
</Note>

### Шаг 5. Выберите модель

Снова откройте настройки модели (правый нижний угол). Теперь вы увидите:

* **Баланс** вашего аккаунта Polza.ai
* **Стоимость** текущей сессии
* **Плагины Polza**, подключённые к агенту
* **Список доступных моделей**

Выберите нужную модель из списка.

<Frame>
  <img src="https://storage.yandexcloud.net/polza-docs/polza-docs/images/dc41352566d80799835b8e9972f82cd415e54f452e135f3395644e839886443c.png" alt="Настройки модели с балансом и списком моделей" />
</Frame>

### Шаг 6. Добавьте рабочую папку

Откройте нужную директорию через меню **«Файл → Открыть папку»** или перетащите папку в боковую панель. После этого IDE готова к работе — ИИ-агент видит ваш проект и может работать с файлами.

## Рекомендуемые модели

| Модель                 | ID                              | SWE-bench | Особенности                          |
| ---------------------- | ------------------------------- | --------- | ------------------------------------ |
| Claude Opus 4.7        | `anthropic/claude-opus-4.7`     | 87.6%     | Лучшая для сложных и длинных задач   |
| Claude Sonnet 4.6      | `anthropic/claude-sonnet-4.6`   | 79.6%     | Оптимальный баланс цены и качества   |
| Gemini 3.1 Pro Preview | `google/gemini-3.1-pro-preview` | 80.6%     | Конкурент Claude по цене             |
| Kimi K2.6              | `moonshotai/kimi-k2.6`          | 74%       | Открытая модель, сильна во фронтенде |
| DeepSeek V4 Flash      | `deepseek/deepseek-v4-flash`    | н/д       | Экономичная                          |

Актуальный список моделей: [polza.ai/models](https://polza.ai/models)

## Готово к работе

После добавления папки можно отправлять запросы агенту прямо из IDE — он видит структуру проекта, читает файлы и отвечает в контексте вашего кода.

<Frame>
  <img src="https://storage.yandexcloud.net/polza-docs/polza-docs/images/d77db8089d62949e42807e4d791bf9759b84f311b1ce8740ea414c3e002bca69.png" alt="Запрос к модели и ответ агента в Polza IDE" />
</Frame>

## Решение проблем

<AccordionGroup>
  <Accordion title="IDE не запускается на Windows">
    Убедитесь, что у вас установлен Visual C++ Redistributable. Попробуйте запустить установщик от имени администратора.
  </Accordion>

  <Accordion title="Авторизация не завершается">
    Убедитесь, что браузер не блокирует всплывающие окна и что вы вошли в аккаунт на [polza.ai](https://polza.ai). Попробуйте повторить шаг 3.
  </Accordion>

  <Accordion title="Модели не отображаются после авторизации">
    Закройте панель настроек и откройте её снова. Если список пуст — проверьте баланс аккаунта на [polza.ai/dashboard](https://polza.ai/dashboard).
  </Accordion>

  <Accordion title="Агент не видит файлы проекта">
    Убедитесь, что рабочая папка открыта (шаг 6). Агент работает только в контексте открытого проекта.
  </Accordion>
</AccordionGroup>