---
title: セットアップの失敗箇所を絞る
description: セットアップの失敗箇所を絞る。
canonical_url: https://orchestor.io/docs/cli/workflows/setup-troubleshooting
markdown_url: https://orchestor.io/docs/cli/workflows/setup-troubleshooting.md
contentType: how-to
---

# セットアップの失敗箇所を絞る

成功しなかった段階を、登録・認証、ワークスペース作成、設定生成、確定、初回観測、エージェント接続に分けて調べます。

## 初期セットアップのどこで止まったか

| 段階 | 確認するもの | 次の操作 |
| --- | --- | --- |
| 登録・招待 | メール認証と招待の適用 | [アカウント作成](https://orchestor.io/signup)の残っている手順を進める。 |
| サインイン | `orc auth status --json` | [使用中の認証元](https://orchestor.io/docs/cli/quickstart.md)を確認する。 |
| ワークスペース作成 | 作成結果のIDと`workspaces get` | 同じアカウントで[作成結果を読み戻す](https://orchestor.io/docs/cli/workflows/new-workspace.md)。 |
| 設定生成 | `orc observations get --workspace WORKSPACE_ID --json` | エラーを解消し、同じ対象の生成を再開する。 |
| 設定確定 | 確定結果の`initial_batch_id` | [候補を確認して確定](https://orchestor.io/docs/cli/workflows/onboarding.md)する。 |
| 初回観測 | 同じバッチの状態と結果 | `runs batches get`と`runs batches results get`で確認する。 |
| WebのWelcome終了 | `workspaces setup get`の`completed_at` | 観測完了と区別し、Webに残る手順を進める。 |

`measurement_quota_exhausted`は観測利用枠を確認できない状態です。対象IDとエラーを担当者へ伝えます。`init --website`が未知のオプションになる場合は、0.5.0向けの[段階別コマンド](https://orchestor.io/docs/cli/workflows/onboarding.md)を使います。

## 手順

```bash
node --version
orc --version
orc --help
orc status --json
orc auth status --json
orc workspace current --json
orc setup skills --agent codex --status
```

`orc` が見つからなければ Node.js と導入先の PATH を確認します。401 は使用中の認証元、403 は対象と必要権限、空の一覧はワークスペースとデータの有無を確認します。`status` の終了コード 0 だけで正常と判断せず、各フィールドを読みます。Skills は installed / missing / broken / version-drift / conflict を確認し、conflict の通常ファイルを消しません。MCP は登録、OAuth、実際の取得の順で切り分けます。共有するのはバージョン、秘密を除いたエラー、対象 ID、再現手順です。

[ワークフロー一覧](https://orchestor.io/docs/cli/workflows.md) · [setup リファレンス](https://orchestor.io/docs/cli/setup.md)

失敗が残る場合は、[失敗を報告して再検証する](https://orchestor.io/docs/cli/workflows/workflow-feedback.md)で、このワークフローと失敗した手順を報告へ添えます。

---

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