Quickstart

1. Запуск постоянного инстанции Linux

cd /srv/workspaces
aircode start

Первый выходной ход:

Generated password: k6uu3U6UG8AXgTnvNgNj
Started workspaces (1a2b3c4d5e6f) on http://127.0.0.1:7860.
Service: aircode@workspaces-1a2b3c4d5e6f.service — restart after crashes and automatic boot: enabled.

AirCode Ø автоматически выбирает свободный порт (7860 вверх), генерирует пароль доступа и сохраняет конфигурацию частного экземпляра вне каталога проектов. Если присутствует Tailscale , он связывает вашу tailnet IP , чтобы ваш телефон мог к ней добраться; в противном случае он связывает только localhost.

aircode start по умолчанию устойчив на Linux: systemd перезапускает сервер после сбоя и запускает его снова при запуске. Для процесса, связанного с текущим терминалом, вместо этого используйте aircode serve .

2. Откройте кабину

Откройте печатный URL на любом устройстве, которое может получить доступ к машине и войти с паролем. Для установки клиента для телефона или планшета сначала укажите на инстанцию стабильный адрес HTTPS через Remote Access, а затем выберите один из этих путей:

На настройка веб-приложения, введите только этот адрес инстанции HTTPS и выберите Откройте страницу установки. Та же установка остается доступной на Скачать. Адрес подтверждается в вашем браузере и является никогда не отправлялся или не хранился на маркетинговом сайте.
На самом примере войдите и выберите Установите веб-приложение от More или Настройки → Веб-приложение.
В Chromium принимайте запрос на установку, принадлежащий браузеру. На iPhone или iPad, следуйте руководству в продукте, чтобы выбрать Share → Добавить в Home Screen, держать Откройте, как веб-приложение включено при показании, и запустите новую икону Home Screen .

Веб-приложение всегда доступно как клиент без магазина; оно не зависит от Google Play, App Store, TestFlight или манифеста загружаемой версии. Обычные адреса HTTP LAN по-прежнему могут открываться в браузере, где это разрешено, но мобильная установка, обслуживающие работники и Web Push требуют HTTPS.

3. Запустите свой первый сеанс

Выберите проектный директорий.
Выберите среду исполнения:

Local запускается через хост tmux или Windows ConPTY.
Docker песочный ящик запускает одну поддерживаемую прямую сессию в рабочем монтирует выбранный проект.

Выберите двигатель (Claude Code, Codex, Antigravity CLI, Grok Build, Kimi Code) и режим разрешений.
Запуск Агент продолжает работать на машине AirCode Ø — закройте вкладку, поезд, возвращайся: он все еще работает. Уведомления пинг вас, когда Агент нуждается в входе или завершении.

Web, Desktop и native мобильные запусковые устройства раскрывают один и тот же выбор среды. Docker в настоящее время является предварительным просмотром источника Codex ; см. Docker песочницу перед включением разрешений обхода.

Переключатель двигателей в разговоре

Когда ваш агент готов, откройте настройки композитора разговора и выберите другой агент. Проверьте его модель и усилия, а затем подтвердите Переключатель агент. Claude Code, Codex, Grok Build и другие доступные двигатели имеют один и тот же интерфейс разговора. Ваш проект остается на месте, и контекстная контрольная точка продвигается вперед. Отправить ваше следующее сообщение, чтобы продолжить с новым агентом.

Работа с многомодельной командой

В New sessionвыберите Multi-model → Build now. Выберите двигатель, модель и усилия для каждой роли: Автор, Ревизер и Окончательный арбитр. Например, Claude Code может написать предложение, Codex может бросить вызов ему, а Grok Build может подготовить окончательное предложение после прочтения их бирж. Вы выбираете команду; эти задания являются примерами.

Установите количество прохождений перед началом. Каждый пропуск - это полное предложение, за которым следует обзор. Когда изменения запрашиваются, а прохождения остаются, обратная связь возвращается автору для пересмотра. Окончательный арбитр читает все обмены и объясняет свои решения. Результат отличает соглашение от арбитража, когда разногласия сохраняются.

4. Работает как контейнер

aircode ps                     # running instances
aircode ps -a                  # include stopped instances
aircode inspect                # current directory's instance
aircode logs --follow
aircode restart
aircode stop                   # stop now and disable startup at boot

Запустить команды жизненного цикла из корня инстанции или передать его имя, полный ID, короткий ID или корневой путь. Остановка или обновление сервера Никогда не убивай бега tmux Сеансы. Перезагрузка всего компьютера обязательно останавливает процессы операционной системы, но долговременная история сеансов остается доступной для восстановления.

5. Выберите порты, пароли и несколько корней

