> ## Documentation Index
> Fetch the complete documentation index at: https://docs.therefrain.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# クイックスタート
> 5分で Refrain を使い始めましょう。
## 前提条件
* **Node.js** 18 以降
* **AI プロバイダーの API キー**（Anthropic 推奨）
## インストール
```bash npx（インストール不要） theme={null}
npx @refrainai/cli generate -- --help
```
```bash npm theme={null}
npm install -g @refrainai/cli
```
```bash pnpm theme={null}
pnpm add -g @refrainai/cli
```
### AI プロバイダー設定
AI プロバイダーの API キーを設定します。デフォルトは Anthropic です：
```bash theme={null}
export ANTHROPIC_API_KEY="sk-ant-..."
```
Refrain は 7 つの AI プロバイダー（OpenAI、Google、Azure、Bedrock、Vertex、OpenAI 互換エンドポイント）に対応しています。全プロバイダーの設定手順と環境変数は [AI プロバイダーを設定する](/ja/guides/ai-setup) を参照してください。
## ステップ 1: コンテキストとシークレットを準備する
手順書を生成する前に、以下のファイルを必要に応じて用意します：
**`context.md`** — 操作対象アプリの補足情報（ログイン URL、画面遷移のヒント、特殊な UI パターンなど）：
```markdown theme={null}
# アプリ情報
- ログインページ: https://app.example.com/login
- ログイン後、ダッシュボードは /dashboard にある
- 「CSV エクスポート」ボタンは右上のツールバーにある
```
**`secrets.json`** — 必要に応じて認証情報や機密値を記述。全値が sensitive として扱われます：
```json theme={null}
{
"email": "user@example.com",
"password": "s3cret!"
}
```
## ステップ 2: 手順書を生成する
達成したいことを AI に伝えると、Web アプリを探索して**手順書**を構築します。
```bash theme={null}
npx @refrainai/cli generate -- \
--url "https://app.example.com/login" \
--goal "ログインしてダッシュボードに移動する" \
--output ./login-flow.yaml \
--context ./context.md \
--secrets ./secrets.json \
--headless false \
--model "claude-sonnet-4-6" \
--model-provider anthropic
```
`--headless false` を指定すると、AI がアプリを探索する様子をリアルタイムで確認できます。省略するとヘッドレスモードで実行されます。
`--model` と `--model-provider` を毎回指定する代わりに、環境変数でデフォルトを設定できます。詳しくは[デフォルトモデルの設定](/ja/guides/ai-setup#デフォルトモデル)を参照してください。
AI は以下を行います：
1. ブラウザを開いて URL に移動
2. ページを探索し、実行するアクションを決定
3. 各ステップ（クリック、入力、ナビゲーション）を記録
4. ステップをレビューし、不要なものを除去
5. クリーンな**手順書**を出力
## ステップ 3: 手順書を実行する
生成された手順書を実行します：
```bash theme={null}
npx @refrainai/cli execute -- \
--runbook ./login-flow.yaml \
--context ./context.md \
--secrets ./secrets.json \
--headless false \
--model "claude-sonnet-4-6" \
--model-provider anthropic
```
セレクタは決定論的に解決されるため、**再実行時に AI トークンは消費されません**（フォールバック時は除く）。1 回でも 100 回でも、実行コストはゼロのままです。
1. ブラウザを開いて開始 URL に移動
2. 各ステップでセレクタを解決して対象要素を特定
3. アクション（クリック、入力など）を実行
4. 結果をレポート
## ステップ 4: UI が変わったら自己修正
操作対象アプリの UI が変更されてステップが失敗するようになったら、`--self-heal` で AI に診断・修正提案を生成させます：
```bash theme={null}
npx @refrainai/cli execute -- \
--runbook ./login-flow.yaml \
--context ./context.md \
--secrets ./secrets.json \
--self-heal \
--model "claude-sonnet-4-6" \
--model-provider anthropic
```
自己修正モードでは、アグレッシブなリトライ戦略と AI による修正提案、診断レポートが有効になります。提案を確認したら、`fix-runbook` コマンドで適用します：
```bash theme={null}
npx @refrainai/cli fix-runbook -- \
--runbook ./login-flow.yaml \
--report ./login-flow-report.md
```
[Web コンソール](/ja/concepts/plan-tiers)を使えば、手順書の生成・実行・スケジュール・自己修正を CLI なしでブラウザ上から行えます。
## 次のステップ
手順書生成の全オプション。
手順書実行の全オプション。
利用可能な全コマンドを確認。
Pro、Team、Business で高度な機能をアンロック。