コーディングワークフローの中身
実行を確かめる。
残すものを選ぶ。
AX Code はエージェントハーネスです。モデルをプロジェクトのツール、セッション記録、レビューの流れにつなぎます。価値は、エージェントがコードを編集した後に実行内容を確認・検証・復元できる点にあります。
一つのバグと、レビューできる変更
このウォークスルーでは例示用のタスクを使用しています。以下のコマンドは実際の AX Code インターフェースを示していますが、例のセッション ID はご自身のものに置き換えてください。このページでモデルは動作していません。
01 · モデルに接続し、権限の範囲を決める +
リポジトリで AX Code を開き、/connect で対応するローカルランタイム、クラウド API、コーディング CLI、プライベート GPU エンドポイントを選びます。見慣れないコードにアクセスを許可する前に、サンドボックスと権限の設定を決めておきましょう。通常のセッションでは、プロジェクトのテストスイートは自動的に実行されません。
ax-code --sandbox read-only
02 · 問題を調べ、変更を許可する +
空入力を許可している箇所と関連テストの特定をエージェントに依頼します。調査結果をレビューし、許可する書き込み範囲を有効にして、対象を絞った修正を依頼しましょう。チームの調査・レビュー手順は再利用可能なスキルとして提供できます。
空白のみの入力が許可される理由を調べて。変更前に該当するコードとテストを見せて。
03 · 変更を検証し、実行を確かめる +
リポジトリのチェックを実行し、差分を確認します。セッショングラフで記録された手順やツール呼び出しを確認しましょう。記録されたチェックの失敗は失敗のままです。エージェントの完了メッセージはパッチの正しさの証明にはなりません。
git diff
ax-code graph <session-id>
04 · 試行を比較し、復元ポイントを確認する +
2つのセッションを比較して、実行内容とリスク兆候の変化をレビューします。復元手順を選ぶ前に、利用可能なロールバックポイントを一覧表示してください。復元は保存されたスナップショットに依存し、送信済みメッセージやリモートデプロイといった外部への副作用は取り消せません。
ax-code compare <session-a> <session-b>
ax-code rollback <session-id> --list
既存の CLI を接続する
対応する CLI をインストールしてログインし、下のプロバイダー ID を使って AX Code に接続します。アダプターは CLI のローカルのログイン状態とセッションを再利用します。
| コーディング CLI | プロバイダー ID | ローカルコマンド |
|---|
| Claude Code | claude-code | claude |
| Codex CLI | codex-cli | codex |
| Grok Build CLI | grok-build-cli | grok |
| Muse Code CLI | muse-cli | muse |
CLI プロバイダーはいずれもベンダー CLI 自身のログインを再利用します。まずその CLI をインストールしてログインし、表のプロバイダー ID で AX Code に接続してください:
ax-code providers login <provider-id>
AX Code のスキルとリポジトリチェックでタスクを整理し、記録されたセッションと結果の差分をレビューしましょう。機能と可視性はアダプターと CLI に依存します。連携だけではコーディング精度が向上するわけでも、内部の操作がすべて見えるわけでもありません。
CLI プロバイダーのセットアップと要件 ↗別の視点で確認する
Claude Code、Codex CLI、Muse Code CLI、Grok Build CLI をプロバイダーとして選び、対応するクラウド API、ローカルモデル、プライベート GPU エンドポイントと組み合わせましょう。Council で複数の接続済みプロバイダーから独立したレビューを集めたり、Arena で候補となる解決策を比較したりできます。参加できるメンバーは接続状況とモデルの能力によります。Council は助言であり、結果をレビューして採用するか決めるのはあなたです。
マルチモデルワークフローガイド ↗自分の GPU 基盤で、自分のモデルを
プライベート GPU クラウドや自身の GPU サーバーを OpenAI 互換エンドポイント経由で接続します。/connect で Private GPU cloud → Custom provider を選び、エンドポイント URL と API キーを入力して、検出されたモデルを選択します。サーバーはモデル検出を公開し、コーディングタスクに必要なモデル能力をサポートしている必要があります。
プライベート GPU 接続ガイド ↗WebMCP:エージェントをブラウザーに接続
WebMCP は、サイトが構造化されたツールをエージェントに公開するための提案段階のウェブ標準です。AX Code はツールの検出と呼び出し、ページのスナップショットやスクリーンショットの読み取り、コンソールメッセージとリクエストのメタデータの確認、ページ上の操作を行えます。
WebMCP とブラウザー操作を詳しく見る ↗一度の試行を超えて
Arena implement モードは、分離された Git worktree で候補となる解決策を実行し、リポジトリのチェックで評価します。検証に合格した候補が、失敗した候補より上位に並びます。証拠をレビューして採用するのはあなたであり、AX Code が勝者を自動的にマージすることはありません。
実行と Arena の機能についてのドキュメントを読む ↗コンパイラレベルの精度:ライブ LSP とコードインテリジェンス
AX Code は、勘に頼るコード編集を、二層のセマンティックインテリジェンスアーキテクチャに置き換えます:
ライブ Language Server Protocol(LSP)
TypeScript、Rust、Go、Python、Ruby の稼働中の言語サーバーと直接統合します。lsp ツールは定義ジャンプ、参照の検索、呼び出し階層(incomingCalls / outgoingCalls)、集約されたコンパイラ診断(diagnosticsAggregated)を提供します。エージェントがコードを編集すると、ライブの型チェックとコンパイルエラーが実行ループに直接還流し、その場で自己修正できます。
決定論的な SQLite コードグラフ
ax-code index で構築される永続的なコードグラフは、LLM のコンテキストウィンドウを消費せずにリポジトリ全体の構造情報を提供します。呼び出し元と呼び出し先を照会し、変更前に影響範囲を正確に計算し(impact_analyze)、非同期のレースコンディションをスキャンし(race_scan)、リソースのライフサイクルリークを捉えられます(lifecycle_scan)。
LSP ツールのドキュメントを読む ↗AX Wiki:リポジトリのアーキテクチャ知識をネイティブに
大規模コードベースに必要なのは grep だけでなく、アーキテクチャの地盤です。AX Code は ax-code wiki から使えるネイティブのリポジトリ wiki コンパイラ(@automatosx/ax-wiki)を備えています:
ソースに裏付けられたドキュメント
リポジトリのアーキテクチャ、モジュールの責務、規約、データフローをコンパイルし、ax-wiki/ 配下に検証済みソースシンボルへ直接リンクするクリーンな Markdown ナレッジベースを構築します。
増分同期
ax-code wiki update はソースのハッシュを wiki マニフェストと比較し、最近の git コミットの影響を受けたページだけを再生成するため、コストのかかる全面再ビルドなしにドキュメントを同期できます。
保護されたメンテナーブロック
<!-- AX-WIKI:PROTECTED:START --> マーカーで人の知識を保存できます。アーキテクチャ上の決定、本番の注意点、セキュリティの不変条件は自動更新後も生き残ります。
エージェントへのアーキテクチャ理解の提供
コンパクトな wiki カード(.ax-code/wiki-cards.md)をコンパイルし、AGENTS.md に知識へのポインターを注入することで、エージェントが変更を提案する前にモジュールの境界と制約を理解できるようにします。
AX Wiki ガイドを見る ↗モデル、ハーネス、スキル
モデル
応答とツール使用の判断を生み出します。Qwen や DeepSeek のモデルが例です。速度と品質は、具体的なモデル、配信環境、タスクに左右されます。
エージェントハーネス
モデルをツールにつなぎ、実行ループを管理します。AX Code、Codex、DeepSeek Harness、Hermes Agent はこの比較の対象です。DeepSeek Harness は DeepSeek のモデル API とは別のプロジェクトです。
スキル
再利用可能なタスク手順と、必要に応じた補助リソースです。スキルはエージェントを導きますが、ランタイムの代わりや正しい出力の保証にはなりません。AX Code は SKILL.md を使ったプロジェクトスキルに対応しています。
AX Code のスキルを見る ↗モデルだけでなく、ハーネスを比べる
同じタスクで、ツールの境界、セッションの証拠、復元、カスタマイズ、検証を評価しましょう。スキルやローカルモデルのような共通機能は、一方のツールだけが特に優れている証拠にはなりません。