Каждое значение может быть предоставлено на командном запуске:

aircode start --projects-root /srv/client-a --port 7860 --generate-password
aircode start --projects-root /srv/client-b --port 7861 --password-file ~/.secrets/client-b
aircode start --projects-root /srv/demo --host 127.0.0.1 --port 7862 --no-password --relay private

Файлы с паролем должны быть частными (chmod 600). --password-stdin доступен для провизионных систем. --password <value> также работает, но раскрывает секрет истории оболочки и потенциально инспекции процессов. Отключение auth должно быть явным с --no-password.

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

aircode start --projects-root /srv/client-a --port 7860 --generate-password
aircode start --projects-root /srv/client-a --port 7861 --no-password --relay private

Добавьте --name internal или --name demo , когда полезно имя, ориентированное на роли. Выберите существующее имя или ID явно, когда вы планируете изменить постоянный порт этого случая.

6. Зарегистрируйтесь перед использованием управляемого Relay

aircode login
aircode whoami
aircode start --relay managed

Авторизация учетной записи предоставляется инстанциями этого пользователя Unix. Порты, пароли, идентификаторы туннелей и состояние, включенное в Relay , остаются изолированными в каждом случае. Управляемый Relay отклоняет инстанцию без пароля. Используйте aircode logout для удаления идентификатора машины, --relay private для VPN без общественного туннеля или --relay off для отключения туннеля, не забывая о его выбранном транспорте.

7. Установите агента CLIs

Упакованные версии AirCode Ø уже имеют свои прикрепленные CLI. Для исходного чек-ута, установите и аутентифицируйте CLI под одним и тем же пользователем Unix. Текущими целями распределения являются:

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.280
claude

curl -fsSL https://chatgpt.com/codex/install.sh | bash -s -- --release 0.156.1
codex login

curl -fsSL https://x.ai/cli/install.sh | bash -s 0.2.118
grok login

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash -s -- --version 0.32.0
kimi login

Старая или нечитаемая версия блокируется. Новейшее издание может запускать и поддерживает экранные проверки, если не зарегистрирована известная несовместимость. Командыaircode doctor сообщают о том, что доступно.

Antigravity CLI использует официальный инсталлятор Google:

curl -fsSL https://antigravity.google/cli/install.sh | bash
agy

Внутренние двигатели сохраняют свою модель аутентификации продавца:

Двигатель	Путь учетной записи/подписки	API путь
Claude Code	Claude План подписки	Anthropic API аккредитации
Codex	ChatGPT план регистрации	OpenAI API аккредитации
Antigravity CLI	Google с базовым доступом, Google AI Pro/Ultra или проект Google Cloud	Настоящий каталог аккаунтов
Grok Build	`grok login` с подпиской Grok или с подпиской на предприятие SSO	`XAI_API_KEY`
Kimi Code	Kimi Code ОАут	Moonshot API аккредитации

Google ушел в отставку Gemini CLI для индивидуальных счетов 18 июня 2026 года и направляет этот план в пакет Antigravity . AirCode Ø следует за этим ходом: Antigravity CLI является двигателем Google , а Gemini CLI больше не может быть выбран. Сеансы, созданные с ним до изменения, остаются читаемыми в истории. См. официальное уведомление о переходе Официальное уведомление о переходе.

Для подключения не требуется подписка Antigravity : учетная запись Google получает базовый план, в то время как Pro и Ultra увеличивают доступ к модели и ограничения. AirCode Ø использует специальный каталог, возвращенный agy models. Google Antigravity планы и каталог моделей.

Для упаковки профилей поставщика API откройте AI Usage, выберите поставщика и нажмите Connect. AirCode Ø подтверждает представленный ключ, сохраняет его локально в ~/.config/aircode/providers.env с частными разрешениями и сразу активирует его для новых сессий. Тот же экран может заменить или отключить ключи. Ключи, поставляемые через среду сервера, остаются поддерживаемыми и отображаются как внешне управляемые, а не редактируемые в интерфейсе пользователя.

GLM / Z.AI, DeepSeek, MiniMax и Meta / Muse Spark временно недоступны в v1 до проверки их доступности и надёжности в реальном использовании. Их интеграции сохранены в коде для последующего возвращения; во время этого ограничения их нельзя выбрать, подключить или запустить. Существующие разговоры и история использования остаются доступны для чтения.

Kimi Code остаётся доступен со своими собственными моделями Moonshot. AirCode Ø передаёт учётные данные только сессиям, использующим соответствующего поставщика, и никогда не возвращает их через API.

Grok использует записанную сессию браузера перед XAI_API_KEY; запустить grok logout , когда вы явно хотите путь API-key.