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

AX Code の文書

ステータス: 現行 対象範囲: 公開、現在の状態 最終確認: 2026-10-09 所有者: AX Code メンテナー

AX Code は、レビューでき可逆な作業のためのコーディングエージェントランタイムです。すべてのセッションはファイルスナップショット付きの構造化イベントログとして記録され、候補の実装はリポジトリ自身の検査に対して検証でき、何も自動ではマージされません。AX Code を選ぶ理由 が、それが何を最適化するか、誰のためか、何を意図的に主張しないかを説明します。

ルートの README が、AX Code をインストールして起動する最短経路です。ワークフローを設定する、ランタイムの境界を理解する、または AX Code を別のシステムと連携する必要があるときは、このハブを使ってください。

内部のプロセス記録（PRD、ADR、仕様、ロードマップ、実装計画、競合レビュー、監査の作業ファイル）は .internal/ の下にあり、この公開ツリーにはありません。下記の「文書の境界」を参照してください。公開ページは、ここからリンクされているものです。

公開ウェブサイト: ax-code.app/ja/docs/。 既存のインストールは アップグレードと回復 から始めてください。 ソースアクセスと公開ダウンロードは別です。ソースアクセス を参照してください。

作業から選ぶ

外部 MCP クライアントを通じた、オプトインの共有ターミナル移動については MCP でライブの TUI を共有する を参照してください。

実験的なブラウザーブリッジ（ページを読み、任意でクリックと入力）については WebMCP ブラウザーブリッジ を参照してください。

AX Trust のキャッシュを通じた、選ばれたファイルについての単独の質問は 固定文脈の質問 を参照してください。

はじめに

• Standard と Business — オープンソースの Standard、無料の商用利用、計画中のプロプライエタリな Business、公開アクセスの状態。

• AX Code を選ぶ理由 — AX Code が何を最適化するか、想定する読者、違い、主張しないこと。

• ここから始める — 製品のメンタルモデルと、用途別の最短経路。

• インストールとランタイムのチャネル — 対応プラットフォーム、パッケージ、更新、貢献者ランチャー。

ランタイムガイド

• Wiki 証拠の可視化 — 記録された Wiki ページとソースの関係のローカルグラフを開くか、オフライン HTML を書き出します。AX Code 自身の wiki からの、放射状、力学、ページフォーカスのスクリーンショットを含みます。
• 会話の振り返り — /recap で最近の作業に追いつき、アイドルバナーを設定します。
• 音声通知 — 実行が注意を必要とするときの、システムの音とオプトインの読み上げアラート。
• 実行証拠 — グラフ、比較、再生、リスク、ロールバック、ブランチ、追跡、監査エクスポート。
• 検証された複数モデルの変更 — 合議と arena のワークフローを端から端まで。
• サンドボックスモード — 隔離モード、保護パス、ネットワーク制御、優先順位。
• クラウド運用モード — 計画、承認、適用のワークフロー、承認トークン、cloudops エージェントの姿勢。
• 自律モード — 無人実行、承認、ヘッドレス利用、安全装置。
• ヘッドレス CLI — スクリプト、CI、エージェント呼び出し側のためのワンショット ax-code run コマンド。
• TUI の言語とセットアップ — インターフェースと言語、会話の言語、初回セットアップ。
• TUI アニメーション — 開始と終了の組、ターミナル能力、描画のフォールバック。
• ループモードとスケジュールタスク — 繰り返すプロンプト、永続スケジュール、長い実行の上限。
• 長時間の運用 — 監視付きサービスの例、回復の意味、運用上の確認。
• 実行モード — エージェント、ハイブリッド、合議、arena の挙動。
• 複数モデル振り分けの良いやり方 — 高価な推論と低コストの支援作業を分け、正しさに敏感なタスクを黙って弱めない。
• モデル回復 — 正確なモデル選択、明示的なフォールバック設定と診断。
• 自動ルート — 専門家の振り分けと、任意の複雑さ振り分け。
• モデルの努力度 — 思考レベルとプロバイダー固有の挙動。
• 性能 — コーディングツールのプロファイルと、ローカル要求計時の診断。
• メモリ使用量 — メモリプロファイル、キャッシュ保持、背景出力の上限。
• ローカル証拠キャッシュ — 任意の SQLite と RocksDB による証拠の再利用、適格化、ロールバック。
• ライフサイクルフック — フックイベントと同梱ポリシーパック。
• 実行報告 — ワークスペースの使用量、活動、モデルとツールの内訳、セッションごとの報告。

