---
title: config
description: CLIのローカル設定を表示・取得・変更する。
canonical_url: https://orchestor.io/docs/cli/config
markdown_url: https://orchestor.io/docs/cli/config.md
contentType: reference
---

# config

`orc config` は、CLIの認証元と設定ファイルの場所を確認し、保存した設定値を取得・変更するコマンドです。読み取りでAPIキーの秘密値は表示せず、設定した資格情報は秘密値を含まない識別子や設定済み状態で確認できます。

対象は現在のローカルCLI設定です。アカウントのプロフィールやサーバーのWorkspace設定は変更しません。資格情報の設定には [`orc auth login`](https://orchestor.io/docs/cli/auth.md) を使用してください。

## 使い方

```bash title="terminal"
orc config show
```

*現在の認証元と設定ファイルを確認します。*

## サブコマンド

### `show`

認証設定の有無、認証元、設定ファイルのパス、設定の不足を表示します。資格情報がある場合は秘密値ではなくopaque IDを表示します。

```bash title="terminal"
orc config show [options]
```

### `get`

`key` に `apiKey`、`apiUrl`、`defaultWorkspace`、`profile` を指定して保存値を取得します。`apiKey` が設定されている場合は `[redacted]` を返します。未設定の値は空文字で、未対応のキーは終了コード2です。

```bash title="terminal"
orc config get <key> [options]
```

### `set`

対応する `key` と空でない `value` を指定して保存します。値の前後の空白は除きます。保存先のパスを表示し、APIキーの値は表示しません。

```bash title="terminal"
orc config set <key> <value> [options]
```

## 使用例

### 既定Workspaceを取得します。

```bash title="terminal"
orc config get defaultWorkspace
```

*既定Workspaceを取得します。*

### 既定Workspaceを変更します。

```bash title="terminal"
orc config set defaultWorkspace <workspace-id>
```

*既定Workspaceを変更します。*

## 設定と検証

ローカルの保存値を変更しても、資格情報の有効性やWorkspaceへのアクセス権を検証したことにはなりません。変更後に [`orc status`](https://orchestor.io/docs/cli/status.md) または `orc auth status` で確認してください。秘密値を `config set` の引数としてシェル履歴へ渡す代わりに、`auth login` の標準入力を使用します。

## グローバルオプション

`orc config` では、次の[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を使用できます。

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%98%E3%83%AB%E3%83%97)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#%E5%87%BA%E5%8A%9B%E5%BD%A2%E5%BC%8F)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#%E5%80%A4%E3%81%A0%E3%81%91%E3%82%92%E5%87%BA%E5%8A%9B)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%B8%E3%81%AE%E5%87%BA%E5%8A%9B)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%9A%E3%83%BC%E3%82%B8%E9%80%81%E3%82%8A)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%AE%E4%BA%8B%E5%89%8D%E7%A2%BA%E8%AA%8D)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#%E7%A2%BA%E8%AA%8D%E3%81%AE%E7%9C%81%E7%95%A5)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#%E3%81%99%E3%81%B9%E3%81%A6%E3%81%AE%E3%83%9A%E3%83%BC%E3%82%B8%E3%82%92%E5%8F%96%E5%BE%97)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E6%99%82%E9%96%93)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#%E8%AA%AD%E3%81%BF%E5%8F%96%E3%82%8A%E5%B0%82%E7%94%A8%E3%83%A2%E3%83%BC%E3%83%89)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#%E5%A4%96%E9%83%A8%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%AE%E7%9B%AE%E5%8D%B0%E4%BB%98%E3%81%91)

各オプションの詳細と使用例は、[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を参照してください。

---

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