Быстрый старт

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

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

Откройте страницу загрузки: она сама определит вашу систему и предложит нужный файл.

• macOS. Откройте .dmg из «Загрузок» и перетащите DevMachine ADE в «Программы». Запускайте приложение из «Программ».
• Windows. Запустите .exe. Если Windows покажет окно «Система Windows защитила ваш компьютер», нажмите «Подробнее» → «Выполнить в любом случае». Затем откройте DevMachine ADE с рабочего стола или из меню «Пуск».
• Linux. Откройте терминал — окно для текстовых команд. Распакуйте архив DevMachine-Linux-x64.tar.gz (или DevMachine-Linux-arm64.tar.gz) командой tar xzf и запустите ./koder-ade из появившейся папки koder-ade-linux-x64 (или koder-ade-linux-arm64).

Агент и всё, что ему нужно, уже внутри приложения: отдельно ставить ничего не придётся. Подробности и требования к системе — на странице «Установка и обновления».

#Шаг 2. Войдите в аккаунт

1. На экране «Вход в devmachine» нажмите «Войти через браузер».
2. Войдите на devmachine.ai. Если аккаунта ещё нет, создайте его на той же странице.
3. На macOS и Windows браузер сам вернёт вас в приложение. На Linux приложение покажет ссылку и код: откройте ссылку в браузере на любом компьютере и проверьте, что на странице тот же код.

После первого входа приложение задаст пару вопросов о вашей работе и покажет, что входит в пробный период. Вопросы можно пропустить кнопкой «Пропустить».

#Шаг 3. Откройте проект

При самом первом запуске приложение сразу открывает чат «Без проекта». Его файлы лежат в DevMachine/Default в домашней папке (на Windows — C:\Users\<имя>\DevMachine\Default). Такой чат удобен для задач без кода: документов, таблиц, разовых скриптов. Если кода нет, оставайтесь в нём и переходите к шагу 4.

Чтобы агент работал с вашим кодом, откройте папку проекта:

1. Нажмите на имя проекта в шапке окна.
2. Выберите «Открыть проект…» (⌘ O на Mac, Ctrl O на Windows и Linux) и укажите папку.
3. Если репозитория на компьютере ещё нет, выберите «Проект из git…» и вставьте его адрес. Репозиторий — папка проекта, где программа git хранит историю изменений.

Открыть можно любую папку проекта, но не саму домашнюю папку и не папки выше неё. Подробнее — в разделе «Проекты».

#Шаг 4. Поставьте задачу

1. В пустом чате опишите задачу обычными словами. Например: «Объясни, как устроен этот проект и где точка входа» или «Запусти тесты и почини то, что падает».
2. Нажмите Enter. Перенос строки — Shift Enter.
3. Следите за работой в ленте: что агент прочитал, какие команды запустил, какие файлы изменил.

Под пустым чатом есть готовые задачи. Нажмите на задачу: её текст попадёт в поле ввода, но не отправится, так что его можно поправить.

Новый чат работает в режиме агента «Авто»: агент сам принимает решения и спрашивает перед рискованными и необратимыми действиями. Когда ему нужно ваше решение, над полем ввода появляется карточка с кнопками «Разрешить» (Enter) и «Запретить» (Esc). Если агент задал вопрос, выберите вариант ответа или напишите свой.

Пока агент работает, можно дописать уточнение — он учтёт его на следующем шаге. Чтобы остановить агента, нажмите круглую кнопку «Остановить» в поле ввода.

#Шаг 5. Проверьте изменения

Агент правит файлы прямо на диске. Когда он закончит, в списке чатов слева появится статус «К ревью» с числом добавленных и удалённых строк.

1. Откройте «Изменения сессии» кнопкой в шапке окна, командой /diff в поле ввода или клавишами ⌘ 0 на Mac (Alt 0 на Windows и Linux) из набора сочетаний JetBrains. Этот набор стоит по умолчанию и повторяет клавиши привычной среды разработки; сменить его можно в «Настройки → Сочетания клавиш» (подробнее).
2. Просмотрите правки по файлам. Ненужную правку уберите кнопкой «Откатить»: файл станет таким, каким был до агента.
3. Чтобы вернуться в чат с замечанием, нажмите «Запросить правки».
4. Если нужен коммит (точка в истории git, к которой можно вернуться), нажмите «Commit…»: файлы в окне уже отмечены, заголовок — название чата. Снимите лишние и нажмите «Commit»; push выполнит только «Commit and Push».
5. Если всё в порядке, нажмите «Отметить проверенным». После отметки «Commit…» с экрана пропадёт.

Чтобы отменить запрос целиком, нажмите у своего сообщения значок ↺ «Отменить запрос и вернуть его в поле ввода». Агент откатит файлы, которые изменил после этого сообщения, а текст сообщения вернётся в поле ввода. Файлы откатятся, только если проект под git; иначе правки агента останутся в файлах, и приложение об этом сообщит.

#Что дальше

• Как работает агент и чат — что видно в ленте и как направлять агента.
• Режимы агента — когда агент спрашивает разрешения, а когда действует сам.
• Модели — выбор модели, модель «Авто» и уровень рассуждений.
• Тарифы и лимиты — что даёт пробный период и что будет, когда лимит закончится.