> ## 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 file, доступні параметри, керування обліковими даними, environment variables та практики безпеки.

CometAPI CLI зчитує налаштування з TOML config file, environment variables і command-line flags. Коли той самий параметр доступний із кількох джерел, порядок пріоритету такий:

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

## Config file

Location: `~/.config/cometapi/config.toml`

Запустіть майстер налаштування, щоб створити config file інтерактивно:

```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
```

## Available settings

| Config key      | Environment variable     | Description                                                          |
| --------------- | ------------------------ | -------------------------------------------------------------------- |
| `api_key`       | `COMETAPI_KEY`           | API key (required for all commands)                                  |
| `access_token`  | `COMETAPI_ACCESS_TOKEN`  | Access token for account-level commands                              |
| `base_url`      | `COMETAPI_BASE_URL`      | API base URL (default: `https://api.cometapi.com/v1`)                |
| `default_model` | `COMETAPI_DEFAULT_MODEL` | Default model for `chat` and `run` (fallback: `gpt-5.4`)             |
| `output_format` | —                        | Default output format: `table`, `json`, `yaml`, `csv`, or `markdown` |

## Credentials

CLI використовує два типи облікових даних:

### API key

Required for all commands. API key автентифікує запити до CometAPI model endpoints.

Створіть 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

Optional. Access token required for account-level commands: `account`, `stats`, `tokens`, `logs`, and `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>

## Security

CLI застосовує такі практики безпеки:

* API keys і access tokens ніколи не логуються і не відображаються повністю. У вихідних даних діагностики показуються лише останні 4 символи.
* Config file створюється з обмеженими дозволами (`0600`) — читати його може лише власник файлу.
* Облікові дані ніколи не слід додавати до version control. За потреби додайте шлях до config file у `.gitignore`.

<Warning>
  Ви несете відповідальність за всі використання та витрати, пов’язані з вашими API keys. Зберігайте свої keys у безпеці та обертайте їх, якщо підозрюєте несанкціонований доступ.
</Warning>

## Troubleshooting

| Error                         | Solution                                                                                                |
| ----------------------------- | ------------------------------------------------------------------------------------------------------- |
| `API key not configured`      | Запустіть `cometapi init` або встановіть environment variable `COMETAPI_KEY`                            |
| `Connection failed`           | Запустіть `cometapi doctor`, щоб діагностувати проблеми з підключенням                                  |
| `Access token not configured` | Потрібно лише для `account`/`stats`/`tokens`/`logs`/`tasks`. Запустіть `cometapi init`, щоб додати його |