初期設定

MoAI-ADK のインタラクティブな設定ウィザードで最初の設定を完了しましょう。ウィザードが尋ねるのは、人が選ぶ必要のある 5 つだけです — 会話言語、名前、デプロイするエージェントハーネス、セッションの権限モード、Jev の型付き判定を有効にするかどうか。それ以外の設定(モデルポリシー、レポート形式、品質ゲート、デザインワークフローなど)は推奨の既定値で保存され、必要なら後から変更できます。

設定の多くは .moai/config/sections/ 配下の YAML ファイルに保存されます。ファイルごとに 1 つの関心事だけを受け持つので、値を変えるときはそのファイルだけを開けば済みます。セッションの権限モードだけは例外で、ユーザーレベルの Claude Code 設定に書き込まれます(下の Page 2 を参照)。

新しいプロジェクトを作成しながら初期化するには:

moai init my-project

このコマンドは my-project フォルダを作成し MoAI-ADK を初期化します。

既存プロジェクトに MoAI-ADK をインストールするには、該当フォルダに移動して実行してください:

cd my-existing-project
moai init

情報

moai init は現在のフォルダにそのままインストールします。新規プロジェクトは moai init <プロジェクト名> で作成してください。

初期化ウィザードは、モード選択なしで常に同じ流れで動作します。質問の範囲を広げたり狭めたりするフラグはなく、誰に対しても同じ質問を表示します。質問は 5 つで、3 ページに分かれています。画面上部の進行表示(● ● ● ○ ○ 3 / 5)はページではなく質問の数を数えます。

moai init my-project

情報

Git 自動化モードとプロバイダーはウィザードでは尋ねません。moai init がリポジトリに既に設定されている Git リモートから自動で判断します。後から Git 設定を変えるには moai update -c (--config) を実行してください。Git 関連の質問(自動化モード、プロバイダー、認証情報)はこの経路でのみ表示されます。

会話言語と名前の 2 つを決めます。会話言語には既定値が入っており、名前はプロファイルに保存済みの値があるときだけ入ります。どちらの場合も Enter を押すだけで先に進めます。

会話言語 — MoAI が会話に使う言語です。選ぶとすぐにウィザードの画面もその言語に切り替わります。

? 会話言語を選択
▸ English
  Korean (한국어)
  Japanese (日本語)
  Chinese (中文)

この設定は .moai/config/sections/language.yaml に保存されます。

名前 — MoAI があなたを呼ぶときの名前です。空のままにすると省略されます。

? お名前を入力: [名前]

この設定は .moai/config/sections/user.yaml の user.name フィールドに保存されます。

情報

プロジェクト名は尋ねません。moai init <プロジェクト名> に渡した名前を使い、名前を渡さなければ現在のフォルダー名を使います。--name フラグで直接指定することもできます。

このプロジェクトにどのエージェントハーネスをデプロイして接続するかを選びます。選択によってプロジェクトルートに置かれるファイルが変わります。

? デプロイして接続するエージェントハーネスを選択
▸ Claude のみ (推奨) - .claude/ サーフェスと AGENTS.md をデプロイします (従来のデフォルト動作)
  Codex のみ         - AGENTS.md と Codex サーフェスのみデプロイ — .claude/ ツリー、CLAUDE.md、.mcp.json は作成されません
  Claude + Codex     - 同じ .claude/ デプロイに .codex/ 接続を追加し、.mcp.json のプロビジョニングを強制有効化

--llm claude|gpt|both フラグを指定すると、この回答よりフラグが優先されます。

Claude Code のセッションをどの権限モードで開始するかを選びます。

? セッションの権限モードを選択
▸ 編集を自動承認 (推奨) - ファイル編集は自動承認; その他のツールは確認
  自動モード            - 分類器の安全検査のもとでツール呼び出しを自動承認
  権限をバイパス        - すべてのプロンプトを省略; サンドボックス証明が必要 (Docker/gVisor 等)

