設定
マネージドインスタンスの場合、優先順位は 環境変数 → instance config → global user config → defaultsです。 aircode start オプションは、サービスが開始される前にインスタンス コンフィギングに保持されます。 aircode serve オプションは、そのプロセスのための環境のみを上回ります。
グローバルファイルは ~/.config/aircode/config.jsonです。 Managed instance files live at ~/.config/aircode/instances/<id>.json; they are not placed in project directories. 管理されたインスタンスファイルは、プロジェクトディレクトリに配置されません。 秘密ファイルは、モード0600を使用します。 ネイティブ Windows フロント オプションは Windows CLI 参照にリストされています。
Per-Instance Launch Configurationの設定
aircode start --projects-root /srv/workspaces --host 127.0.0.1 --port 7860 \
--password-file ~/.config/aircode/workspaces-password
専用フラッグは、 root、name、host、port、public 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 |
Bind address (never 0.0.0.0 by default) |
AIRCODE_PORT |
port |
7860 (新しいインスタンスの自動スキャン) |
ポート 持続的または明示的に設定された忙しいポートは、移動する代わりに失敗します。 |
AIRCODE_AUTH_PASSWORD |
authPassword |
生成 | アクセスパスワード Empty string disables auth (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 | Stable Capability-Scoped Worker Callbacks (安定した能力の範囲の労働者呼び出し) |
| — | updateChannel |
stable |
リリースチャンネル (stable / beta) |
Session hibernation は、最後のターンが持続可能な完成マークと再生可能なトランスクリプトを持っている分離されたランタイムのみを停止します。 作業中、入力待ち、リモートコントロール、またはワークフローが所有しているセッションは、実行されます。 セッションキャップで、 AirCode Ø は、最古の適用可能なランタイムをすぐに冬眠します。 会話は歴史に残り、正常に再開する。
バイナリエンジン(claudeBin、 codexBin、 …)および各機能設定(ブラウザ、知識、オーケストラ、トークン最適化)は、製品内の設定で文書化され、同じ env/file 優先順位を受け入れます。
Docker サンドボックス を参照し、作業員の制限、ネットワーク化、および Docker の完全な構成を参照してください。
ファイルとディレクトリ
| パス | コンテンツ |
|---|---|
~/.aircode/versions/<v> |
the product (immutable, checksummed) 製品 |
~/.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 |
1 つの生成された systemd テンプレートを管理するインスタンスごとに |
~/.local/state/aircode/instances/<id>/ |
孤立したランタイム、トンネル、セッション状態 |
~/.local/state/aircode/relay-account.json |
Managed Relay account credential shared by the Unix user (0600) |
アップデートはインスタンスの 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で明示的に選択します。 新しいポートを含むルートスケープされたコマンドは、意図的に新しいインスタンスとして扱われ、現在のサーバーを静かにオフラインにすることはできません。
Lifecycle コマンドは、名前、完全または短い ID、カノニカル ルート、または現在のディレクトリを承認します。 いくつかの名前付きインスタンスがそれを使用する場合、ルートセレクターは意図的に曖昧であると拒否されます; select the name or ID.
マルチユーザマシン
各 OS ユーザは、別々のレジストリ、グローバルデフォルト、プロバイダの認証、管理された Relay 認証、および systemd ユーザサービスのセットを所有しています。 そのユーザー内では、パス対象のインスタンスは、それぞれ独自のポート、パスワード、状態、セッションを持っています。 aircode start は正しいテンプレートインスタンスを作成し、有効にしますが、古い aircode service install コマンドは互換性のためにのみ保存されます。
無料製品アクセス
自己管理製品は、製品キー、アクティベーション、カード、または試用を必要としない。 完全にオフラインで使用可能であり、旧ライセンスまたは試用記録が終了したときにセッションの開始を制限しません。
aircode license コマンドは、過去のインストールが古いレコードを検査または削除できるように保存されます。 これらのレコードは、現在の製品アクセスを変更しません。 マネージド Relay と Marketplace のアクションに必要なアカウントについては、ダウンロード を参照してください。