> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 設定

> CometAPI CLI を設定します: config ファイルの場所、利用可能な設定、認証情報の管理、環境変数、セキュリティプラクティス。

CometAPI CLI は、TOML の config ファイル、環境変数、コマンドラインフラグから設定を読み取ります。同じ設定を複数のソースから利用できる場合、優先順位は次のとおりです:

**CLI flags > config file > environment variables > defaults**

## Config ファイル

場所: `~/.config/cometapi/config.toml`

対話形式で config ファイルを作成するには、セットアップウィザードを実行します:

```bash theme={null}
cometapi init
```

または、`config` サブコマンドで個別の設定を管理します:

```bash theme={null}
# View current configuration
cometapi config show

# Set a value
cometapi config set api_key "$COMETAPI_KEY"

# Remove a value
cometapi config unset api_key

# Show the config file path
cometapi config path
```

## 利用可能な設定

| Config key      | Environment variable     | 説明                                                     |
| --------------- | ------------------------ | ------------------------------------------------------ |
| `api_key`       | `COMETAPI_KEY`           | API key（すべてのコマンドで必須）                                   |
| `access_token`  | `COMETAPI_ACCESS_TOKEN`  | アカウントレベルのコマンド用の access token                           |
| `base_url`      | `COMETAPI_BASE_URL`      | API のベース URL（デフォルト: `https://api.cometapi.com/v1`）     |
| `default_model` | `COMETAPI_DEFAULT_MODEL` | `chat` と `run` のデフォルト model（フォールバック: `gpt-5.4`）        |
| `output_format` | —                        | デフォルトの出力形式: `table`、`json`、`yaml`、`csv`、または `markdown` |

## 認証情報

CLI は 2 種類の認証情報を使用します:

### API key

すべてのコマンドで必須です。API key は、CometAPI の model エンドポイントへのリクエストを認証します。

API key は [CometAPI Console → API Keys](https://www.cometapi.com/console/token) で作成します。

次のいずれかの方法で設定します:

<CodeGroup>
  ```bash Environment variable theme={null}
  read -rsp "CometAPI API key: " COMETAPI_KEY
  printf '\n'
  export COMETAPI_KEY
  ```

  ```bash Config file theme={null}
  cometapi config set api_key "$COMETAPI_KEY"
  ```

  ```bash Setup wizard theme={null}
  cometapi init
  ```
</CodeGroup>

### Access token

任意です。access token は、アカウントレベルのコマンド `account`、`stats`、`tokens`、`logs`、`tasks` に必要です。

access token は [CometAPI Console → Personal Settings](https://www.cometapi.com/console/personal) で生成します。

次のいずれかの方法で設定します:

<CodeGroup>
  ```bash Environment variable theme={null}
  export COMETAPI_ACCESS_TOKEN="your-access-token"
  ```

  ```bash Config file theme={null}
  cometapi config set access_token your-access-token
  ```

  ```bash Setup wizard theme={null}
  cometapi init
  ```
</CodeGroup>

## セキュリティ

CLI では、次のセキュリティプラクティスが適用されます:

* API key と access token がログに記録されたり、完全な形で表示されたりすることはありません。診断出力では末尾 4 文字のみが表示されます。
* config ファイルは制限された権限（`0600`）で作成されます。読み取り可能なのはファイル所有者のみです。
* 認証情報は絶対にバージョン管理へコミットしないでください。必要に応じて、config ファイルのパスを `.gitignore` に追加してください。

<Warning>
  API key によって発生するすべての利用および料金については、利用者が責任を負います。不正アクセスが疑われる場合は、キーを安全に保管し、ローテーションしてください。
</Warning>

## トラブルシューティング

| Error                         | Solution                                                                           |
| ----------------------------- | ---------------------------------------------------------------------------------- |
| `API key not configured`      | `cometapi init` を実行するか、`COMETAPI_KEY` 環境変数を設定してください                                |
| `Connection failed`           | 接続性を診断するには `cometapi doctor` を実行してください                                             |
| `Access token not configured` | `account`/`stats`/`tokens`/`logs`/`tasks` にのみ必要です。追加するには `cometapi init` を実行してください |