ZubrCode в редакторах

ZubrCode работает не только в терминале. В редакторах семейства VS Code ставится расширение — оно открывает терминал с агентом рядом с кодом и передаёт ему текущий файл или выделение. В JetBrains и Zed агент подключается по Agent Client Protocol и живёт в панели агента самой IDE.

Везде нужен установленный zubrcode — установка одной командой. Расширение и ACP-подключение бинарь не ставят.

VS Code и форки: Cursor, VSCodium, Windsurf

Расширение ZubrCode — тонкий клиент: открывает терминал с zubrcode рядом с редактором и передаёт ему текущий файл или выделение. Работает в VS Code, Cursor, Windsurf, VSCodium и других форках VS Code.

Установка расширения

Сборка — VSIX, в маркетплейсе расширения нет. Свежий файл — zubrcode.vsix, он обновляется с каждым выпуском ZubrCode.

code --install-extension zubrcode.vsix

# Cursor
cursor --install-extension zubrcode.vsix

Файл один и тот же для VS Code, Cursor, Windsurf и VSCodium. Или в самом редакторе: Extensions → … → Install from VSIX… и укажите скачанный файл.

Команды и сочетания клавиш

Команда	Windows / Linux	macOS
Open ZubrCode — фокус на существующем терминале	Ctrl+Esc	Cmd+Esc
Open ZubrCode in new tab — новая сессия	Ctrl+Shift+Esc	Cmd+Shift+Esc
ZubrCode: Insert At-Mentioned — вставить упоминание файла (@путь/файл.ts#L37-42)	Ctrl+Alt+K	Cmd+Alt+K

Кнопка новой сессии есть и в заголовке редактора.

JetBrains и Zed: Agent Client Protocol

Agent Client Protocol — общий протокол для агентов в IDE: редактор показывает переписку, дифы и разрешения, а агент работает своим бинарём. ZubrCode поддерживает ACP — zubrcode acp запускает ACP-сервер на stdio:

zubrcode acp          # ACP-сервер на stdio
zubrcode acp --login  # вход в ZuBrIQ вместо запуска

Zed

В settings.json:

{
  "agent_servers": {
    "ZubrCode": {
      "command": "zubrcode",
      "args": ["acp"]
    }
  }
}

JetBrains

IntelliJ IDEA, PyCharm, WebStorm и другие IDE JetBrains (AI Assistant 2025.2 и новее) берут ACP-агентов из файла ~/.jetbrains/acp.json (Windows: %USERPROFILE%\.jetbrains\acp.json) — IDE создаёт его, когда вы добавляете агента в AI Chat, можно и написать руками:

{
  "agent_servers": {
    "ZubrCode": {
      "command": "/home/<вы>/.local/bin/zubrcode",
      "args": ["acp"]
    }
  }
}

• command — полный путь к бинарю: IDE не читает PATH вашего шелла. Узнать его — command -v zubrcode; на macOS это /Users/<вы>/.local/bin/zubrcode, на Windows — C:\\Users\\<вы>\\AppData\\Local\\Programs\\zubrcode\\bin\\zubrcode.exe (обратные косые в JSON удваиваются).
• Ключ ZuBrIQ агент берёт свой — после zubrcode auth login zubriq; можно и переменной: "env": {"ZUBRIQ_API_KEY": "sk-…"} рядом с args.

После сохранения ZubrCode появится в списке агентов AI Chat. Подробнее — справка JetBrains по ACP.

Частые вопросы

Расширение пишет, что ZubrCode не найден

Бинаря zubrcode нет или он не в PATH. Поставьте агента одной командой (установка), добавьте ~/.local/bin в PATH и откройте новый терминал или перезапустите редактор. Проверка: zubrcode --version.

Где взять ключ

Ключ ZuBrIQ — zubriq.by/chat → Настройки → API-ключи или вход командой zubrcode auth login zubriq. Один ключ действует в терминале, редакторе и через ACP.

Работает ли офлайн

Нет. Модели живут на платформе ZuBrIQ, поэтому нужен ключ и доступ к платформе: без сети агент не ответит.