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

ここから始める

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

ルートの README が AX Code をインストールする最速の方法なら、このページはそれを理解する最速の方法です。

エディションと提供状況

AX Code Standard から始めてください。個人利用と商用利用のどちらも無料の、オープンソース版です。ローカルまたはクラウドのモデルを使います。AX Engine は、対応する Apple Silicon Mac でネイティブなローカル推論経路を提供します。既存の権限、変更レビュー、ローカルの実行証拠は、中核の能力のままです。

Business は、AX Trust を通じた組織ガバナンスと、AutomatosX を通じた業務ワークフローのための、計画中のプロプライエタリな提供です。仕事で Standard を使うこと自体は、Business ライセンスを要求しません。詳細は Standard と Business を参照してください。

署名されたインストーラーとランタイムアーカイブは、download.ax-code.com から匿名で入手できます。インストールガイド と アップグレードと回復のガイド を読んでください。公開の技術文書は、ソースアクセスとは独立に ax-code.app/ja/docs/ でホストされています。すでにインストール済みですか。プロジェクトでターミナルを開き、ax-code を実行し、その後 TUI の中で /connect を使ってプロバイダーを選びます。プロジェクトについての質問から始め、小さな変更を依頼し、コミットする前に差分とプロジェクトの検査をレビューしてください。インストールされたランタイムの診断が必要なら ax-code doctor を使います。

AX Code とは何か

AX Code は AI コーディングランタイムです。次を組み合わせます。

• 異なるコーディング作業のためのエージェント
• 明示的なツール実行
• モデルとプロバイダーの選択
• 永続するセッション状態
• 設定可能な隔離と権限
• TUI、SDK、サーバーモード、MCP のような連携面

それが重要なのは、実際のリポジトリで AI コーディングが役立つのは、エージェントに許されることを制御でき、セッションをまたいで文脈を保ち、単一のチャット窓の外で同じワークフローを再利用できるときだからです。

価値がどこから来るか

AX Code が最適化するのは、エージェントが終わった あと の瞬間です。それが生んだものを残すかどうかの判断です。

• 証拠。 すべてのセッションは、型付きイベントログとファイルスナップショットとして記録されるため、会話が終わったあと何が起きたかを ax-code graph、compare、replay、risk、audit が再構成できます。
• 検証。 関門を強制できるところ、つまり arena の候補や関門付きリファクタの適用では、リポジトリ自身の型検査、lint、テストコマンドが、結果を受け入れるかを決めます。
• 可逆性。 スナップショットはセッション単位だけでなくステップ単位で回復でき、リポジトリの外に置かれた Git オブジェクトストアから来ます。
• あなたの決定。 AX Code は順位づけ、採点、報告をします。あなたに代わってマージはしません。

これらを支えるのは、権限規則と隔離モードを伴う明示的なツール、永続セッション、リポジトリの慣習のための AGENTS.md、プロバイダーの可搬性、そして TUI、CLI、VS Code 拡張、SDK、ヘッドレスサーバー、MCP 連携の背後にある 1 つのランタイムです。それらは基礎であり、AX Code を選ぶ理由そのものではありません。AX Code を選ぶ理由 を参照してください。

コマンドそのものについては 実行証拠 を参照してください。

メンタルモデル

AX Code を 5 つの層と考えてください。

1. プロバイダー層: 実行したいモデルバックエンドを選びます。
2. エージェント層: 作業に合うエージェントを選ぶか、振り分けに助けさせます。
3. ツール層: エージェントは、隠された能力ではなく明示的なツールを通じて行動します。
4. セッション層: 会話、決定、状態が永続します。
5. 制御層: 隔離、権限、監査の挙動が境界を定義します。

残りの文書は、これらの層に対応します。

次の経路を選ぶ

すぐに試したい

• インストールと最初の起動は ルートの README から始めます。
• 対応するインストール経路は、コンパイル済みランタイムを使います。
  • macOS の Apple Silicon と Linux 向け Bash リリースインストーラー: curl -fsSL -H "Accept: application/vnd.github.raw+json" "https://api.github.com/repos/defai-digital/ax-code/contents/install?ref=main" | bash
  • macOS CLI の Homebrew による代替: brew tap defai-digital/tap && brew trust defai-digital/tap && brew install defai-digital/tap/ax-code
  • Windows PowerShell 向け GitHub リリースインストーラー: powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"
• Bash インストーラーは、正規の Windows セットアップ経路ではありません。
• npm パッケージは、対応するインストールまたはアップグレードのチャネルではなくなりました。プラットフォーム方針、ランタイムラベル、ローカルランチャーの一覧は インストールとランタイムのチャネル を参照してください。
• モデルを設定するには /connect または ax-code providers login を使います。クラウド API プロバイダー、CLI プロバイダー、AX Engine、モデル ID は 対応プロバイダーとモデル を参照してください。費用をかけない評価経路には 無料枠 API クイックスタート を使います。
• 実際のプロジェクトを開いたあと ax-code init を実行し、AGENTS.md がローカルの慣習を捕捉するようにします。
• より厳しい安全境界が必要なら、より広い編集の前に サンドボックスモード を有効にしてください。

チームまたは会社のリポジトリで安全に使いたい

• AX Code は、自律モードをオン、サンドボックスモードをオフで開始します。full-access は、制限のないファイルシステムとネットワークアクセスを伴います。
• チーム、会社、信頼できない、または無人の作業では、タスクを始める前に --sandbox workspace-write（または read-only）を有効にしてください。
• 実行の境界は サンドボックスモード を読んでください。
• エージェントが無人で動く場合は 自律モード を読んでください。
• 脅威モデルと認証情報の保存の詳細は セキュリティ方針 を読んでください。
• 出自と再生がワークフローに重要なら 意味層 を読んでください。

埋め込んだり自動化したりしたい

• TypeScript アプリ連携には、@defai-digital/ax-code-sdk のヘッドレスまたは gRPC の入口を使います。
• サービスの境界、生成されたクライアント、正式な OpenAPI 契約には HTTP と OpenAPI の互換性 を使います。
• エージェントが外部ツールやサービスを必要とするときは ax-code mcp add を使います。

リポジトリを理解したい、またはフィードバックを寄せたい

• 残りの公開文書は 文書ハブ を読んでください。
• 現在の外部貢献方針は CONTRIBUTING.md を読んでください。

AX Code が合わないかもしれないとき

AX Code は意図的に、自動補完やホスト型のチャット箱以上のものです。次の場合は大きすぎるかもしれません。

• インラインのコード提案だけが必要で、エージェントにツールを実行させたくない。
• ローカルランタイムのない、ホスト型 SaaS だけの体験が必要。
• セッションの永続、再生、SDK やサーバーの連携、リポジトリ単位の指示が不要。
• ローカルの CLI プロセスが許されない環境で作業している。

それらの場合は、より軽いエディター支援の方が単純かもしれません。AX Code が最も強いのは、エージェントが制御、継続性、連携の境界を伴って、実際の開発ワークフローの中で動く必要があるときです。

よく使う最初のコマンド

ax-code
ax-code providers login
ax-code models
ax-code run --model qwen -- "Review this change"
ax-code init
ax-code index
ax-code mcp add
ax-code doctor

Grok は Grok Build CLI を通じてのみ動きます。grok-build-cli を選んでください。場所は /connect です。AX Code はローカルの grok コマンドを呼び出し、その CLI のログインまたはセッションを再利用します。以前の直接の xai クラウド API プロバイダーは、もうサポートされません。

文書マップ