> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ja/llms.txt

# Mastra クイックスタート

**AI Agent 向け：** `npm create mastra@latest <project-name> -- --llm <provider>` を使用して、Mastra プロジェクトを非対話形式で作成します。`<provider>` は `openai`、`anthropic`、`google`、`xai` のいずれかに置き換えてください。Agent やモデル Provider を含まない最小構成のプロジェクトを作成するには、`npm create mastra@latest <project-name> -- --empty` を使用します。Mastra プロジェクトをゼロから構築する場合は、[手動インストールガイド](https://mastra.zisheng.pro/ja/guides/getting-started/manual-install)を参照してください。

`create-mastra` CLI は、Mastra プロジェクトを始めるための最も手軽な方法です。Workspace Tool、Memory、タスク追跡、Web アクセス、Schedule、Storage、Observability を備えた Agent Harness を作成します。

より細かく設定する場合は、[手動インストールガイド](https://mastra.zisheng.pro/ja/guides/getting-started/manual-install)を参照してください。既存のプロジェクトに Mastra を追加するには、[`mastra init`](https://mastra.zisheng.pro/ja/reference/cli/mastra) を使用します。

> **📹 動画を見る:** [Mastra AI Agent コース](https://www.youtube.com/watch?v=lCmf_qrGfGA)では、Mastra で Agent を構築する方法を順を追って学べます。

## 始める前に

OpenAI、Anthropic、Google Gemini、または xAI の API キーが必要です。セットアップ時の入力は省略でき、後から `.env` に追加できます。

## プロジェクトを作成する

対話形式のセットアップを実行します。

**npm**:

```bash
npm create mastra@latest
```

**pnpm**:

```bash
pnpm create mastra@latest
```

**Yarn**:

```bash
yarn create mastra
```

**Bun**:

```bash
bunx create-mastra
```

このコマンドでは、プロジェクト名、モデル Provider、任意の API キーの入力を求められます。その後、依存関係とコーディングアシスタント向けの Mastra Skill がインストールされます。既存のリポジトリ内でなければ、最初の Git コミットも作成されます。

生成された `src/mastra` ディレクトリには、Mastra のエントリーポイント、Agent、Workspace Tool、および関連するコードが含まれています。Mastra の標準的な構成については、[プロジェクト構造のリファレンス](https://mastra.zisheng.pro/ja/reference/project-structure)を参照してください。

> **ヒント:** テンプレートから始めるには `--template <template>` を、Provider を含まない最小構成のプロジェクトを作成するには `--empty` を使用します。自動セットアップを省略するには、`--no-skills` または `--no-git` を使用します。すべてのフラグについては、[`create-mastra` リファレンス](https://mastra.zisheng.pro/ja/reference/cli/create-mastra)を参照してください。

## Agent をテストする

ターミナルの指示に従ってプロジェクトディレクトリに移動し、開発サーバーを起動します。

**npm**:

```bash
npm run dev
```

**pnpm**:

```bash
pnpm run dev
```

**Yarn**:

```bash
yarn dev
```

**Bun**:

```bash
bun run dev
```

[localhost:4111 の Studio](http://localhost:4111) を開き、Agent を選択してメッセージを送信します。セットアップ時に Provider の API キーの入力を省略した場合は、`.env.example` に記載されている API キーを `.env` ファイルに追加してください。

[Studio](https://mastra.zisheng.pro/ja/docs/studio/overview) を使用すれば、別途 UI を作成することなく Agent を構築してテストできます。

## 次のステップ

- Mastra を [Next.js](https://mastra.zisheng.pro/ja/guides/getting-started/next-js)、[React](https://mastra.zisheng.pro/ja/guides/getting-started/vite-react)、または [Astro](https://mastra.zisheng.pro/ja/guides/getting-started/astro) と統合する
- [AI を活用して Mastra を構築する方法](https://mastra.zisheng.pro/ja/reference/build-with-ai)を学ぶ
- [ガイド](https://mastra.zisheng.pro/ja/guides)に沿って Agent をゼロから構築する
- [Mastra YouTube チャンネル](https://www.youtube.com/@mastra-ai)を見る