# クイックスタート
URL: /ja/docs/quickstart

Spirit Agent をインストールし、プロバイダを1つ接続して、小さな承認済みの編集を行います。



このページでは、新規インストールから便利な変更1つまでを説明します。後のページではすべてのプロバイダとホストを説明しますが、このパスがなければ、それらのページは何にも結びつきません。

## 1. Desktop または CLI をインストールする [#1-desktop-または-cli-をインストールする]

ホストを1つ選んでください。これらは同じローカルデーモンを共有するため、後で他のホストを追加できます。

<Tabs items="[&#x22;Desktop&#x22;, &#x22;CLI&#x22;]">
  <Tab value="Desktop">
    [ダウンロードページ](/en-US/download)からお使いのプラットフォーム用のビルドをダウンロードし、開いてください。

    * macOS: `.dmg`（Intel または Apple silicon）
    * Windows: `.exe` インストーラー（x64 または ARM64）
    * Linux: `.AppImage`（x64 または ARM64）

    詳細: [Desktop のインストール](./install/desktop.mdx)。
  </Tab>

  <Tab value="CLI">
    ```bash
    curl -fsSL https://spirit.fast/install | bash
    ```

    ```powershell
    irm https://spirit.fast/install.ps1 | iex
    ```

    新しいターミナルを開き、`spirit --version` を実行します。詳細: [CLI のインストール](./install/cli.mdx)。
  </Tab>
</Tabs>

## 2. ワークスペースを開く [#2-ワークスペースを開く]

エージェントはワークスペースのルート内のファイルを読み取り、編集します。変更したいプロジェクトを開いてください。

<Tabs items="[&#x22;Desktop&#x22;, &#x22;CLI&#x22;]">
  <Tab value="Desktop">
    サイドバーの **ワークスペースフォルダを開く** を使用して、フォルダを選択します。最近のワークスペースはリストに残ります。
  </Tab>

  <Tab value="CLI">
    ```bash
    cd /path/to/your/project
    spirit
    ```

    TUI は現在のディレクトリをワークスペースとして使用します。
  </Tab>
</Tabs>

## 3. プロバイダを1つ接続する [#3-プロバイダを1つ接続する]

すでに使用しているプロバイダの API キーが必要です。Spirit はそのキーを OS のキーリング（`SpiritAgent`）に保存します。

<Tabs items="[&#x22;Desktop&#x22;, &#x22;CLI&#x22;]">
  <Tab value="Desktop">
    1. **設定 → モデル** を開きます。
    2. プロバイダを選択し、接続ウィザードに従います。
    3. キーを貼り付けます。追加フィールド（リージョン、サイト、プランエンドポイント）は、そのプロバイダが必要な場合にのみ表示されます。
    4. アクティブなモデルとしてチャットモデルを選択します。
  </Tab>

  <Tab value="CLI">
    TUI で、`/model add` を実行し、フォームを完了します。シェルからモデルを追加することもできます:

    ```bash
    spirit model add
    ```

    `SPIRIT_API_KEY` と `SPIRIT_API_BASE` は、そのプロセスの保存されたキーとベース URL を上書きします。一時的な使用に便利です。
  </Tab>
</Tabs>

## 4. 小さな変更を依頼し、承認する [#4-小さな変更を依頼し承認する]

最初の実行では、**Agent** モードと **デフォルト** 承認のままにしてください。エージェントに、既知のファイルを読み取り、小さくて明白な編集を行うように依頼します。

例:

```txt
Read README.md and add a one-line project summary at the top. Do not change anything else.
```

エージェントはファイルを読み取り、編集を提案し、待機します。プロンプトでファイル変更（およびシェルコマンド）を承認します。終了後、ファイルを開いて編集を確認します。

これが全体のループです: インストール → ワークスペース → プロバイダ1つ → 読み取り → 編集 → 承認。このドキュメントの他のすべては、このパスに基づいています。

## 次へ [#次へ]

* 別のホストや固定バージョンが必要な場合は、[デスクトップのインストール](./install/desktop.mdx)と[CLIのインストール](./install/cli.mdx)を行ってください。
* [プロバイダー](./providers.mdx)を使用して別のハウスを接続するか、モデルがインポートされなかった場合にサイト/プラン/クラウドフィールドを確認します。