言語日本語

インストール

Web App for iPhone, iPad and Android

AirCode Ø ウェブアプリは、永久的なストアなしのクライアントです。 それは、署名されたダウンロードチャンネルにパッケージされていない独自の実行インスタンスによって提供されるので、 Google Play、App Store、TestFlight から独立して利用できます。

  1. AirCode Ø インスタンスを起動し、安定した HTTPS アドレスを与えます。 シェ Quickstart Remote Access
  2. 専用 Web アプリケーションのセットアップを開いて、 HTTPS インスタンスの起源を入力します。 を選択し、 を開くインストールページ。 同じセットアップも利用可能 ダウンロード サイトは、現地で価値を検証し、 は、それを送信したり、保存したりすることはありません。
  3. インスタンスにサイン。 Chromium は、独自のインストール ウィンドウ iPhone を公開します。 iPad ガイド シェア → Home Screen フローに追加します。
  4. インストールしたアイコンを起動します。 を有効にする Push notifications only if you want closed-app alerts; iOS and iPadOS offer that control only from the Home Screen ウェブアプリケーション

インストールはオリジナルスコープ。 HTTP LAN アドレスは、完全なモバイル PWA ターゲットではありませんが、 HTTPS の起源を変更するには、別々のインストールが必要であり、再度認証を必要とする場合があります。 Web アプリケーションは、そのサービス ワーカーを通じてインスタンスから更新しますが、 APK、 IPA、またはストア パッケージではありません。

ウェブアプリは、Responsive Core Workspaceを搭載しています。 Native mobile は、アプリ内サーバーの安全な切り替え、暗号化された管理されたオフラインファイル、信頼性の高い境界の背景タスク、ネイティブの共有/スキャン、ハプティック、通知チャネル優先度、またはオペレーティング システムの深いリンクが必要な場合に、より良い選択肢です。

Linux サーバー

インストーラーは、リリースのマニフェスト、チェックサム、署名の検証にすべて合格した場合にのみ公開されます。コマンドを実行する前に、ダウンロードページでサーバービルドが利用可能になっていることを確認してください。

curl -fsSL https://dl.aircodezero.com/install.sh | bash

このコマンドは最新の stable リリースをインストールします。ベータ版や特定のバージョンを選ぶには、後述のインストーラーオプションを使います。

インストーラー :

  1. あなたのプラットフォームを検出します(linux-x64, linux-arm64),
  2. リリースタールボールをダウンロードし、その sha256 チェックアウトと Ed25519 を確認します。 サイン
  3. ~/.aircode/versions/<version> を ~/.aircode/current シームリンクでインストールします。
  4. aircode を ~/.local/binに接続します。
  5. システム依存性をチェックする(git, tmux)と、あなたが正確に何を をインストールすると、何かが欠けている。

ルートは必要ありません。 すべてはあなたのホームディレクトリに生きています。 インストーラーを再起動すると、インストールを修復または更新します。 ~/.local/bin が現在のシェルの PATHにない場合、最終的な指示は、すぐに実行可能な ~/.aircode/current/bin/aircode パスを使用し、オプションの PATH 輸出も表示します。

次に、選択可能なプロジェクトを含むべきディレクトリからインスタンスを開始します:

cd /srv/workspaces
aircode start

Linuxでは、 aircode start は、パス スケール コンフィギュレーションを作成し、無料ポートを選択し、アクセス パスワードを生成し、印刷し、システムd ユーザー サービスを開始し、クラッシュやリブート後の回復を可能にします。 また、システムd リナーを有効にしようとし、ホストが管理者の承認を必要とする場合に、1 つの正確な修理コマンドを印刷します。 手書きのユニットファイルは必要ありません。

このインストールが aircode.service ユニットを所有している場合、最初の aircode start は、パス範囲サービスを作成する前にそのユニットを安全に削除するので、両方のサーバーが同じポートで競合することはできません。 別のチェックアウトまたはインストールの所有するユニットは、決して変更されません。

インストーラーオプション: --channel beta(既定のチャンネルは stable)、--version x.y.z、--no-modify-path。 歴史的な --service オプションは、古い単一インスタンス ユニットと互換性が保たれ、新しいインストールでは aircode startを使用する必要があります。

システム要件

要件 ノート
Linux x64 / arm64 Ubuntu 22.04+, Debian 12+, Fedora (最近) — glibc
git, tmux sudo apt-get install -y git tmux
エージェント CLI Installed and authenticated with インストール 君の アカウント: 利用 Quickstart でテストされたバージョン バージョン感性 TUI 統合
システムd required for persistent aircode start; not required for front-end aircode serve

Node.js ランタイムは組み込まれています - システムノードは必要ありません。

Docker

公開イメージ aircodezero/aircode は、install.sh がインストールするものと同じ、公開済みの Linux サーバーパッケージを実行します。Node.js、Web クライアント、Claude Code、Codex、Grok Build、Kimi Code が同梱されています。linux/amd64 と linux/arm64 向けに、stable と beta のタグ、および 0.1.30 のような正確なバージョンのタグで公開されています。

任意の Docker ホストで、1 つのコマンドで起動できます。

docker run -d --name aircode --restart unless-stopped --stop-timeout 30 -p 7860:7860 -v aircode-home:/home/aircode aircodezero/aircode:stable

Docker Compose

このサイトでは、すぐに使える compose.yaml を配布しています。専用のディレクトリに保存し、そのディレクトリから起動します。

