> ## 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.

# CLI 概要

> Refrain CLI のインストールと使い方。

## インストール

<CodeGroup>
  ```bash npm theme={null}
  npm install -g @refrainai/cli
  ```

  ```bash pnpm theme={null}
  pnpm add -g @refrainai/cli
  ```

  ```bash npx（インストール不要） theme={null}
  npx @refrainai/cli <command>
  ```
</CodeGroup>

## コマンド一覧

| コマンド                                 | 説明                             |
| ------------------------------------ | ------------------------------ |
| [`generate`](/ja/cli/generate)       | AI によるブラウザ探索で手順書を生成            |
| [`execute`](/ja/cli/execute)         | 手順書を実行                         |
| [`fix-runbook`](/ja/cli/fix-runbook) | 実行レポートの修正提案を手順書に適用             |
| [`compose`](/ja/cli/compose)         | 複数の手順書を1つの分岐付き手順書にマージ          |
| [`runner`](/ja/cli/runner)           | リモートブラウザ Runner を起動            |
| [`serve`](/ja/cli/serve)             | リモート実行と Web コンソール用 API サーバーを起動 |

## グローバルオプション

| オプション             | 説明       |
| ----------------- | -------- |
| `--version`, `-v` | バージョンを表示 |
| `--help`, `-h`    | ヘルプを表示   |

## 基本的な使い方

### 手順書を生成する

```bash theme={null}
npx @refrainai/cli generate -- \
  --url "https://app.example.com/login" \
  --goal "ログインしてダッシュボードデータをエクスポートする" \
  --output ./login-export.yaml \
  --context ./context.md \
  --secrets ./secrets.json \
  --headless false \
  --model "claude-sonnet-4-6" \
  --model-provider anthropic
```

<Tip>
  環境変数でデフォルトモデル・プロバイダーを設定すれば、毎回指定する必要がなくなります。詳しくは[デフォルトモデルの設定](/ja/guides/ai-setup#デフォルトモデル)を参照してください。
</Tip>

### 手順書を実行する

```bash theme={null}
npx @refrainai/cli execute -- \
  --runbook ./login-export.yaml \
  --context ./context.md \
  --secrets ./secrets.json \
  --headless false \
  --model "claude-sonnet-4-6" \
  --model-provider anthropic
```

### 自動修正モード

アグレッシブなリトライと AI 修正提案で手順書を検証：

```bash theme={null}
npx @refrainai/cli execute -- \
  --runbook ./login-export.yaml \
  --self-heal
```

### 修正を適用する

AI が生成した修正提案を適用して壊れた手順書を更新：

```bash theme={null}
npx @refrainai/cli fix-runbook -- \
  --runbook ./login-export.yaml \
  --report ./report.md
```

## AI プロバイダー設定

デフォルトでは **Anthropic Claude** を使用します。API キーを設定してください：

```bash theme={null}
export ANTHROPIC_API_KEY="sk-ant-..."
```

他のプロバイダー（OpenAI、Google、Azure、Bedrock、Vertex）については [AI プロバイダーを設定する](/ja/guides/ai-setup) で必要な環境変数とフラグを確認してください。

## API キー（プランティア）

API キーを設定して高度な機能をアンロック：

```bash theme={null}
export REFRAIN_API_KEY="rfn-eyJ..."
```

またはコマンドごとに指定：

```bash theme={null}
npx @refrainai/cli execute -- --runbook ./flow.yaml --api-key "rfn-eyJ..."
```

詳しくは[プラン・料金](/ja/concepts/plan-tiers)を参照してください。