Agent Nine

Русский

English

Русский

English

Тема

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

Подробный гайд по решению всех возможных проблем.

Установка ​

Установщик не запускается (Windows) ​

Симптомы: .msi файл не открывается или показывает предупреждение безопасности.

Решения:

  1. Правый клик на файл → Свойства → отметьте «Разблокировать» → ОК → попробуйте снова
  2. Если SmartScreen блокирует — «Подробнее» → «Выполнить в любом случае»
  3. Убедитесь, что скачали с официального сайта: agentnine.ru/download
  4. Попробуйте запустить от имени администратора

Установщик не запускается (macOS) ​

Симптомы: «Agent Nine не может быть открыт, так как он от неизвестного разработчика».

Решения:

  1. Системные настройки → Безопасность → Основные
  2. Увидите «Agent Nine был заблокирован» — нажмите «Всё равно открыть»
  3. Альтернативно: правый клик → Открыть (обходит Gatekeeper одноразово)

Установщик не запускается (Linux) ​

Симптомы: AppImage не запускается.

Решения:

  1. Сделайте файл исполняемым: правый клик → Свойства → Права → «Разрешить выполнение»
  2. Через терминал: chmod +x AgentNine.AppImage && ./AgentNine.AppImage
  3. Для .deb: sudo dpkg -i agent-nine.deb && sudo apt-get install -f
  4. Отсутствующие библиотеки: установите libwebkit2gtk-4.0 и libssl3

Приложение открывается, но показывает белый/пустой экран ​

Решения:

  1. Очистите кэш приложения:
    • Windows: удалите %APPDATA%/agent-nine/
    • macOS: удалите ~/Library/Application Support/agent-nine/
    • Linux: удалите ~/.config/agent-nine/
  2. Обновите драйверы GPU
  3. Попробуйте запуск с флагом --disable-gpu

Аутентификация ​

Решения:

  1. Проверьте папку «Спам»
  2. Убедитесь, что ввели email без ошибок
  3. Попробуйте снова — ссылка действует 10 минут
  4. Корпоративная почта? Проверьте с IT — некоторые файрволлы блокируют транзакционные письма
  5. Попробуйте другой email (Gmail, Outlook обычно работают)

Причины:

  • Ссылки истекают через 10 минут
  • Каждая ссылка может быть использована только один раз
  • Запрос новой ссылки аннулирует старую

Решение: Запросите новую ссылку и используйте её сразу.

Ошибка «Сессия истекла» ​

Сессии истекают при длительном бездействии. Решение: Войдите заново. История чатов сохраняется.

Не могу войти на нескольких устройствах ​

Agent Nine поддерживает несколько активных сессий. Если не получается:

  1. Настройки → Аккаунт → Активные сессии
  2. Проверьте, не достигнут ли лимит сессий
  3. Отзовите старые сессии, которые больше не нужны

Подключение и сеть ​

Agent Nine не подключается к серверу ​

Симптомы: «Ошибка подключения», «Сеть недоступна» или бесконечная загрузка.

Решения:

  1. Проверьте интернет — попробуйте открыть любой сайт
  2. Проверьте, доступен ли agentnine.ru в браузере
  3. За корпоративным прокси или VPN:
    • WebSocket-соединения должны быть разрешены
    • Порт 443 (HTTPS) должен быть открыт
    • Попросите IT добавить в whitelist: *.agentnine.ru
  4. Отключите блокировщики рекламы и расширения, которые могут мешать
  5. Попробуйте другую сеть (например, мобильный хотспот)

Agent Nine подключён, но очень медленный ​

Возможные причины:

  • Высокая задержка сети — проверьте speedtest
  • Большой контекст (длинный разговор) — используйте /compact
  • Нагрузка на сервер в пиковые часы — попробуйте позже
  • VPN добавляет задержку — попробуйте без VPN

WebSocket-соединение постоянно обрывается ​

Решения:

  1. Нестабильный интернет (Wi-Fi сигнал, мобильные данные)
  2. Корпоративные файрволлы разрывают долгие соединения — спросите IT про WebSocket-политики
  3. Если используете прокси — убедитесь, что он поддерживает WebSocket upgrade
  4. Перезапустите приложение

