AO Code

1. Что такое AO Code

AO Code — программа, которую вы запускаете в терминале в папке своего проекта. Вы описываете задачу обычными словами, а AO Code читает файлы проекта, отвечает и с вашего согласия записывает изменения в файлы.

AO Code входит в ваш пакет AO Platform. Модель и её оплата идут из пакета: отдельный договор с поставщиком модели не нужен.

2. Что нужно до начала

Нужны две вещи.

1. Пакет с AO Code. AO Code работает, только если он входит в пакет вашей компании. Если не входит, программа так и скажет — обратитесь в поддержку платформы.

2. Рабочий вход в кабинет. В AO Code вы входите в браузере почтой своего аккаунта — так же, как в кабинет. Привязать компьютер может только владелец аккаунта.

3. Скачать

Выберите файл для своей системы. В каждом файле — самостоятельная программа: ничего дополнительно ставить не нужно.

Чтобы проверить скачанный файл, сравните его контрольную сумму SHA-256 с той, что под кнопкой: shasum -a 256 на Mac, sha256sum на Linux, Get-FileHash в PowerShell на Windows.

4. Установка

macOS

1. Скачайте файл для Mac выше. Он сохранится в папку «Загрузки».
2. Откройте Терминал и выполните команды ниже по одной. Они распакуют архив в папку aocode в вашей домашней папке и добавят её в PATH.
3. Закройте Терминал и откройте его снова.
4. Выполните aocode --version: программа напечатает номер своей версии.
5. Не разбирайте папку aocode: команда aocode в ней сама выбирает сборку под ваш процессор — Apple Silicon или Intel.

cd ~/Downloads
tar -xzf aocode-*-macos.tar.gz
mv aocode-*-macos ~/aocode
echo 'export PATH="$HOME/aocode:$PATH"' >> ~/.zshrc

Windows

1. Скачайте файл для Windows выше. Он сохранится в папку «Загрузки».
2. Откройте скачанный файл .zip, откройте папку внутри и скопируйте aocode.exe.
3. Вставьте %LOCALAPPDATA%\Programs в адресную строку Проводника, создайте там папку aocode и вставьте в неё aocode.exe.
4. Добавьте эту папку в PATH: откройте «Пуск», наберите «переменные среды», выберите «Изменение переменных среды текущего пользователя», выделите Path, нажмите «Изменить», затем «Создать», вставьте %LOCALAPPDATA%\Programs\aocode и нажмите «ОК» в обоих окнах.
5. Откройте новое окно PowerShell и выполните команду ниже: программа напечатает номер своей версии.

aocode --version

Linux

1. Скачайте файл для Linux выше. Он сохранится в папку «Загрузки» (~/Downloads).
2. Выполните в терминале команды ниже. Они распакуют архив и положат программу aocode в ~/.local/bin.
3. Если aocode --version отвечает «command not found», добавьте ~/.local/bin в PATH в профиле оболочки, например в ~/.bashrc, и откройте новый терминал.

cd ~/Downloads
tar -xzf aocode-*-linux-x64.tar.gz
mkdir -p ~/.local/bin
mv aocode-*-linux-x64/aocode ~/.local/bin/aocode
aocode --version

5. Первый запуск и вход

1. Откройте терминал в папке своего проекта и наберите aocode.
2. AO Code откроет браузер на входе в платформу. Если браузер не открылся сам, в терминале будет ссылка — откройте её сами.
3. Войдите почтой своего аккаунта.
4. На странице «Привязать машину к AO Code» видно имя этого компьютера. Нажмите «Привязать машину».
5. Вернитесь в терминал. Там написано, что машина привязана и ключ сохранён. В следующий раз AO Code запустится без этого шага.

Ключ этого компьютера хранится в папке .aocode в вашей домашней папке. Он открывает только AO Code, кабинет им не открыть. Если не подтвердить вход в браузере вовремя, попытка истечёт — запустите aocode снова.

Если при первом запуске спросит macOS

У AO Code нет платной подписи разработчика Apple, поэтому при первом запуске macOS может сказать, что не может проверить разработчика «aocode», и предложить переместить программу в Корзину. Не перемещайте: нажмите «Готово», затем откройте «Системные настройки» → «Конфиденциальность и безопасность», прокрутите вниз до сообщения об «aocode» и нажмите «Всё равно открыть». Запустите aocode снова и подтвердите «Открыть».

Можно и сразу снять отметку о скачивании со всей папки — этой командой в Терминале:

xattr -dr com.apple.quarantine ~/aocode

Если при первом запуске спросит Windows

У AO Code нет платной подписи для Windows, поэтому Windows может показать «Система Windows защитила ваш компьютер». Нажмите «Подробнее», затем «Выполнить в любом случае».

