インストールと設定
このレッスンでできるようになること
✅ Agent App Factory CLI ツールをインストールし、インストールを検証する ✅ Claude Code または OpenCode を AI 実行エンジンとして設定する ✅ パイプライン実行に必要なプラグインをインストールする ✅ プロジェクトの初期化を完了し、最初の Factory プロジェクトを起動する
現在の悩み
AI App Factory を使ってアイデアをアプリに変えたいが、どのツールをインストールし、どの環境を設定すればよいか分からない。インストール後に必須プラグインを忘れてしまい、パイプラインの途中でエラーが発生するのではないかと心配している。
いつこの方法を使うか
AI App Factory を初めて使用する場合、または新しいマシンで開発環境を再構築する場合は、まずインストールと設定を完了させ、その後にアプリ生成を開始してください。
🎒 開始前の準備
前提条件
インストールを開始する前に、以下を確認してください：
- Node.js バージョン >= 16.0.0 - これは CLI ツールの最低要件です
- npm または yarn - グローバルパッケージのインストールに使用します
- AI アシスタント - Claude Code または OpenCode（Claude Code を推奨）
Node.js バージョンの確認：
node --versionバージョンが 16.0.0 未満の場合は、Node.js 公式サイト から最新 LTS バージョンをダウンロードしてインストールしてください。
基本方針
AI App Factory のインストールには、以下の 3 つの重要な要素が含まれます：
- CLI ツール - コマンドラインインターフェースを提供し、プロジェクト状態を管理する
- AI アシスタント - パイプラインを実行する「脳」として、Agent 指示を解釈する
- 必須プラグイン - AI 能力を拡張するアドオン（Bootstrap ブレインストーミング、UI デザインシステム）
インストールフロー：CLI をインストール → AI アシスタントを設定 → プロジェクトを初期化（プラグインが自動インストール）
実践チュートリアル
ステップ 1：CLI ツールをインストールする
Agent App Factory CLI をグローバルにインストールすると、どのディレクトリでも factory コマンドを使用できるようになります。
npm install -g agent-app-factory期待される出力：インストール成功の出力
added 1 package in Xsインストールの検証：
factory --version期待される出力：バージョン番号
1.0.0バージョン番号が表示されない場合、インストールが成功しているか確認してください：
which factory # macOS/Linux
where factory # Windowsインストールに失敗した場合
権限の問題が発生した場合（macOS/Linux）、以下を試してください：
sudo npm install -g agent-app-factoryまたは、グローバルインストールせず npx を使用する（非推奨、使用のたびにダウンロードが必要）：
npx agent-app-factory initステップ 2：AI アシスタントをインストールする
AI App Factory は AI アシスタントと連携して使用する必要があります。Agent 定義と Skill ファイルは Markdown 形式の AI 指示であり、AI が解釈して実行する必要があるためです。
方法 A：Claude Code（推奨）
Claude Code は Anthropic 公式の AI プログラミングアシスタントで、AI App Factory と深く統合されています。
インストール方法：
- Claude Code 公式サイト にアクセスする
- 対応するプラットフォームのアプリケーションをダウンロードしてインストールする
- インストール完了後、コマンドが使用可能か確認する：
claude --version期待される出力：バージョン番号
Claude Code 1.x.x方法 B：OpenCode
OpenCode は Agent モードをサポートするもう一つの AI プログラミングアシスタントです。
インストール方法：
- OpenCode 公式サイト にアクセスする
- 対応するプラットフォームのアプリケーションをダウンロードしてインストールする
- コマンドラインツールがない場合、手動で以下の場所にダウンロードしてインストールする：
- Windows:
%LOCALAPPDATA%\Programs\OpenCode\ - macOS:
/Applications/OpenCode.app/ - Linux:
/usr/bin/opencodeまたは/usr/local/bin/opencode
なぜ Claude Code が推奨されるのか？
- 公式サポートであり、AI App Factory の権限システムとの統合が最も良い
- プラグインインストールが自動化されており、
factory initが必須プラグインを自動設定する - コンテキスト管理が優れており、Token を節約できる
ステップ 3：最初の Factory プロジェクトを初期化する
これで綺麗な工場ができました。最初のプロジェクトを初期化しましょう。
プロジェクトディレクトリの作成：
mkdir my-first-app && cd my-first-appFactory プロジェクトの初期化：
factory init期待される出力：
Agent Factory - Project Initialization
✓ Factory project initialized!
Project structure created:
.factory/
agents/
skills/
policies/
templates/
pipeline.yaml
config.yaml
state.json
✓ Plugins installed!
Starting Claude Code...
✓ Claude Code is starting...
(Please wait for window to open)チェックポイント ✅：以下のファイルが作成されたことを確認する
ls -la .factory/期待される出力：
agents/
skills/
policies/
templates/
pipeline.yaml
config.yaml
state.json同時に、Claude Code ウィンドウが自動的に開きます。
ディレクトリは空である必要があります
factory init は空のディレクトリ、または .git、README.md などの設定ファイルのみを含むディレクトリで実行できます。
ディレクトリに他のファイルがある場合、以下のエラーが表示されます：
Cannot initialize: directory is not empty.
Factory init requires an empty directory or one with only git/config files.ステップ 4：自動インストールされるプラグイン
factory init は 2 つの必須プラグインを自動的にインストールしようとします：
- superpowers - Bootstrap 段階のブレインストーミングスキル
- ui-ux-pro-max-skill - UI 段階のデザインシステム（67 種類のスタイル、96 種類のカラーパレット、100 条の業界ルール）
自動インストールが失敗した場合、以下の警告が表示されます：
Note: superpowers plugin installation failed
The bootstrap stage may prompt you to install it manuallyプラグインインストールに失敗した場合はどうするか？
初期化時にプラグインインストールが失敗した場合、後で Claude Code 内で手動インストールできます：
Claude Code で以下を入力する：
/install superpowers /install ui-ux-pro-max-skillまたはプラグインマーケットにアクセスして手動インストールする
ステップ 5：AI アシスタント権限の検証
factory init は .claude/settings.local.json ファイルを自動生成し、必要な権限を設定します。
権限設定の確認：
cat .claude/settings.local.json期待される出力（簡略版）：
{
"allowedCommands": [
"read",
"write",
"glob",
"bash"
],
"allowedPaths": [
".factory/**",
"input/**",
"artifacts/**"
]
}これらの権限により、AI アシスタントは以下のことが可能になります：
- Agent 定義と Skill ファイルを読み取る
artifacts/ディレクトリに生成物を書き込む- 必要なスクリプトとテストを実行する
--dangerously-skip-permissions を使用しないでください
AI App Factory が生成する権限設定はすでに十分安全です。Claude Code で --dangerously-skip-permissions を使用しないでください。これによりセキュリティが低下し、権限越え操作の原因となる可能性があります。
よくある問題
❌ Node.js バージョンが低すぎる
エラー：npm install -g agent-app-factory のインストールに失敗する、または実行時にエラーが発生する
原因：Node.js バージョンが 16.0.0 未満
解決策：Node.js を最新 LTS バージョンにアップグレードする
# nvm を使用してアップグレード（推奨）
nvm install --lts
nvm use --lts❌ Claude Code が正しくインストールされていない
エラー：factory init 実行後に "Claude CLI not found" というメッセージが表示される
原因：Claude Code が PATH に正しく追加されていない
解決策：Claude Code を再インストールするか、実行ファイルパスを手動で環境変数に追加する
- Windows: Claude Code インストールディレクトリを PATH に追加する
- macOS/Linux:
/usr/local/bin/にclaude実行ファイルがあるか確認する
❌ ディレクトリが空ではない
エラー：factory init で "directory is not empty" というメッセージが表示される
原因：ディレクトリに他のファイルがある（.git、README.md などの設定ファイルを除く）
解決策：新しい空のディレクトリで初期化するか、既存のディレクトリをクリーンアップする
# ディレクトリ内の非設定ファイルを削除
rm -rf * !(.git) !(README.md)❌ プラグインインストールに失敗した
エラー：factory init でプラグインインストール失敗の警告が表示される
原因：ネットワークの問題、または Claude Code プラグインマーケットが一時的に利用できない
解決策：Claude Code 内で手動でプラグインをインストールするか、後のパイプライン実行時にプロンプトに従ってインストールする
/install superpowers
/install ui-ux-pro-max-skillまとめ
このレッスンでは、AI App Factory の完全なインストールと設定を完了しました：
- ✅ CLI ツール -
npm install -g agent-app-factoryでグローバルインストール - ✅ AI アシスタント - Claude Code または OpenCode（Claude Code を推奨）
- ✅ プロジェクト初期化 -
factory initで.factory/ディレクトリを作成し、自動設定 - ✅ 必須プラグイン - superpowers と ui-ux-pro-max-skill（自動または手動インストール）
- ✅ 権限設定 - Claude Code 権限ファイルを自動生成
これで実行可能な Factory プロジェクトができました。Claude Code ウィンドウが開いており、パイプラインを実行する準備が整っています。
次回の予告
次回は Factory プロジェクトの初期化 を学習します。
学習内容：
factory initで生成されるディレクトリ構造を理解する.factory/ディレクトリ内の各ファイルの用途を理解する- プロジェクト設定を変更する方法を習得する
- プロジェクト状態を確認する方法を学ぶ
最初のアプリを生成する準備はできましたか？続けましょう！
付録：ソースコード参照
クリックしてソースコードの場所を表示
更新日時：2026-01-29
| 機能 | ファイルパス | 行番号 |
|---|---|---|
| CLI エントリ | cli/bin/factory.js | 1-123 |
| 初期化コマンド | cli/commands/init.js | 1-457 |
| Node.js 要件 | package.json | 41 |
| Claude Code 起動 | cli/commands/init.js | 119-147 |
| OpenCode 起動 | cli/commands/init.js | 152-215 |
| プラグインインストールチェック | cli/commands/init.js | 360-392 |
| 権限設定生成 | cli/utils/claude-settings.js | 1-275 |
重要な定数：
NODE_VERSION_MIN = "16.0.0"：最低 Node.js バージョン要件（package.json:41）
重要な関数：
getFactoryRoot()：Factory インストールルートディレクトリを取得する（factory.js:22-52）init()：Factory プロジェクトを初期化する（init.js:220-456）launchClaudeCode()：Claude Code を起動する（init.js:119-147）launchOpenCode()：OpenCode を起動する（init.js:152-215）generateClaudeSettings()：Claude Code 権限設定を生成する