Режим Код ​

«Машина не подключена» ​

Симптомы: Вы в режиме Код, но Agent Nine говорит, что машина недоступна.

Решения:

  1. Убедитесь, что десктоп-приложение запущено (не только веб)
  2. Проверьте, что вошли с того же аккаунта
  3. Перезапустите десктоп-приложение
  4. Настройки → Аккаунт → Машины — ваша машина должна быть в списке

Agent Nine не видит файлы проекта ​

Решения:

  1. Откройте нужную папку через выбор проекта (сайдбар)
  2. Убедитесь, что вы в режиме Код, а не Чат
  3. Проверьте правильность пути к папке
  4. Большие проекты: Agent Nine читает файлы по запросу — не сканирует всё заранее

Agent Nine читает не те файлы ​

Решения:

  1. Будьте конкретнее: «прочитай src/auth/login.ts» вместо «прочитай файл логина»
  2. Проверьте, что вы в нужном проекте (имя проекта в сайдбаре)
  3. Если есть файлы с похожими именами — укажите полный путь

Команды падают с «Permission denied» ​

Решения:

  1. Проверьте права доступа к файлам/папкам
  2. macOS: Системные настройки → Безопасность → Файлы и папки → разрешите терминал
  3. Linux: проверьте владельца с ls -la, исправьте через chmod или chown
  4. Windows: правый клик → Запуск от имени администратора
  5. Некоторые папки защищены ОС (Program Files, /usr/bin)

Agent Nine использует неправильный шелл ​

Agent Nine определяет автоматически:

  • macOS/Linux → Bash
  • Windows → PowerShell

Решения:

  1. Укажите явно: «выполни через bash» или «используй PowerShell»
  2. Если Bash не найден на Windows — установите Git Bash или WSL

Команды зависают или завершаются по таймауту ​

Решения:

  1. Интерактивные команды (ожидающие ввода) не работают — Agent Nine не может печатать в запущенные процессы
  2. Команды с подтверждением y/n зависнут — передайте флаг --yes или -y
  3. Для длительных сборок попросите запустить в фоне
  4. Таймаут по умолчанию — 2 минуты, для длинных команд — до 10 минут

Agent Nine сделал нежелательные изменения в файлах ​

Быстрое исправление: Введите /undo для отката всех изменений сессии.

Профилактика:

  • Используйте режим разрешений «По умолчанию» — одобряйте каждое действие
  • Создайте agentnine.md с правилами вроде «никогда не изменяй файлы в config/»
  • Используйте хуки для блокировки изменений определённых файлов

Режим Чат ​

Код не выполняется в облачной песочнице ​

Решения:

  1. Песочница изолирована — нет доступа к локальным файлам
  2. Установите зависимости: «установи pandas и запусти скрипт»
  3. Поддерживаемые среды: Python, Node.js, Go, Rust, Java
  4. Ограничение размера файлов: до 10 МБ
  5. Таймаут выполнения: 2 минуты на команду

Ошибка «Песочница недоступна» ​

Решения:

  1. Попробуйте снова — песочница может быть временно перегружена
  2. Для простого кода попросите показать код вместо выполнения
  3. Переключитесь в режим Код для локального выполнения

Сгенерированный код не работает ​

Советы:

  1. Дайте больше контекста о настройке вашего проекта
  2. Укажите версию языка/фреймворка: «Python 3.11», «Node.js 20»
  3. Если первая попытка не удалась — вставьте ошибку, Agent Nine исправит
  4. Для сложных настроек начните с простой версии и улучшайте итеративно

Интеграции ​

Интеграция не подключается ​

Решения:

  1. Разрешите всплывающие окна — OAuth требует popup
  2. Проверьте, что у вас есть нужные права на внешнем сервисе
  3. Попробуйте другой браузер (рекомендуется Chrome)
  4. Очистите cookies и попробуйте снова
  5. За VPN/прокси OAuth-callback может блокироваться — попробуйте без VPN

Ошибка «Токен истёк» ​

