> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/reference/ja/purattofmu/cli/install-and-set-up-the-cli.md).

# CLI のインストールとセットアップ

必要になります `Python >=3.10` RoboflowのPythonパッケージを使用するために。

Python をインストールしたら、次のコマンドを実行してインストールしてください:

```bash
pip install roboflow
```

インストール後、CLI が動作することをテストします:

```bash
roboflow --help
```

## 認証

認証する方法は3つあります:

### オプション1: 環境変数（スクリプトやエージェントに推奨）

```bash
export ROBOFLOW_API_KEY=rf_xxxxx
```

これは、CI/CD、自動化、AI コーディングエージェントに推奨される方法です。対話的なプロンプトは不要です。

### オプション2: APIキー フラグ

```bash
roboflow --api-key rf_xxxxx project list
```

任意のコマンドにキーを直接渡します。一度きりのコマンドに便利です。

### オプション3: 対話形式のログイン

```bash
roboflow login
```

ブラウザでリンクを開き、トークンを取得して、ターミナルに貼り付けます。認証情報は次に保存されます `~/.config/roboflow/config.json` そのため、この操作は一度だけで済みます。

また、次の方法で非対話的にログインすることもできます:

```bash
roboflow auth login --api-key rf_xxxxx
```

## 認証を確認

```bash
roboflow auth status
```

これにより、現在のワークスペースとマスクされたAPIキーが表示されます。

## デフォルトのワークスペースを設定

複数のワークスペースにアクセスできる場合、既定で使用するものを設定します:

```bash
roboflow auth set-workspace my-workspace-id
```

## シェル補完（オプション）

コマンド、オプション、引数のタブ補完を有効にします:

```bash
# Zsh
eval "$(roboflow completion zsh)"

# Bash（bash >= 4.4 が必要）
eval "$(roboflow completion bash)"

# Fish
roboflow completion fish | source
```

永続化するには、 `eval` の行をシェルのプロファイル（`~/.zshrc`, `~/.bashrc`など）に追加してください。