このページは英語版ドキュメントの翻訳です。コマンド、識別子、例はそのままです。ランタイム 7.24.4 · SDK 2.6.7。 英語版

インストールとランタイムのチャネル

ステータス: 現行 対象範囲: 現在の状態 最終確認: 2026-10-09 所有者: ax-code runtime

ルートの README が主なインストール経路を保ちます。このページは、対応する CLI インストーラーのチャネル、ax-code doctor のランタイムラベル、ローカルランチャーの挙動、公開アップグレードの挙動についての信頼できる情報源です。

公開での提供

公開リリースのインストーラーと署名されたランタイムアーカイブは、download.ax-code.com を通じて配布されます。インストールに非公開の GitHub 認証情報は不要です。

AX Code と SDK がサポートするのは Node.js 26 以降だけ です。スタンドアロンのインストーラーは、検証済みの Node ランタイムを同梱します。ソースチェックアウトと Node ベースの SDK アプリケーションは Node.js 26 以降を用意しなければなりません。パッケージのインストールは、より古い Node の版を拒否します。

AX Code Standard は、既存のライセンスのもと、個人利用と商用利用のどちらも無料のままです。開発ソースへのアクセスは、公開配布とは別に管理されます。計画中のプロプライエタリな Business コンポーネントには別のライセンスがあります。これは Standard のライセンスを変えません。詳細は Standard と Business、公開インストールの更新は ウェブサイトの案内 を参照してください。ウェブサイトが 1 行のインストールコマンドを宣伝する前に、公開インストーラーとその署名済み資産は到達可能で、検証されていなければなりません。

リリースの提供状況

vMAJOR.MINOR.PATCH の git タグを push すると、Release ワークフローが始まります。公開リリース索引 の一覧が版を示すのは、そのワークフローが資産に署名して公開したあとだけです。それまでは、Latest は以前に公開されたタグのままです。検証が成功したあと、メンテナーは新しいタグの Draft を見られます。それは公開の Latest ではありません。

既存のインストールについては アップグレードと回復 に従ってください。

推奨経路

チェックアウトから開発しているのでなければ、対応するパッケージ済みインストーラーを使います。リリースインストーラーは macOS と Linux での主な CLI 経路です。Windows ではネイティブの PowerShell インストーラーを使います。

macOS（Apple Silicon）

curl -fsSL https://download.ax-code.com/install | bash

Windows

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"

Ubuntu 24.04 以降

curl -fsSL https://download.ax-code.com/install | bash

Homebrew は、macOS CLI の対応する代替のままです。

brew tap defai-digital/tap
brew trust defai-digital/tap
brew install defai-digital/tap/ax-code

Homebrew は、公式でない tap に対して明示的な信頼を要求します。この tap 全体の信頼は、defai-digital/tap で公開される現在および将来の formula、cask、外部コマンドをすべて覆います。共有 tap には CLI の formula と Desktop の cask の両方が含まれ、Homebrew はインストールを解決するあいだ両方の定義を読み込めます。tap 全体の信頼を受け入れられない場合は、リリースインストーラーを使ってください。

既存のインストールをレガシー tap から移す

defai-digital/ax-code は今、移行専用の tap です。AX Code のリリースが更新するのは defai-digital/tap だけです。レガシー tap からインストールした場合は、更新の前に共有 tap を追加し、Homebrew がインストール済みパッケージの tap 所有権を移せるようにします。

brew tap defai-digital/tap
brew trust --formula defai-digital/tap/ax-code
brew update
brew upgrade defai-digital/tap/ax-code
brew info defai-digital/tap/ax-code

インストールが共有 tap を使っていることを確認したあと、レガシー tap を取り除きます。

brew untap defai-digital/ax-code

Homebrew がまだ古い tap を報告する場合は、untap する前に brew reinstall defai-digital/tap/ax-code を実行します。レガシーリポジトリは、既存のインストールが移行を発見できるよう、アクセス可能なままです。

版を固定した Unix インストーラーを検証する

検査済みで版を固定した Unix インストールでは、まず同じリリースからインストーラーとその署名をダウンロードします。信頼された minisign がすでに使えるとき:

AX_INSTALL_VERSION="<release>"
AX_INSTALL_BASE="https://download.ax-code.com/releases/download/v${AX_INSTALL_VERSION}"
curl -fsSL "$AX_INSTALL_BASE/install" -o ax-code-install
curl -fsSL "$AX_INSTALL_BASE/install.minisig" -o ax-code-install.minisig
minisign -Vm ax-code-install -x ax-code-install.minisig -P 'RWSlDu++afxCz01OqhYWhfo8+L8pVbSYXJBEb2zoWBuK0WACIzbGVZRO'
# Inspect ax-code-install before running it.
bash ax-code-install --version "$AX_INSTALL_VERSION" --no-modify-path