OAuth-токены истекают периодически (обычно каждые 1-2 часа).

Решение: Настройки → Интеграции → отключите → подключите заново.

Интеграция возвращает пустые результаты ​

Решения:

  1. Проверьте доступ к запрашиваемому ресурсу
  2. GitHub: Репозиторий приватный? Убедитесь, что авторизовали нужную организацию
  3. Notion: Нужно явно расшарить страницы с интеграцией при подключении
  4. Slack: Agent Nine видит только каналы, в которые его пригласили
  5. Figma: Проверьте, что файл расшарен с вашим аккаунтом
  6. Google Drive: Элементы «Доступные мне» нужно сначала принять
  7. Будьте конкретнее: «покажи issues в репо backend» вместо «покажи issues»

Действия интеграции не выполняются ​

Решения:

  1. Проверьте, что у аккаунта есть права на запись (создание issues, отправка сообщений и т.д.)
  2. Некоторые организации ограничивают сторонние приложения — проверьте с администратором
  3. Rate limits: при множестве запросов подождите минуту и повторите
  4. Для GitHub: проверьте, что токен имеет нужные scopes

Несколько аккаунтов ​

Если у вас несколько аккаунтов на одном сервисе (личный и рабочий GitHub):

  1. Войдите в нужный аккаунт в браузере перед подключением
  2. Для смены: отключите интеграцию → войдите в другой аккаунт в браузере → подключите заново

Голосовой ввод ​

Микрофон не работает ​

Решения:

  1. Разрешения браузера: Нажмите иконку замка/микрофона в адресной строке → разрешите
  2. macOS: Системные настройки → Безопасность → Микрофон → разрешите браузер
  3. Windows: Параметры → Конфиденциальность → Микрофон → разрешите приложение
  4. Linux: Проверьте настройки PulseAudio/PipeWire, убедитесь что микрофон не отключён
  5. Убедитесь, что микрофон не занят другим приложением (Zoom, Discord и т.д.)
  6. Обновите страницу / перезапустите приложение
  7. Попробуйте другой микрофон или гарнитуру

Микрофон работает, но нет расшифровки ​

Решения:

  1. Проверьте интернет — расшифровка требует обращения к серверу
  2. Говорите хотя бы 1-2 секунды — очень короткое аудио может не распознаться
  3. Индикатор расшифровки должен анимироваться — если статичен, нажмите иконку микрофона снова

Расшифровка неточная ​

Советы:

  • Приблизьтесь к микрофону
  • Уменьшите фоновый шум (вентиляторы, музыка, другие люди)
  • Говорите в естественном темпе — не слишком быстро, не слишком медленно
  • Делайте короткие паузы между предложениями
  • Технические термины могут распознаваться неверно — отредактируйте перед отправкой
  • Старайтесь говорить на одном языке (смешение снижает точность)

Кнопка голосового ввода отсутствует ​

Решения:

  1. Доступен только в десктопе и веб-приложении (не во всех браузерах)
  2. Если используете старый браузер — обновите до последней версии
  3. Safari: убедитесь, что MediaRecorder API включён

Производительность ​

Agent Nine отвечает медленно ​

Причины и решения:

ПричинаРешение
Длинный разговор/compact для сжатия истории
Сложная задачаНормально — Agent Nine думает дольше над трудными задачами
Большие файлы в контекстеУказывайте конкретные файлы, а не целые директории
Задержка сетиПроверьте скорость соединения
Нагрузка на серверПопробуйте в менее загруженное время

Высокое потребление CPU/памяти ​

Решения:

  1. Закройте неиспользуемые сессии в сайдбаре
  2. Перезапускайте приложение периодически
  3. Для очень больших проектов (>10k файлов) Agent Nine читает файлы по запросу — это нормально
  4. Обновитесь до последней версии

Контекст постоянно заполняется ​

Контекст AI имеет ограниченный размер. Когда он заполняется:

  1. /compact — сжать разговор (рекомендуется)
  2. /clear — начать заново (теряется история)
  3. Начните новую сессию для другой задачи
  4. Постоянные инструкции храните в agentnine.md, а не повторяйте в чате