Чтобы вопроса не было, до распаковки щёлкните скачанный файл .zip правой кнопкой, выберите «Свойства», отметьте «Разблокировать» и нажмите «ОК».

6. Сколько компьютеров

К AO Code компания привязывает не больше трёх компьютеров. Привязывает их и работает с AO Code только владелец аккаунта.

Привязанные компьютеры видны в кабинете в разделе «Безопасность», в блоке «Машины AO Code»: имя, когда привязан, когда работал последний раз и версия программы. Чтобы привязать новый компьютер, когда три уже привязаны, погасите там один из них кнопкой «Погасить»: программа на нём перестанет работать со следующего запроса.

7. Как работать

Откройте терминал в папке своего проекта и запустите aocode. Настраивать стек не нужно: AO Code сам читает файлы проекта.

При запуске программа сообщает, нашла ли она файл правил aocode.md и сколько агентов лежит в .aocode/agents/, и предлагает написать вопрос. Опишите задачу обычными словами и нажмите Enter. Ответ появляется по мере того, как пишется.

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

Ctrl+C прерывает текущий ответ. /exit или Ctrl+D — выход из программы.

8. Правила проекта

Положите в корень проекта файл aocode.md. AO Code читает его при запуске и передаёт модели с каждым вопросом. Пишите обычными словами: что это за проект, как устроен код, как работать и чего не делать никогда. Изменённый файл действует со следующего запуска.

Файл остаётся в вашем проекте, платформа его копию не хранит. Готовый пример целиком:

# Проект: бэкенд интернет-магазина

## Что это
REST API интернет-магазина. C# 12, ASP.NET Core 9, PostgreSQL, EF Core.

## Устройство
- src/Shop.Api: точки входа API
- src/Shop.Domain: сущности и правила, без кода фреймворков
- src/Shop.Infrastructure: база данных и внешние сервисы
- tests/: тесты xUnit, один класс тестов на один проверяемый класс

## Как работать
- Читай код рядом с местом правки и пиши в том же стиле.
- Правки маленькие: одна задача — одна правка.
- У каждого нового правила есть тест.
- Отвечай по-русски, комментарии в коде — по-английски.

## Никогда
- Никогда не правь руками файлы в src/Shop.Infrastructure/Migrations.
- Никогда не вписывай пароли, ключи и токены в код и файлы настроек.
- Никогда не удаляй тест, чтобы сборка прошла.

9. Агенты

Агент — это файл с указаниями для одного вида задач. Кладите агентов файлами .md в папку .aocode/agents своего проекта; имя файла без .md — имя агента. AO Code читает всех агентов при запуске и передаёт их модели вместе с правилами.

Чтобы позвать агента, назовите его в вопросе, например: «reviewer: проверь изменения в src/Shop.Api». Пример агента — файл .aocode/agents/reviewer.md:

# reviewer
Ты проверяешь изменения в коде, прежде чем они пойдут дальше.
Прочитай файлы, названные в вопросе, и код вокруг них.
Сначала перечисли проблемы: ошибки, недостающие тесты, нарушенные правила aocode.md.
Для каждой проблемы назови файл, место и исправление.
Сам файлы не меняй: только опиши исправление.

• Строка 1, «# reviewer», — заголовок: он повторяет имя файла, чтобы было видно, что это за агент.
• Строка 2 задаёт роль: для чего агент.
• Строка 3 говорит, что прочитать перед ответом.
• Строка 4 говорит, что искать и в каком порядке.
• Строка 5 задаёт форму ответа.
• Строка 6 ставит границу: чего агент делать не должен.

Готовые агенты на типовые задачи

Тесты — файл .aocode/agents/tests.md

# tests
Ты пишешь тесты к коду, названному в вопросе.
Прочитай проверяемый код и тесты рядом с ним и пиши в их стиле.
Покрой обычный случай, крайние случаи и ошибки.
Один тест проверяет одно; имя теста говорит, что он проверяет.
Проверяемый код не меняй: если в нём ошибка, опиши её.

Документация — файл .aocode/agents/docs.md

# docs
Ты держишь документацию проекта в согласии с кодом.
Прочитай код, названный в вопросе, и документы, которые его описывают.
Найди места, где документ говорит то, чего код уже не делает.
Для каждого такого места предложи новый текст — коротко и простыми словами.
Код не трогай.

Исправление ошибки — файл .aocode/agents/bugfix.md

# bugfix
Ты находишь и исправляешь ошибку, описанную в вопросе.
Сначала найди причину: прочитай код по пути ошибки.
Объясни причину в двух-трёх предложениях, прежде чем что-то менять.
Сделай самую маленькую правку, которая устраняет причину, а не признак.
Предложи тест, который падает без правки и проходит с ней.