アーカイブの署名は、実行前のブートストラップスクリプトを認証しません。同じオリジンからダウンロードしたダイジェストは破損を検出しますが、独立した発行者の同一性検査ではありません。1 行の経路は HTTPS の配布エンドポイントに依存します。

1 行のリモート実行は便宜の経路です。Windows インストーラーは、開始後にダウンロードした CLI の ZIP を minisign で検証しますが、irm | iex は実行前に install.ps1 自身を検証しません。

minisign がまだ PATH にない場合、PowerShell インストーラーはピン留めされた minisign 0.12 のアーカイブを download.ax-code.com からダウンロードし、その SHA-256 を確認し、抽出した実行ファイルをキャッシュする前に再度確認します。既定のインストール経路では、minisign を手動でインストールする必要はありません。PATH にすでにある minisign バイナリは、そのまま使われます。

セキュリティに敏感な環境では、インストーラーをダウンロードし、minisign で検証し、検査し、CI が使うリリース版を固定します。

$AX_CODE_VERSION = "<release>"
$AxCodeMinisignPublicKey = "RWSlDu++afxCz01OqhYWhfo8+L8pVbSYXJBEb2zoWBuK0WACIzbGVZRO"
irm https://download.ax-code.com/install.ps1 -OutFile ax-code-install.ps1
irm https://download.ax-code.com/install.ps1.minisig -OutFile ax-code-install.ps1.minisig
# Optional: use a preinstalled minisign, or let install.ps1 bootstrap one when verifying the archive.
minisign -Vm ax-code-install.ps1 -x ax-code-install.ps1.minisig -P $AxCodeMinisignPublicKey
Get-Content .\ax-code-install.ps1
.\ax-code-install.ps1 -Version $AX_CODE_VERSION -NoModifyPath

検証できないリリースのダウンロードを意図的に受け入れるときだけ、AX_CODE_SKIP_MINISIGN_VERIFY=1 を設定します。

インストールされたランタイムを検証します。

ax-code doctor

対応するユーザーインストールは、macOS、Windows、Linux（glibc）で Runtime: Node vX.Y.Z (node-bundled) を報告するべきです。

これらのインストーラーが配布するのは CLI/TUI ランタイムです。Desktop リリースの所有は AX Coder にあり、新しい Desktop リリースは現在凍結されています。この案内は Desktop のインストールまたはアップグレードのチャネルを提供しません。

チャネルの一覧

node-bundled と source はランタイムモードであり、パッケージマネージャーの名前ではありません。どの実行ファイルがアプリのコードを読み込むかを述べます。

• node-bundled: Node.js が同梱リリースランタイムを読み込みます（対応するすべてのユーザーインストールチャネル）。
• source: Node がチェックアウトからファイルを直接読み込みます。

compiled と bun-bundled は廃止された Bun 時代のランタイムモードで、レガシー診断のためだけに残されています。対応するユーザーインストールチャネルではありません。

pnpm dev と pnpm cli は、起動前にワークスペース SDK（packages/sdk/js）をリポジトリの TypeScript で dist へコンパイルするため、新鮮なチェックアウトは手動の SDK ビルドなしで走ります。その手順は typescript/bin/tsc を node を通じて直接呼び出すため、node_modules/.bin がリンクされていることに依存しません。同梱経路（pnpm run setup:cli と pnpm --dir packages/ax-code run build）は、引き続き先に pnpm --dir packages/sdk/js run build が必要です。

プラットフォーム方針