Работа с файлами ​

Agent Nine не может найти файл, который точно существует ​

Решения:

  1. Используйте полный путь: «прочитай src/components/Header.tsx»
  2. Проверьте корень проекта — Agent Nine ищет от папки проекта, а не от домашней директории
  3. Файл в .gitignore? Agent Nine всё равно может читать, но может не искать проактивно

Agent Nine перезаписывает мои изменения ​

Решения:

  1. /undo — немедленный откат
  2. Сохраните несохранённые изменения в редакторе перед тем, как Agent Nine начнёт редактирование
  3. Используйте режим «По умолчанию» для одобрения каждой правки
  4. Agent Nine делает бэкап перед редактированием — проверьте историю отмен в редакторе

Agent Nine создаёт файлы, о которых я не просил ​

Решения:

  1. Будьте конкретнее: «отредактируй существующий файл, не создавай новые»
  2. agentnine.md с правилом: «никогда не создавай новые файлы без моего одобрения»
  3. Используйте хуки для уведомления о создании файлов

Режим планирования ​

Режим планирования не работает ​

Решения:

  1. Введите /plan для явного входа
  2. В режиме планирования Agent Nine только планирует — не пишет код, пока вы не одобрите
  3. План сохраняется в .agent-nine/plan.md
  4. Для реализации скажите «выполняй» или «реализуй план»

План слишком расплывчатый ​

Советы:

  1. Дайте больше контекста о задаче
  2. Попросите детализировать: «подробнее распиши шаг 3»
  3. Укажите ограничения: «нужно сохранить обратную совместимость»

Агенты ​

Агент завис ​

Решения:

  1. Проверьте область статуса — возможно, работа ещё идёт
  2. Отмените агента и перезапустите задачу
  3. Разбейте задачу на меньшие части
  4. Таймаут агента — обычно 10-15 минут для сложных задач

Агент выдал неправильные результаты ​

Решения:

  1. Внимательно просмотрите вывод агента
  2. /undo если агент сделал неправильные изменения в файлах
  3. Дайте более конкретные инструкции в следующий раз
  4. Используйте агент типа Verification для перепроверки

Слишком много агентов ​

Решения:

  1. Отмените ненужных агентов из области статуса
  2. Будьте конкретнее — Agent Nine создаёт меньше агентов для чётко определённых задач
  3. Каждый агент использует свой контекст и токены — мониторьте расход в Настройках

Аккаунт и оплата ​

Лимит использования достигнут ​

Симптомы: «Квота превышена» или «Rate limit».

Решения:

  1. Проверьте расход в Настройки → Использование
  2. Использование сбрасывается еженедельно
  3. Используйте лёгкую модель (Haiku) для простых задач
  4. /compact для уменьшения расхода токенов в длинных разговорах
  5. Улучшите план для большего лимита

Не могу удалить аккаунт ​

Настройки → Аккаунт → Удалить аккаунт. Навсегда удаляется:

  • Ваш аккаунт и профиль
  • Вся история сессий
  • Все интеграции
  • Все подключения машин

Это действие необратимо.

Обновления ​

Как обновить Agent Nine ​

ПлатформаСпособ
WindowsСкачайте последний .msi с agentnine.ru/download и установите поверх
macOSСкачайте последний .dmg и перетащите в Applications
LinuxСкачайте последний AppImage или .deb
ВебВсегда актуален — просто обновите страницу

Обновление сломало что-то ​

Решения:

  1. Настройки и история чатов сохраняются между обновлениями
  2. Если приложение падает — очистите кэш (см. «Белый/пустой экран» выше)
  3. Сообщите о проблеме на support@agentnine.ru с номером версии

Не помогло? ​

Напишите на support@agentnine.ru с описанием:

  • Что вы пытались сделать
  • Что произошло вместо этого (включая тексты ошибок)
  • Ваша платформа (Windows/macOS/Linux)
  • Десктоп или веб-приложение
  • Скриншоты, если возможно

Agent Nine — AI coding assistant

© 2026 Agent Nine Team