curl -fsSLO https://aircodezero.com/docker/compose.yaml
docker compose up -d

Hostinger にデプロイ

Hostinger にデプロイ ガイド付きデプロイは、Hostinger を開く前にブラウザーのアクセス情報を準備します。

  1. Ubuntu 24.04 と Docker(x86-64)を備えた VPS を選択します。小規模なテストには KVM 2(2 vCPU、8 GB RAM)が適しています。支払い前に料金と更新条件を確認してください。
  2. Docker Manager が準備済みの設定を開きます。Deploy を選び、プロジェクトの HTTPS Open リンクを使用します。
  3. デプロイを開始したブラウザーで続行し、インスタンスのアドレスを確認してパスワードを設定します。完了するまでブラウザーのサイトデータを保持してください。

初回アクセス

以下は手動で Docker を使う場合(docker run または汎用 Compose)の手順です。Hostinger では上記の HTTPS 設定を使用します。

http://<server-address>:7860 を開きます。初回起動時に、コンテナは生成したパスワードをログに一度だけ出力します。

docker logs aircode

パスワードを自分で決める場合は、コンテナの作成時に環境変数 AIRCODE_AUTH_PASSWORD を設定します。パスワードは後からアプリの設定で変更できます。

プライベート HTTPS アドレス

AirCode Ø で 設定 → リモートアクセス を開き、サインイン を選択して AirCode Ø アカウントを接続します。すると、サーバーは Relay を通じてプライベート HTTPS アドレスを取得します。

https://<name>.tunnel.aircodezero.com

Relay への接続は送信方向のみのため、ポートを開放する必要はありません。詳しくは リモートアクセス を参照してください。

データと更新

プロジェクト、プロバイダーへのサインイン情報、会話、設定はすべて aircode-home ボリュームに保存されます。ボリュームを削除すると、これらも削除されます。

更新するには、新しいイメージを取得してコンテナを作成し直します。Docker Compose の場合は、compose.yaml と同じ場所で次を実行します。

docker compose pull && docker compose up -d

docker run の場合は、イメージを取得し、コンテナを停止して削除してから、同じ docker run コマンドをもう一度実行します。

docker pull aircodezero/aircode:stable
docker stop aircode && docker rm aircode

コンテナは、ボリュームですでに実行したリリースより古いリリースを起動しません。コンテナ内でサーバープロセスが停止すると、コンテナがそれを再起動し、エージェントのセッションはその再起動後も維持されます。

macOS

デスクトップアプリ (お勧め) Download the .dmg から から The ダウンロードページ. それは完全なサーバー(ローカルセッション)を埋め込み、リモートサーバーにも接続します。

ヘッドレス / CLI: Linux と同じ一線器が macOS 13+ (darwin-arm64, darwin-x64) で動作します。 tmux を Homebrew 経由で最初にインストールし、その後 aircode serveを使用します; persistent aircode start currently requires Linux systemd.

Windows

デスクトップアプリを ダウンロードページからからインストールします。 ローカルセッションは、 Windows から ConPTYでネイティブに実行されます。 インストーラはサーバーとその Node.js ランタイムを組み込んでおり、 WSL、 Linux ディストリビューション、システムノードのインストールは必要ありません。 また、現在のユーザーの PATHに aircode を追加し、埋め込まれたサーバーが PowerShell または Command Prompt から実行できるようにします。 設定後、新しいターミナルを開いて、 Windows コマンドライン参照を参照してください。 また、リモート AirCode Ø サーバーに接続することもできます。

Desktop オペレーティングモード

ゴール スタート 結果
リモートクライアントのみ オープン AirCode Ø 選び方 サーバーへの接続 現地設定なし Electron ウィンドウが選択したリモートをロードします。 AirCode Ø サーバー
ローカルクライアント + サーバー Open AirCode Ø, プロジェクト フォルダを選択し、その後 Run on this machine を選択します。 Electron は、埋め込まれたネイティブサーバーを起動し、管理し、その作業スペースをロードします。
サーバーのみ aircode serve --projects-root "D:\Projects" を実行して、PowerShell またはコマンド プロンプトで実行します。 バンドルサーバーは、Electron ウィンドウなしで最前線で実行されます。

--serveでデスクトップ実行を開始しないでください: それは Electron を開いて、サーバーのみモードを提供しません。 aircode コマンドを使用して、 PATH にインストールした端末専用サーバーを使用します。

Local が設定された後、通常のデスクトップの起動は、ウィンドウがリモート サーバーに接続されている間でも、埋め込まれたサーバーが実行されていることを確認します。 デスクトップ管理サーバーは 127.0.0.1でのみ聴きます。 別のデバイスから接続するには、 Remote Access を使用するか、明示的なプライベート ネットワーク バンド アドレスを持つ CLI サーバーを起動します。

Windowsでは、デスクトップのすべてのウィンドウを閉じると、 AirCode Ø とその組み込みサーバーが通知エリアで実行されます。 Quit をそのアイコンから選択して、埋め込まれたサーバーを停止します。 CLI サーバーは別々のプロセスであり、別のポートで共存することができる; デスクトップ アプリの共存を参照してください。

重いオプション部品

大きなものは暗示的にダウンロードされません:

aircode browser install   # pinned Chromium for the agent browser
aircode doctor browser    # verify it

Knowledge は、その設定からローカルな埋め込みモデルを明示的にインストールするまで、レクシカルに留まります。 モデルはその後、オフラインで検証され、インデックスは暗示的なモデルダウンロードを引き起こすことはありません。