• macOS: 文書化された主な CLI 経路として bash のリリースインストーラーを使います。~/.ax-code の下にインストールし、必要ならピン留めされた Minisign を起動し、リリースアーカイブを検証し、Homebrew は不要です。darwin-arm64 のアーカイブには、ローカル推論のための自己完結の AX Engine サイドカーが含まれます。貢献者ビルドは pnpm run setup:cli を使います。
• 対応する Homebrew 経路は、完全修飾のインストールコマンドを使う前に、defai-digital/tap を明示的に tap して信頼します。tap 全体の信頼には、共有 tap の現在および将来の formula、cask、外部コマンドがすべて含まれます。その信頼の範囲を受け入れられないときは、bash のリリースインストーラーを使います。
• Linux CLI: amd64 と arm64（glibc）上の Ubuntu Desktop/Server 24.04 LTS 以降には bash インストーラーを使います。リリースビルドは Ubuntu 24.04 のランナーで ax-code-linux-x64.tar.gz と ax-code-linux-arm64.tar.gz を作るため、glibc の基準線は 24.04 以降と互換のままです。Musl（Alpine）は、現在のリリースアーカイブではサポートされません。
• macOS CLI のアーカイブ: リリースビルドが公開するのは darwin-arm64 だけです（Apple Silicon）。Intel macOS は、現在の CLI/Desktop パッケージの対応インストール対象ではありません。
• Windows CLI: ネイティブの PowerShell インストーラーを使います。GitHub リリース資産をユーザーローカルのディレクトリへインストールし、-NoModifyPath が渡されない限りユーザーの PATH を更新します。抽出の前に、ダウンロードした ZIP をピン留めされた公開鍵で検証し、AX_CODE_SKIP_MINISIGN_VERIFY=1 が意図的に設定されない限り失敗時に閉じます。minisign がない場合、インストーラーはピン留めされた minisign 0.12 のアーカイブを download.ax-code.com から %LOCALAPPDATA%\ax-code\tools\minisign へダウンロードし、キャッシュする前に抽出した実行ファイルを確認します。PATH にすでにある minisign バイナリは、そのまま使われます。ユーザーローカルのインストールと PATH 項目を取り除くには -Uninstall を使います。
• Windows Desktop: GitHub Releases の署名された Electron インストーラーを使います。名前は AX-Code-<version>-win-x64.exe または AX-Code-<version>-win-arm64.exe です。期待される Authenticode の発行者は DEFAI Private Limited です。install.ps1 を Desktop インストーラーとして説明しないでください。サイレントインストール: .\AX-Code-<version>-win-x64.exe /S（NSIS）。
• Winget: パッケージマニフェストは pnpm exec tsx tools/winget/generate-manifests.ts --version <ver> で生成され、microsoft/winget-pkgs へ提出されます（tools/winget/README.md を参照）。上流で公開されるまでは、GitHub Releases が Windows インストールの信頼できる情報源のままです。
• npm: 対応するインストールまたはアップグレードのチャネルではありません。

1 行のリモート実行は便宜の経路であり、唯一の経路ではありません。文書には検査できる（Windows では minisign で検証された）インストーラー手順を残し、CI では固定した版を使い、プラットフォームのインストーラーを文書化するのは、ax-code --version を検証し、ax-code doctor がそのプラットフォームで期待されるランタイムモードを報告することを検証するインストール一覧のカバレッジがあるときだけにしてください。

企業と無人のインストール

Windows CLI（ユーザーローカル、管理者不要）

# Pin version in CI/images
$env:AX_CODE_VERSION = "7.9.4"
irm https://download.ax-code.com/releases/download/v$env:AX_CODE_VERSION/install.ps1 -OutFile install.ps1
# Optional: verify install.ps1.minisig first (see SECURITY.md)
.\install.ps1 -Version $env:AX_CODE_VERSION -NoModifyPath
# Then add %USERPROFILE%\.ax-code\bin to the machine/user PATH via your MDM.

macOS（ユーザーローカル / Homebrew / MDM）

Homebrew なしのユーザーローカル CLI インストールには、リリースインストーラーを使います。

curl -fsSL https://download.ax-code.com/install | bash

管理された Mac は Homebrew formula を使い、CLI の更新が tap に従うようにできます。

brew tap defai-digital/tap
brew trust defai-digital/tap
brew install defai-digital/tap/ax-code

MDM でパッケージされた DMG インストールには、GitHub Releases の公証された AX-Code-*-mac-arm64.dmg を使い、方針がサプライチェーン検査を要求するときは分離された .minisig を検証します。

Winget の提供状況

検証されたコミュニティの CLI パッケージが使えるのでなければ、公開インストーラーを使います。GitHub がホストするマニフェストの束が匿名でアクセスできると仮定しないでください。

更新

アクティブなインストールを所有するチャネルを選んでください。

既存のレガシータップ利用者は 共有 tap への移行 に従ってください。2 つ目のインストールが PATH 上で最初のものを隠すことがあります。チャネルを変える前に which -a ax-code、ax-code --version、ax-code doctor を使ってください。スタンドアロン版をインストールしても Homebrew はアンインストールされません。チャネル間の移動は意図的にだけ行い、セッションと設定のデータは保持してください。

Unix の自己アップグレードは、対象リリースからインストーラーを取得し、その SHA-256 サイドカーを要求します。インストーラーまたはダイジェストが欠けるとアップグレードは止まります。可変の main へのフォールバックはありません。インストーラー資産のないリリースからより古いアーカイブをインストールするには、現在リリースされているインストーラーをダウンロードして検証し、その後 --version <older-version> 付きで実行します。