10. Расход и лимит

AO Code тратит бюджет ИИ вашего пакета — тот же бюджет, что и весь кабинет. Ограничитель один — бюджет пакета.

Сколько израсходовано, видно в кабинете в блоке «Бюджет ИИ»: две полосы, за неделю и за месяц, в процентах.

Когда бюджет закончился, AO Code перестаёт отправлять запросы и пишет: «Бюджет ИИ кабинета исчерпан. Запрос не отправлен.» Работа продолжится, когда бюджет обновится или его докупят в кабинете.

11. Если не работает

AO Code печатает сообщение платформы дословно. Найдите его ниже и сделайте, что написано.

Привязать машину к AO Code и работать с ней может только владелец кабинета.

Войдите в браузере почтой владельца аккаунта. Другие пользователи компании с AO Code не работают.

К кабинету уже привязано машин: 3 из 3. Погасите одну в разделе «Безопасность», чтобы привязать новую.

В кабинете откройте «Безопасность» → «Машины AO Code», погасите компьютер, на котором больше не работаете, и запустите aocode снова.

AO Code не подключён к кабинету: модуля нет в пакете. Чтобы подключить его, обратитесь в поддержку платформы.

AO Code нет в вашем пакете. Обратитесь в поддержку платформы.

Запрос на привязку машины не найден.Запрос на привязку истёк. Запустите вход в программе заново.Этот запрос на привязку уже использован.Код привязки не подошёл или истёк. Запустите вход в программе заново.

Запустите aocode снова и сразу подтвердите вход в браузере.

Эта машина погашена владельцем кабинета. Чтобы работать дальше, войдите в программе заново.Ключ доступа программы не распознан. Войдите в программе заново.

Запустите aocode снова: программа снимет старый ключ этого компьютера и начнёт новый вход. Если три компьютера уже привязаны, сначала погасите один.

Бюджет ИИ кабинета исчерпан. Запрос не отправлен.

Дождитесь, пока бюджет обновится, или докупите его в кабинете.

У кабинета нет действующего пакета с бюджетом ИИ. Запрос не отправлен.

Проверьте в кабинете, что ваш пакет действует и оплачен.

Поставщик модели не ответил или ответил ошибкой. Повторите запрос позже.

Задайте вопрос снова через минуту. Больше ничего делать не нужно.

Запрос прерван до ответа модели.

Ответ прерван до того, как модель ответила, например кнопками Ctrl+C. Задайте вопрос снова.

Программа прислала неполные данные машины.Программа прислала запрос в неверной форме.

Скачайте свежую версию с этой страницы и установите её поверх старой.

Адрес платформы не настроен — страницу входа открыть негде.В пакете кабинета нет агента с рукой «AO Code · модель». Обратитесь в поддержку платформы.Рука «AO Code · модель» выдана в пакете кабинета нескольким агентам — какой платит, не определено. Обратитесь в поддержку платформы.У руки «AO Code · модель» не выбрана модель, или выбранная выключена. Обратитесь в поддержку платформы.У модели ещё нет цены, поэтому запрос не отправлен и ничего не списано.Расход сейчас нечем оценить — на стороне платформы не хватает настройки. Запрос не отправлен.Поставщик модели не подключён к платформе. Запрос не отправлен, ничего не списано.

Это настройка на стороне платформы. Обратитесь в поддержку платформы и приведите сообщение.

12. Границы

Ваш код остаётся у вас. AO Code работает в папке проекта на вашем компьютере. Песочницы нет: на нашей стороне ничего не запускается, и копию вашего проекта платформа не хранит. С каждым вопросом модель получает правила, агентов и файлы, которые AO Code прочитал для этого вопроса.

Тела запросов и ответов мы не храним.

Работать своим ключом поставщика модели нельзя: запросы идут только через платформу и оплачиваются из бюджета пакета.

AO Code достаёт только файлы внутри папки проекта. Файлы вне её и папка .aocode с ключом для него закрыты. Команд он не запускает.

Не больше трёх компьютеров на компанию; привязывает их только владелец аккаунта.

13. Версии и обновление

Сам себя AO Code не обновляет. Когда выходит версия новее, программа при запуске печатает одну строку — «Есть версия X.Y.Z — обновитесь.» — и работает дальше.

Чтобы обновиться, скачайте новый файл с этой страницы и установите его так же. На Mac сначала удалите старую папку: rm -rf ~/aocode. На Windows замените aocode.exe в той же папке. На Linux команды выше заменят программу в ~/.local/bin.

После обновления компьютер остаётся привязанным: его ключ хранится в папке .aocode в домашней папке.

aocode --version показывает версию, установленную на вашем компьютере.

Все версии

• AO Code 0.1.0 · 26.10.2026 Windows · Mac · Linux