語言繁體中文

快速啓動

選擇要在哪裡執行 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 。