语言简体中文

快速启动

选择要在哪里运行 AirCode Ø,然后按照对应的步骤操作:

  • 在线使用,无需安装:在下载页面开始使用 Hosted。你的专属 AirCode Ø 会在浏览器中打开;准备就绪后,继续第 3 步。
  • 在你的电脑上:安装免费的桌面应用,让 AirCode Ø 在这台电脑上运行,然后继续第 3 步。
  • 在 Linux 服务器上:按照下面的全部步骤操作。

无论哪种方式,代理都会使用你自己的 AI 账号,例如 Claude 或 ChatGPT 订阅,或者 API 密钥。

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 。

改用 Docker 运行 AirCode Ø?请按照 安装 → Docker 中的说明启动容器,然后继续第 2 步。

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. 启动你的第一场会议

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

在对话中切换引擎

當您的代理準備好時,請開啟對話的作曲者設定,並選擇另一個 代理。 审查其模型和努力,然后确认 交换机代理。 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 。