Конфигурация

Для управляемого экземпляра приоритетом являются переменные среды → instance config → global user config → defaults. Опцииaircode start сохраняются в конфигурации инстанции до начала службы. Предварительные опции aircode serve опережают среду только для этого процесса.

Глобальный файл — ~/.config/aircode/config.json. Файлы управляемых экземпляров живут в ~/.config/aircode/instances/<id>.json; они не размещаются в каталогах проектов. Файлы, несущие секрет, используют режим 0600. Натуральные опции переднего поля Windows перечислены в Windows CLI ссылки.

Конфигурация запуска на каждый случай

aircode start --projects-root /srv/workspaces --host 127.0.0.1 --port 7860 \
  --password-file ~/.config/aircode/workspaces-password

Специальные флаги охватывают корень, имя, хост, порт, публичный URL, каждый режим ввода пароля и Relay. Любое дополнительное значение, поддерживаемое схемой, может сохраняться с повторяющимся --set key=value; значения используют JSON при наличии:

aircode start --set maxSessions=64
aircode start --set workflows.maxConcurrent=2
aircode start --set 'browserAllowedHosts=["docs.example.com","*.internal.test"]'

Используйте --json для бесперебойного провизионирования. Его выход никогда не раскрывает существующий пароль; он включает пароль только тогда, когда этот вызов его генерировал.

Общие настройки

Env	config.json	По умолчанию	Цель
`AIRCODE_HOST`	`host`	Tailscale IP И еще `127.0.0.1`	адрес связи (по умолчанию никогда `0.0.0.0` )
`AIRCODE_PORT`	`port`	`7860` (автосканирование для нового экземпляра)	Порт Постоянный или явно настроенный занятый порт не удается вместо перемещения
`AIRCODE_AUTH_PASSWORD`	`authPassword`	генерируется	Пароль доступа. Пустая строка отключает аут (Dev Only)
`AIRCODE_PROJECTS_ROOT`	`projectsRoot`	запуск cwd	Директива, субпапки которой являются выбираемыми проектами
`AIRCODE_MAX_SESSIONS`	`maxSessions`	`64`	Конкурентная капсула сеанса
`AIRCODE_SESSION_IDLE_TTL_MS`	`sessionIdleTtlMs`	`21600000`	Hibernate завершил сеансы после 6 часов без работы; `0` также отключает отключение емкости
`AIRCODE_DEFAULT_PERMISSION_MODE`	`defaultPermissionMode`	`bypass`	По умолчанию режим разрешения агента
`AIRCODE_DEFAULT_EXECUTION_MODE`	`defaultExecutionMode`	`local`	По умолчанию среды сеанса (`local` или `docker`)
`AIRCODE_DOCKER_ENABLED`	`dockerEnabled`	`true`	Откройте дополнительный резервный блок исполнения Docker
`AIRCODE_DOCKER_IMAGE`	`dockerImage`	`aircode-session-runtime:local`	Опциональный Docker изображение работника
`AIRCODE_DOCKER_NETWORK`	`dockerNetwork`	`aircode-runtime`	Деятельный рабочий мост
`AIRCODE_DOCKER_CONTROL_PORT`	`dockerControlPort`	AirCode Ø порт + 1000	Стабильные звонки работников с ограниченными возможностями
—	`updateChannel`	`stable`	Канал выпуска (`stable` / `beta`)

Сеансовая гибернация останавливает только отдельную работу, последний поворот которой имеет маркер долговременного завершения и транскрипт, который можно возобновить. Сеансы, которые работают, ожидают ввода, управляются удаленно или принадлежат рабочему потоку, продолжают работать. На капсе сеанса AirCode Ø немедленно гибернирует старейший приемлемый пусковой период. Разговор остается в истории и возобновляется нормально.

Двойные версии двигателя (claudeBin, codexBin, …) и настройки на функции (браузер, знания, оркестрация, оптимизация токенов) документируются в настройках в продукте и принимают одно и то же преимущество env/file.

Зарядное ящик Docker для ограничений работников, сетевой работы и полной конфигурации Docker .

Файлы и каталоги

Путь	Содержание
`~/.aircode/versions/<v>`	продукт (неизменный, в сумме чеков)
`~/.aircode/current`	симлинк к активной версии
`~/.config/aircode/config.json`	глобальные пользовательские настройки
`~/.config/aircode/instances/<id>.json`	per-instance config, включая его пароль (0600)
`~/.config/aircode/providers.env`	провайдерские идентификационные данные, используемые пользователем Unix (0600)
`~/.config/systemd/user/aircode@.service`	один созданный шаблон systemd для каждого управляемого экземпляра
`~/.local/state/aircode/instances/<id>/`	Изолированное время запуска, туннель и состояние сеанса
`~/.local/state/aircode/relay-account.json`	управляемые учетные данные учетной записи Relay , используемые пользователем Unix (0600)

Обновления никогда не касаются instance config или state.

Множественные инстанции

Канонический корень определяет идентификацию по умолчанию. Различные корни естественным образом производят разные случаи. Для одного корня другой эксплицитный порт создает или повторно использует независимый автоматически названный инстант, а не меняет и перезапускает по умолчанию. --name обеспечивает стабильную идентичность, ориентированную на роли, когда вы хотите. Каждый инстанция получает свой порт, пароль/безпароль политики, tmux именного пространства, статус, и туннель идентификации.

aircode start --projects-root /srv/acme --port 7860 --generate-password
aircode start --projects-root /srv/acme --port 7861 --no-password --relay private
aircode start --projects-root /srv/acme --name demo --port 7862 --generate-password
aircode ps -a

Чтобы изменить порт существующего экземпляра, выберите этот экземпляр явно по имени или ID. Команда с корневым местом с новым портом намеренно рассматривается как новый инстанция, поэтому она не может молча применять текущий сервер оффлайн.

Команды жизненного цикла принимают название, полное или короткое ID, канонический корень или текущий каталог. Коренный селектор намеренно отвергается как неоднозначный, когда его используют несколько названных инстанций; выберите имя или ID.

Многопользовательские машины

Каждому пользователю ОС принадлежит отдельный реестр, глобальные по умолчанию, доверительные данные провайдера, управляемая авторизация Relay и набор системных сервисов пользователя. В пределах этого пользователя каждый экземпляр, предназначенный для пути, все еще имеет свой порт, пароль, состояние и сеансы. aircode start создает и активирует правильный пример шаблона; старая команда aircode service install сохраняется только для совместимости.

Бесплатный доступ к продукту

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

Команда aircode license сохраняется только для того, чтобы исторические установки могли проверять или удалять прежние записи. Эти записи не изменяют текущий доступ к продукту. Смотрите загрузки, чтобы узнать отдельные требования к учетной записи для управляемого Relay и действий Marketplace.