プロバイダー

• 対応プロバイダーとモデル — プロバイダー ID、認証情報、モデル検出。
• 無料枠 API クイックスタート — 互換性のある無償経路、制約、安全な評価。
• カスタムプロバイダーとゲートウェイ — OpenAI 互換および Anthropic 互換のエンドポイント。
• MTPLX と oMLX のセットアップ — ソースチェックアウトのローカルプリセット、検出、ツール、認証。
• Tiel の同格要約（20 September 2026） — 現在の Tiel / Cyber-Tiel 対 MTPLX のネイティブ API 数値。補完の既定 194.88、デコードのピーク 249.01。
• AX Code / OpenCode クライアント再試験 — 6 つのクライアントとランタイムの組み合わせ、有効な MTP、初回と繰り返しの計時、コード検査。
• ローカル推論の測定 — 日付付きの AX Code / OpenCode とランタイムの試験。計時と比較可能性の限界付き。
• AX Engine のモデル選択 — ローカルモデルの順位とメモリの案内。

連携

• MCP 連携 — 信頼、権限、リソース、サーバーのセキュリティ。
• ACP — IDE ホスト向けの Agent Client Protocol の基本手順。
• AX Wiki — ソースに裏打ちされたリポジトリ知識と CI ワークフロー。
• VS Code 連携 — エディターのコマンド、設定、ワークフロー。マーケットプレイスの一覧 からインストールします。

SDK とサービスの境界

• @defai-digital/ax-code-sdk — 第一者の TypeScript と JavaScript の埋め込み。
• ネイティブ SDK トランスポート — gRPC 形のデスクトップおよびネイティブの境界と、フォールバックの挙動。
• HTTP と OpenAPI の互換性 — サーバーモードと、他言語向けに生成されたクライアント。
• OpenAPI スナップショット — 正式な HTTP 経路とスキーマの契約。

アーキテクチャと信頼性

• 意味層 — グラフと LSP の出自、監査、再生の境界。
• ローカルエンジンのアーキテクチャ — AX Code が AX Engine サイドカーを使う理由。
• ランタイムの安定性 — 取り消し、クラッシュ、ストリーム、タイムアウト、TUI の信頼性契約。

リファレンス

• 設定 JSON スキーマ — 生成された設定入力の契約。

• TypeScript ネイティブサポート — ソースコンパイラ、言語サービス、診断、互換性。

• スキルとプラグインのカタログ — 同梱スキル、プロジェクトスキル、プラグイン、評価。

• 隔離ポリシーパック — 機械可読なポリシー例。

• リリース検証 — 正規の minisign 公開鍵と検証コマンド。

• Windows ランタイムの完全性 — 署名、インストール済みファイルの検証、ウイルス対策の証拠。

• セキュリティ方針 — 脅威モデル、認証情報の保存、サポートされる版。

文書の境界

docs/ には、リリースされたランタイムに存在する挙動のための公開案内が含まれます。計画資料、リリース目標、実装方針、一時的な分析は、ここには属しません。

すべての公開 Markdown ページは、上部近くで状態、対象範囲、最終確認日、所有者を宣言するべきです。コピーされた経路一覧や、ずれやすい他のスナップショットより、生成された契約や実装ソースへのリンクを優先してください。

保守チェックリスト

リリースの前、または実質的な文書変更の前に:

1. コマンド、既定、フラグ、プロバイダー ID、ランタイムラベルを、実装と照合します。
2. 同じ挙動を複数の入口ページで繰り返すのではなく、最も狭い正式なガイドを更新します。
3. pnpm run test:scripts を実行し、壊れたローカルリンク、孤立ページ、欠けたページメタデータを捉えます。
4. 承認されたエクスポートマニフェストを更新し、node script/export-public-docs.mjs --website /path/to/ax-code.app を実行してから、ウェブサイトの検査、ビルド、Workers のスモーク検査を実行します。ウェブサイトのビルドはコミットされたスナップショットを使い、ソースアクセスは不要です。新しい公開ページと資産は、マニフェストで明示的に承認されなければなりません。
5. 提案、プロジェクト開発のメモ、リリース目標、過去の決定記録は .internal/ の下に置き、公開ナビゲーションには置かないでください。