この設定はプロジェクトの YAML ではなく、ユーザーレベルの Claude Code 設定(defaultMode)に書き込まれます。既定の「編集を自動承認」は defaultMode: acceptEdits になります。「権限をバイパス」はサンドボックス証明があり、キルスイッチがオフのときにだけ適用され、そうでなければ自動モードに下げて適用されます。--autonomy-tier semi-auto|automatic|fully-autonomous フラグを指定すると、この回答よりフラグが優先されます。

Jev は渡された状態について型付きの質問に答え、確率を返す機能です。判断そのものは行わず、答えは人が読みます。自動で使われる場合も信号としてだけです — 例えば moai todo --auto が待機中のカードを検討する順序や、確認するか人に引き継ぐだけの任意の着手の交差検証があります。この信号だけでカードを承認・マージ・変更することはありません。

? Jev の型付き判定を有効にしますか？（任意・既定は無効）

既定値は無効です。有効にするとカード本文やリクエスト本文が外部ベンダーのサーバーへ送信されるので、それを踏まえて選んでください。この設定は .moai/config/sections/workflow.yaml の workflow.jev.enabled フィールドに保存されます。

注意

この質問は moai init でだけ表示されます。moai update -c では尋ねないので、後から変えるには moai web の設定画面を開いてください。

以下の値は尋ねずに既定値で保存されます。変えるにはフラグを指定するか、セットアップ後に moai update -c または moai web を使ってください。

エージェント別モデル割り当てを尋ねていたウィザードの質問は退きました。v3.2 からはサブエージェントがメインセッションのモデルと推論深度をそのまま引き継ぐため、moai init はモデルポリシーを尋ねません — エージェントごとに選ぶものがもう残っていないからです。プロファイルが持つのはセッションモデルポリシー 1 つです。このプロファイルで起動する Claude セッションの既定の推論強度であり、推論強度を別に選ばなかったときに適用されます。設定は moai profile setup の「セッションモデルポリシー」の質問で行ってください。退いた --model-policy / --profile フラグは警告だけを出す廃止済みスタブです。継承の規則はモデルポリシーページ、エージェント別マトリクスの退場はプロファイルマトリクスページを参照してください。

フラグですべての値を指定すると、ウィザードなしで初期化できます:

moai init my-project \
  --non-interactive \
  --llm claude \
  --autonomy-tier semi-auto \
  --enable-lsp=false \
  --enforce-quality

すべてのステップを完了すると設定ファイルが生成されます:

graph TD
    A[".moai/"] --> B["config/"]
    A --> C["specs/"]
    A --> D["memory/"]
    B --> E["sections/"]
    E --> F["user.yaml"]
    E --> G["language.yaml"]
    E --> H["quality.yaml"]
    E --> I["llm.yaml"]
    E --> J["git-strategy.yaml"]

インストールがスキルミラーを配備するときは、シンボリックリンクを優先します。リンクを作れない環境ではコピーで代用配備され、そのときは moai init の完了要約に代用の事実が併記されます — 知っておくべきは、コピーはリンクと違って元が変わっても自分では追従しない、その一点です。

# ユーザー設定
vim .moai/config/sections/user.yaml

# 言語設定
vim .moai/config/sections/language.yaml

# セッションモデルポリシー (effort フォールバック)
moai profile setup

# 品質設定
vim .moai/config/sections/quality.yaml

設定ウィザードを再実行して構成を変更できます:

# 設定ウィザードの再実行 (推奨)
moai update -c

情報

moai update -c コマンドは既存の設定を維持しながら変更したい項目だけを選択的に再設定できます。

設定が正しく構成されているか確認しましょう:

moai doctor

このコマンドは Git のインストール有無、プロジェクト構造 (.moai/ フォルダ)、設定ファイル、言語別の開発ツールを検証します。--verbose で詳細を確認できます。

設定が完了したら クイックスタート ガイドに従って最初のプロジェクトを作成してみましょう。

moai --help