---
title: ターミナル クイックスタート
description: Orchestor CLI をインストールし、ブランド、追跡中の質問、可視性レポートを取得します。
canonical_url: https://orchestor.io/docs/terminal-quickstart
markdown_url: https://orchestor.io/docs/terminal-quickstart.md
contentType: tutorial
---

# ターミナル クイックスタート

Orchestor CLI を使って、ターミナルからブランドの AI 検索での見え方を調べましょう。このガイドを終えると、ブランド、追跡中の質問、可視性レポートを取得し、エージェントと調査を進められます。

## 始める前に

- macOS、Linux、Windows のターミナルを開きます。初めて使う場合は、[ターミナルガイド](https://orchestor.io/docs/terminal-guide.md)を参照してください。
- Orchestor のアカウントを用意します。まだない場合は、[アカウントを作成](https://orchestor.io/signup)してください。
- 計測対象のブランドと質問を設定したワークスペースを用意します。初回設定は[ウェブ版クイックスタート](https://orchestor.io/docs/web-quickstart.md)で進められます。

## ステップ 1：Orchestor CLI をインストールする

使っている環境に合う方法を一つ選びます。

### macOS / Linux

```sh
curl -fsSL https://orchestor.io/install | sh
```

ネイティブ版には Node.js は不要です。Alpine Linux では、先に `apk add --no-cache libstdc++` を実行してください。

### Windows

[最新のリリース](https://github.com/orchestor-inc/cli/releases/latest)からアーキテクチャに合う ZIP をダウンロードし、展開します。`orc.exe` の保存先を PATH に追加し、新しいターミナルを開きます。

### npm

Node.js 24 以上が必要です。

```bash
npm install -g @orchestor-inc/cli@latest
```

インストールした CLI を確認します。

```bash
orc --version
orc --help
```

バージョンとコマンドの一覧が表示されれば完了です。`orc` が見つからない場合は、ターミナルを開き直し、[インストールガイド](https://orchestor.io/docs/cli/installation.md)を確認してください。

## ステップ 2：アカウントにログインする

```bash
orc auth login
```

ブラウザでログインを完了し、ターミナルに戻ります。認証状態を確認してください。

```bash
orc auth status
```

## ステップ 3：ワークスペースを選ぶ

アクセスできるワークスペースを一覧で確認します。

```bash
orc workspaces list
```

調べたいワークスペースの ID をコピーし、`WORKSPACE_ID` を置き換えて実行します。

```bash
orc workspace use WORKSPACE_ID
orc workspace current
```

操作対象が表示されれば、調査の準備は完了です。Web で設定済みのブランドや質問も利用できます。

## ステップ 4：最初の結果を見る

登録したブランドと追跡中の質問を確認します。

```bash
orc brands list
orc prompts list
```

続いて、可視性レポートを取得します。

```bash
orc reports visibility get
```

結果が空の場合は、対象のワークスペース、ブランド、質問、計測状況を Web で確認してください。データがないことと、可視性がゼロであることは区別します。

結果を別のツールで使う場合は `--json` を付けます。

```bash
orc reports visibility get --json
```

指標の意味は[主要な可視性指標](https://orchestor.io/docs/visibility/metrics-overview.md)で確認できます。

## ステップ 5：エージェントと調べる

Claude Code、Codex、Cursor などで調査を続けるには、[エージェント接続ガイド](https://orchestor.io/docs/agent-setup.md)に沿って接続します。接続したエージェントに、次のように依頼してください。

```text
このワークスペースで追跡している質問を調べて、
競合が言及されているのに自社が出てこない質問を見つけてください。
根拠となる AI 回答と引用元も示してください。
```

結果を確認したら、調査を絞り込みます。

```text
その質問で引用されているページを比較して、
自社サイトに足りない情報と、次に改善するページを提案してください。
```

## よく使うコマンド

| コマンド | できること |
| --- | --- |
| `orc --help` | コマンドの一覧を確認する |
| `orc auth status` | 認証状態を確認する |
| `orc workspaces list` | 利用できるワークスペースを確認する |
| `orc workspace use WORKSPACE_ID` | 操作対象を選ぶ |
| `orc workspace current` | 現在の操作対象を確認する |
| `orc brands list` | 登録したブランドを見る |
| `orc prompts list` | 追跡中の質問を見る |
| `orc reports visibility get` | 可視性レポートを取得する |
| `orc update --check` | 更新方法と最新バージョンを確認する |

各コマンドに `--help` を付けると、引数とオプションを確認できます。

## 次のステップ

- [CLI ワークフロー](https://orchestor.io/docs/cli/workflows.md)：競合、回答、引用元を調べる
- [エージェント接続](https://orchestor.io/docs/agent-setup.md)：使い慣れたエージェントで調査を続ける
- [CLI の更新](https://orchestor.io/docs/cli/update.md)：導入方法に合った更新手順を確認する

## 困ったときは

`orc` が見つからない、または別のバージョンが起動する場合は、macOS / Linux で `type -a orc`、PowerShell で `Get-Command orc -All` を実行し、PATH 上の保存先を確認します。

ログインやワークスペースの選択に問題がある場合は、`orc auth status` と `orc workspace current` を確認してください。共有ワークスペースが一覧にない場合は、管理者にアクセス権を確認します。

その他の対処方法は[トラブルシューティング](https://orchestor.io/docs/troubleshooting.md)を参照してください。

---

[Documentation index](https://orchestor.io/docs/llms.txt)