> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# ElevenLabs CLI

## 概要

ElevenLabs CLIを使うと、ターミナルからElevenLabsエージェントにアクセスでき、新しい方法で管理できます。

* エージェントをコードとしてバージョン管理システムに保存
* CI/CDインテグレーションを設定し、エージェントを自動デプロイ
* コーディングエージェントから音声エージェントにアクセスして管理

> **すぐにコードを見たいですか？**
>
> [GitHubで完全なソースコードを確認し、コントリビュートできます](https://github.com/elevenlabs/cli)。

> **インストール不要**
>
> Claudeや他のMCPクライアントから作業する場合は、[ホスト型MCP サーバー](/docs/ja/eleven-agents/operate/hosted-mcp)で、ローカルにインストールせずにエージェント管理ツールを利用できます。エージェントをバージョン管理したい場合はCLIを、対話形式で管理したい場合はホスト型MCPサーバーを使用してください。

## インストール

Homebrew（macOS）とScoop（Windows）は推奨のインストール方法で、スタンドアロンバイナリを提供します。

**`Homebrew (macOS)`**

```bash title="Homebrew (macOS)"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop (Windows)`**

```powershell title="Scoop (Windows)"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

```bash title="curl"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
```

> **Tip**
>
> AIコーディングアシスタントを使っていますか？プロジェクトで`elevenlabs generate-skills`を実行すると、各コマンドグループ用の
> `SKILL.md`が`skills/`に作成されます。これにより、ドキュメントを貼り付けなくても、アシスタントがCLIのすべての機能を把握できます。
> 別の場所に配置するには`--output-dir`を使ってください。CLIに組み込まれたAPI定義を読み取るため、APIキーは不要で、オフラインでも動作します。また、
> インストールしているCLIのバージョンに常に対応します。

インストール後、ターミナルで`elevenlabs`コマンドをグローバルに使用できます。

## クイックスタート

### 新しいプロジェクトを初期化

```bash
elevenlabs agents init
```

設定ディレクトリとレジストリファイルを含むプロジェクト構造が作成されます。

### ElevenLabsで認証

```bash
elevenlabs auth login
```

OAuthで認証するためのブラウザウィンドウが開きます。CLIが認証情報を検証し、安全に保存します。

### 最初のエージェントを作成

```bash
elevenlabs agents add "My Assistant" --template assistant
```

assistantテンプレートを使用して、新しいエージェント設定を作成します。

### ElevenLabsプラットフォームにプッシュ

```bash
elevenlabs agents push
```

ローカルのエージェント設定をElevenLabsプラットフォームにアップロードします。

## プロジェクト構造

CLIは構造化されたプロジェクトディレクトリを作成します。

```
your_project/
├── agents.json              # Central agent configuration registry
├── tools.json               # Tool definitions registry
├── tests.json               # Test definitions registry
├── agent_configs/           # Agent configuration files
├── tool_configs/            # Tool configuration files
└── test_configs/            # Test configuration files
```

## 認証

`elevenlabs auth login`は、認証情報をオペレーティングシステムのキーリングに保存します。macOSではKeychain、
WindowsではCredential Manager、LinuxではSecret Serviceを使用します。キーリングが利用できない場合、
CLIは`0600`権限で`~/.config/elevenlabs/auth-keyring.json`にフォールバックします。使用中の保存先を確認するには
`elevenlabs auth status`を実行し、保存済みのエントリを削除するには`elevenlabs auth logout`を実行してください。

CIではログインの代わりに、環境変数または`.env`ファイルで`ELEVENLABS_API_KEY`を設定してください。

### 認証コマンド

**`Login`**

```bash title="Login"
elevenlabs auth login
```

**`Logout`**

```bash title="Logout"
elevenlabs auth logout
```

## エージェント管理

### エージェントの作成

事前構築済みテンプレートを使用してエージェントを作成します。

```bash
elevenlabs agents add "Agent Name" [options]
```

**オプション：**

* `--template <type>`：利用可能なテンプレートから選択（デフォルト：default）
* `--skip-upload`：プラットフォームにアップロードせずローカルで作成

**例：**

```bash
elevenlabs agents add "Customer Support Bot" --template customer-service
```

### テンプレート

CLIには、一般的なユースケース向けに6つの事前構築済みテンプレートがあります。

#### default

利用可能なすべてのフィールド、適切なデフォルト設定、音声／テキストの完全サポート、ウィジェットのカスタマイズ、評価基準を含む完全な設定。

#### minimal

基本的なプロンプト、言語、TTS、会話設定を含む必須フィールドのみ。

#### voice-only

テキスト入力を無効にし、高度な音声設定を備えた音声インタラクション向けの最適化。

#### text-only

音声機能を無効にした、テキスト中心の会話。

#### customer-service

プロフェッショナルで共感的なプロンプト、低いtemperature（0.1）、30分の継続時間、評価基準。

#### assistant

バランスの取れた創造性（temperature 0.3）と、柔軟な音声／テキストサポートを備えた汎用AIアシスタント。

### テンプレートコマンド

**`List available templates`**

```bash title="List available templates"
elevenlabs agents templates list
```

**`Show template configuration`**

```bash title="Show template configuration"
elevenlabs agents templates show <template>
```

### 同期

ローカル設定をElevenLabsプラットフォームと同期します。

**`Push all agents`**

```bash title="Push all agents"
elevenlabs agents push
```

**`Preview changes (dry run)`**

```bash title="Preview changes (dry run)"
elevenlabs agents push --dry-run
```

### ステータスとモニタリング

**`Check agent status`**

```bash title="Check agent status"
elevenlabs agents status
```

### インポートとエクスポート

**`Import existing agents`**

```bash title="Import existing agents"
elevenlabs agents pull
```

**`Import specific agent`**

```bash title="Import specific agent"
elevenlabs agents pull --agent <agent_id>
```

**`Update agents`**

```bash title="Update agents"
elevenlabs agents pull --update
```

**`List all agents`**

```bash title="List all agents"
elevenlabs agents list
```

> **Note**
>
> デフォルトでは、`elevenlabs agents pull`はすでにローカルに存在するエージェントをスキップします。ブラウザまたはAPI経由で行ったリモートの変更でローカル設定を上書きするには、`--update`
> フラグを使用してください。

## ツール管理

CLIは、エージェントの機能を拡張する2種類のツールをサポートしています。

### Webhookツール

認証とタイムアウトを設定できるHTTP APIインテグレーション：

```bash
elevenlabs tools add "API Integration" --type "webhook" --config-path ./config.json
```

### クライアントツール

クライアント側との直接インテグレーション：

```bash
elevenlabs tools add "Client Function" --type "client" --config-path ./config.json
```

## ウィジェットの生成

Webインテグレーション用のHTML埋め込みコードを生成します。

```bash
elevenlabs agents widget embed <agent_id>
```

次のようなHTMLコードが出力されます。

```html
<elevenlabs-convai agent-id="agent_id_here"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async></script>
```

## 設定ファイル

### エージェント設定の構造

各エージェント設定には次の内容が含まれます。

```json
{
  "name": "Agent Name",
  "conversation_config": {
    "agent": {
      "language": "en",
      "prompt": {
        "prompt": "You are a helpful AI assistant.",
        "llm": "gemini-2.5-flash",
        "temperature": 0.0
      }
    },
    "tts": {
      "model_id": "eleven_turbo_v2",
      "voice_id": "cjVigY5qzO86Huf0OWal",
      "agent_output_audio_format": "pcm_16000"
    },
    "asr": {
      "provider": "scribe_realtime",
      "quality": "high",
      "user_input_audio_format": "pcm_16000"
    },
    "conversation": {
      "text_only": false,
      "max_duration_seconds": 600,
      "client_events": ["audio", "interruption"]
    }
  },
  "platform_settings": {
    "widget": {
      "variant": "full",
      "placement": "bottom-right"
    }
  },
  "tags": []
}
```

### CI/CDパイプラインとのインテグレーション

```yml
# In your GitHub Actions workflow
- name: Deploy ElevenAgents agents
  run: |
    npm install -g @elevenlabs/cli
    export ELEVENLABS_API_KEY=${{ secrets.ELEVENLABS_API_KEY }}
    elevenlabs agents push --dry-run  # Preview changes
    elevenlabs agents push            # Deploy
    elevenlabs agents status          # Verify deployment
```