> ## 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: расположение файла конфигурации, доступные параметры, управление учетными данными, переменные окружения и практики безопасности.

CometAPI CLI читает настройки из TOML-файла конфигурации, переменных окружения и флагов командной строки. Когда одна и та же настройка доступна из нескольких источников, приоритет следующий:

**флаги CLI > файл конфигурации > переменные окружения > значения по умолчанию**

## Файл конфигурации

Расположение: `~/.config/cometapi/config.toml`

Запустите мастер настройки, чтобы создать файл конфигурации интерактивно:

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

## Доступные настройки

| Ключ конфигурации | Переменная окружения     | Описание                                                                  |
| ----------------- | ------------------------ | ------------------------------------------------------------------------- |
| `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`   | —                        | Формат вывода по умолчанию: `table`, `json`, `yaml`, `csv` или `markdown` |

## Учетные данные

CLI использует два типа учетных данных:

### API key

Требуется для всех команд. API key аутентифицирует запросы к model endpoints CometAPI.

Создайте 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 keys и access tokens никогда не логируются и не отображаются полностью. В диагностическом выводе показываются только последние 4 символа.
* Файл конфигурации создается с ограниченными правами доступа (`0600`) — доступен для чтения только владельцу файла.
* Учетные данные никогда не следует коммитить в систему контроля версий. Добавьте путь к файлу конфигурации в `.gitignore`, если это применимо.

<Warning>
  Вы несете ответственность за все использование и расходы, связанные с вашими API keys. Храните свои ключи в безопасности и отзывайте их, если подозреваете несанкционированный доступ.
</Warning>

## Устранение неполадок

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