スタンドアロンの Unix インストールは ~/.ax-code/bin/ax-code を、~/.ax-code/versions/ の下にある一意なランタイム世代への安定したシンボリックリンクとして使います。インストーラーは、そのリンクを切り替える前に新しいツリー全体を検証します。版を再インストールすると新しい世代が作られます。古い世代とレガシーのランタイムファイルは保持されるため、すでに動いているエージェントは自分のモジュールを読み込み続けられます。動いているエージェントは再起動しません。新しい版を使うには新しいクライアントまたはランタイムを開始してください。ランタイムを再起動する前に、アクティブな作業を明示的に止めてください。Homebrew のファイルは引き続き Homebrew が管理します。

ロールバックには、検証されたインストーラーを --version <previous-version> 付きで使います。保持された各世代の version ファイルが、そのリリースを識別します。古い世代は自動では刈り込まれません。それらを使うすべてのプロセスを止めたあと、未使用の世代を取り除けます。アンインストールのあいだ、必要なら --keep-data --keep-config でセッションと設定を保持してください。バイナリ除去の案内に従い、未使用のランタイム世代は、そのプロセスが止まったあとだけ別に取り除きます。他の設定や個人ファイルをそこに保存している場合は、.ax-code フォルダ全体を削除しないでください。

同時の Unix インストールは、.install-lock ディレクトリの位置で失敗します。突然終了したインストーラーは、その空のディレクトリを残すことがあります。古いロックを取り除いて再試行する前に、アクティブなインストーラーがないか確認してください。インストールが動いているあいだは取り除かないでください。

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"

Windows では、これは CLI を更新します。CLI インストールとそのユーザー PATH 項目を取り除くには次のようにします。

irm https://download.ax-code.com/install.ps1 -OutFile ax-code-install.ps1
.\ax-code-install.ps1 -Uninstall

貢献者ランチャーの挙動

この節には認可されたソースチェックアウトが必要です。公開インストールやアップグレードには不要です。ソースアクセス を参照してください。

pnpm run setup:cli は意図的に、既定ではコンパイル済み経路です。packages/ax-code/dist/... の下にあるローカルの同梱バイナリをビルドまたは再利用し、そのバイナリを指すグローバルランチャーをインストールします。これにより、ローカルのパッケージ済みランタイム検査は、Homebrew と curl インストーラーの利用者が実行するものに近く保たれます。

そのランチャーは通常 ~/.local/bin または PNPM_HOME に置かれ、これは典型的には Homebrew より PATH 上で前です。Homebrew がすでに ax-code を提供している場合、setup:cli はチェックアウトを ax-code-src としてインストールし、以前に書かれた ax-code ラッパーを取り除くため、brew upgrade ax-code は ax-code コマンドを更新し続けます。pnpm run setup:cli -- --override-homebrew を使うのは、チェックアウトに ax-code を意図的に引き継がせたいときだけです。ax-code doctor は引き続き、その上書きを PATH launchers として警告します。

パッケージ済みランタイムに影響すべきソース変更のあと、グローバルランチャーを試す前に同梱バイナリを更新します。

pnpm --dir packages/ax-code run build -- --single
pnpm run setup:cli -- --rebuild
ax-code-src --version   # or `ax-code` if Homebrew is not installed

チェックアウトのコマンドに、このチェックアウトをソースファイルから Node を通じて実行させたいと意図するときだけ、ソースランチャーを使います。

pnpm run setup:cli -- --source
ax-code-src doctor      # or `ax-code doctor` if Homebrew is not installed

ソースランチャーは Runtime: Node vX.Y.Z (source) を報告するべきです。

ツールチェーンの要件

リポジトリは pnpm@10.33.4 を強制します。経路はルートの packageManager フィールドと only-allow pnpm です。preinstall フックが pnpm 以外のインストールを遮断し、ルートの pre<script> フックが同じ要件で npm run <script> を遮断します。Node.js はルートの package.json エンジン（>=26）と一致しなければなりません。それはソースモードの TUI コマンドのための --experimental-ffi も提供します。

ルートの pnpm test を使わないでください。ルートスクリプトは意図的に do not run tests from root で終了します。packages/ax-code については、packages/ax-code/ からテストを実行します。

Homebrew のインストールは、自動のバックグラウンドアップグレードなしで更新通知を受け取ります。明示的にアップグレードする、または古い Homebrew の keg を掃除する前に、アクティブなエージェント実行を終えてください。