快速启动

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默认情况下是持久的:系统d 在发生故障后重新启动服务器,并在启动时重新启动。对于与当前终端相关的前台流程,请使用 aircode serve 。

2. 开启驾驶舱

在任何可以访问机器并使用密码登录的设备上打开打印的 URL 。对于可安装的手机或平板电脑客户端,首先通过远程访问给该实例一个稳定的 HTTPS 地址,然后选择以下途径之一:

在 Web 应用程序设置中,只输入该 HTTPS 实例地址,然后选择 打开安装页面。相同的设置仍然可用在下载地址在您的浏览器中被验证,并且是从未发送到或存储在营销网站。
在实例本身上,登录并选择 安装 web 应用程序 从更多或 设置 → Web 应用。
在 Chromium 中,接受浏览器所有的安装提示。 iPhone 或 iPad上的, 按照产品指南选择 分享 → 添加到 Home Screen,保持 在显示时打开 Web App 启用,然后启动新的 Home Screen 图标。

网页应用程序始终可作为商店免费客户端使用;它不依赖 Google Play、App Store、TestFlight或可下载的版本宣言。一般的 HTTP LAN 地址仍然可以在浏览器中打开,但移动安装、服务人员和 Web Push 需要 HTTPS。

3. 启动你的第一场会议

选择一个项目目录。
选择执行环境:

局部通过主机 tmux 或 Windows ConPTY 运行。
Docker 沙盒 在工作者中运行一个受支持的直接会话,而安装所选项目。

发动机( )Claude Code, Codex, Antigravity CLI, Grok Build, Kimi Code) 和允许模式。
发射代理在 AirCode Ø 机器上继续运行 — 关闭选项卡, 火车,回来:它仍然工作。通知 ping 您当代理需要输入或完成。

Web、桌面和原生移动发射器暴露了相同的环境选择。 Docker 目前是 Codex 源预览;请参阅 Docker 沙盒启用绕过权限之前。

在对话中切换引擎

當您的代理準備好時,請開啟對話的作曲者設定,並選擇另一個代理。审查其模型和努力,然后确认 交换机代理。 Claude Code, Codex, Grok Build 和其他可用的引擎共享相同的对话界面。您的项目保持在位,并进行一个背景检查点。发送你的下一个消息继续与新代理。

与多模型团队合作

在 新会话中,选择 多模型 → 现在构建。选择每个角色的引擎、模型和努力: 作者, 审查员 和 最终仲裁员。例如, 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

从实例 root 运行生命周期命令,或者通过其名称,完整 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中明确。

一个 Canonical 路径通常将地图转到一个默认实例。请求来自该根的另一个明确端口创建一个独立的自动命名实例,而不是更改或重新启动默认的:

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 启用状态均保持隔离。 Managed Relay 拒绝没有密码的实例。使用 aircode logout 删除机器身份证件, --relay private 用于没有公共隧道的 VPN ,或 --relay off 以禁用隧道而不忘其所选择的运输。

7. 安装代理 CLIs

包装的 AirCode Ø 版本已经携带了它们的附加 CLI。要进行源检查,安装并在同一 Unix 用户下验证 CLI。目前的分布目标是:

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 云项目	原生帐户目录
Grok Build	`grok login` 具有 Grok 订阅或企业 SSO	`XAI_API_KEY`
Kimi Code	Kimi Code 奥斯卡	Moonshot API 证件

Google 退休了 Gemini CLI 用于 2026 年 6 月 18 日的个人帐户,并在 Antigravity 套件中指导该计划。 AirCode Ø 遵循这一动作: Antigravity CLI 是 Google 引擎,而 Gemini CLI 已无法选择。在改变之前创建的会话在历史中可读。请参见官方过渡通知。

Antigravity 订阅不需要连接: Google 帐户获得基线计划,而Pro和Ultra增加了模型访问和限制。 AirCode Ø 使用由 agy models返回的帐户特定的目录。 Google的 Antigravity 计划和模型目录。

若要查看 API 提供商配置文件,请打开 AI 使用,选择提供商,然后单击连接。 AirCode Ø 验证了提交的密钥,将其本地存储在 ~/.config/aircode/providers.env 中的私有权限中,并立即激活用于新会话。相同的屏幕可以替换或切断键。通过服务器环境提供的密钥仍然受支持,并显示为外部管理,而不是在用户界面中可编辑。

GLM / Z.AI、DeepSeek、MiniMax 和 Meta / Muse Spark 在 v1 中暂时不可用，需先验证它们在实际使用中的可用性和可靠性。集成代码会保留，以便将来恢复；在暂停期间，无法选择、连接或启动这些提供商。现有对话和使用历史仍可查看。

Kimi Code 仍可使用其原生 Moonshot 模型。AirCode Ø 仅将凭据传递给使用相应提供商的会话，绝不会通过 API 返回凭据。

Grok 在 XAI_API_KEY之前使用已存储的浏览器会话;当您明确想要 API-key path 时,运行 grok logout 。