--- title: ターミナルガイド description: 初めてターミナルを使う人向けに、Orchestor CLI のインストール、ログイン、最初のデータ取得を案内します。 canonical_url: https://orchestor.io/docs/terminal-guide markdown_url: https://orchestor.io/docs/terminal-guide.md contentType: tutorial --- # ターミナルガイド ターミナルを初めて使う人向けのガイドです。ターミナルを開き、Orchestor CLI をインストールして、ブランドのデータを取得するところまで進めます。 ターミナルは、文字でコマンドを入力して操作するアプリです。このページのコードをコピーし、ターミナルに貼り付けて Enter キーを押すと実行できます。複数行ある場合は、1 行ずつ実行してください。 > **Note** > > ブラウザで始めたい場合は、[ウェブ版 クイックスタート](https://orchestor.io/docs/web-quickstart.md)を参照してください。CLI の利用にも Orchestor のアカウントが必要です。初めての場合は、先に[アカウントの作成](https://orchestor.io/signup)を済ませます。 ## macOS と Linux 1. **ターミナルを開く** macOS では Command + Space で Spotlight を開き、「ターミナル」と入力して Enter キーを押します。Linux ではアプリケーションメニューからターミナルを開きます。環境によっては Ctrl + Alt + T でも開けます。 文字を入力できるカーソルが表示されたら準備できています。macOS では Command + V、多くの Linux ターミナルでは Ctrl + Shift + V でコマンドを貼り付けます。 2. **Node.js を確認する** この手順では npm/pnpm で導入するため、Node.js 24 以上が必要です。 ```bash node --version npm --version ``` Node.js が見つからない、または 24 未満の場合は、[Node.js の公式サイト](https://nodejs.org/en/download)から 24 以上のバージョンを導入します。その後、ターミナルを開き直して確認してください。 3. **Orchestor CLI をインストールする** 通常は npm を選びます。すでに pnpm を使っている場合は、メニューで pnpm を選べます。表示されたコマンドをコピーして実行してください。 ```sh curl -fsSL https://orchestor.io/install | sh ``` インストール後、次のコマンドでバージョンを確認します。 ```bash orc --version ``` 4. **ログインする** ```bash orc auth login ``` 開いたブラウザでログインを完了し、ターミナルに戻ります。 ```bash orc auth status --json ``` 認証状態を確認できたら、下の「最初のデータを取得する」に進みます。 ## Windows 1. **PowerShell を開く** スタートメニューで「PowerShell」を検索して開きます。Windows Terminal を使っている場合は、PowerShell のタブを選びます。Ctrl + V または右クリックでコマンドを貼り付け、Enter キーで実行します。 2. **Node.js を確認する** ```powershell node --version npm --version ``` この手順では npm で導入するため、Node.js 24 以上が必要です。見つからない、または 24 未満の場合は、[Node.js の公式サイト](https://nodejs.org/en/download)から Windows 用の 24 以上のバージョンを導入します。PowerShell を開き直して確認してください。 3. **Orchestor CLI をインストールする** 通常は npm を選びます。すでに pnpm を使っている場合は、メニューで切り替えられます。 ```sh curl -fsSL https://orchestor.io/install | sh ``` 表示されたコマンドを実行した後、バージョンを確認します。 ```powershell orc --version ``` 4. **ログインする** ```powershell orc auth login ``` ブラウザでログインを完了し、PowerShell に戻ります。 ```powershell orc auth status --json ``` ## 最初のデータを取得する 1. **ワークスペースを確認する** ```bash orc workspaces list ``` 一覧から、調べたいブランドが入っているワークスペースの ID を確認します。 2. **操作するワークスペースを選ぶ** `WORKSPACE_ID` を一覧に表示された ID に置き換えます。 ```bash orc workspace use WORKSPACE_ID ``` 3. **ブランド一覧を取得する** ```bash orc brands list --json ``` ブランド一覧が返れば、CLI からデータを取得できています。空の一覧が返る場合は、選択中のワークスペースとブランドの登録状況を確認します。まだ設定していない場合は、[ウェブ版の初期設定](https://orchestor.io/docs/web-quickstart.md)または[CLI の初回観測](https://orchestor.io/docs/cli/workflows/onboarding.md)に進んでください。 Orchestor CLI はコマンド単位で実行します。処理が終わると、次のコマンドを入力できる状態に戻ります。実行中のコマンドを中断するときは Ctrl + C、使い方を確認するときは次を実行します。 ```bash orc --help ``` ## 次のステップ ### プロンプトやレポートを取得する 選択したワークスペースのプロンプトと可視性レポートを取得できます。 ```bash orc prompts list --json orc reports visibility get --json ``` 各コマンドの使い方は、末尾に `--help` を付けて確認できます。 ### エージェントと調べる Claude Code、Codex、Cursor などに自然文で調査を依頼する場合は、[エージェント接続ガイド](https://orchestor.io/docs/cli/workflows/agent-connect.md)に沿って設定します。CLI のログインと MCP の認証は別です。 ### ほかの使い方を確認する - [CLI クイックスタート](https://orchestor.io/docs/cli/quickstart.md)：認証、ワークスペース、データ取得の手順 - [CLI ワークフロー](https://orchestor.io/docs/cli/workflows.md)：回答や競合・引用元の調べ方 - [Orchestor を使う場所](https://orchestor.io/docs/platforms.md)：Web と CLI の使い分け ## トラブルシューティング ### macOS と Linux ### node または npm が見つからない Node.js のインストールを完了し、ターミナルを開き直します。`node --version` と `npm --version` が動作することを確認してから、CLI をインストールしてください。 ### command not found: orc と表示される CLI のインストールがエラーなく終わったかを確認します。ターミナルを開き直しても見つからない場合は、使用したパッケージマネージャーの導入先が PATH に含まれているか確認します。詳しくは[セットアップのトラブルシューティング](https://orchestor.io/docs/cli/workflows/setup-troubleshooting.md)を参照してください。 ### Windows ### node、npm、orc が認識されない Node.js と CLI のインストール結果を確認し、PowerShell を開き直します。`node --version`、`npm --version`、`orc --version` の順に実行し、どの段階で見つからないか確認してください。 ### npm.ps1 や orc.ps1 を実行できない PowerShell の実行ポリシーでスクリプトが制限されている場合は、スタートメニューから「コマンドプロンプト」を開き、同じ npm または orc コマンドを実行します。 ログインや取得で止まった場合は、[セットアップのトラブルシューティング](https://orchestor.io/docs/cli/workflows/setup-troubleshooting.md)で失敗した段階を確認してください。 --- [Documentation index](https://orchestor.io/docs/llms.txt)