> ## 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.

# Konfiguracja

> Skonfiguruj CometAPI CLI: lokalizację pliku konfiguracyjnego, dostępne ustawienia, zarządzanie poświadczeniami, zmienne środowiskowe i praktyki bezpieczeństwa.

CometAPI CLI odczytuje ustawienia z pliku konfiguracyjnego TOML, zmiennych środowiskowych i flag wiersza poleceń. Gdy to samo ustawienie jest dostępne z wielu źródeł, kolejność priorytetu jest następująca:

**Flagi CLI > plik konfiguracyjny > zmienne środowiskowe > wartości domyślne**

## Plik konfiguracyjny

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

Uruchom kreatora konfiguracji, aby utworzyć plik konfiguracyjny interaktywnie:

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

Możesz też zarządzać pojedynczymi ustawieniami za pomocą podpolecenia `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
```

## Dostępne ustawienia

| Klucz konfiguracji | Zmienna środowiskowa     | Opis                                                                     |
| ------------------ | ------------------------ | ------------------------------------------------------------------------ |
| `api_key`          | `COMETAPI_KEY`           | Klucz API (wymagany dla wszystkich poleceń)                              |
| `access_token`     | `COMETAPI_ACCESS_TOKEN`  | Token dostępu do poleceń na poziomie konta                               |
| `base_url`         | `COMETAPI_BASE_URL`      | Podstawowy URL API (domyślnie: `https://api.cometapi.com/v1`)            |
| `default_model`    | `COMETAPI_DEFAULT_MODEL` | Domyślny model dla `chat` i `run` (rezerwowy: `gpt-5.4`)                 |
| `output_format`    | —                        | Domyślny format wyjściowy: `table`, `json`, `yaml`, `csv` lub `markdown` |

## Poświadczenia

CLI używa dwóch typów poświadczeń:

### Klucz API

Wymagany dla wszystkich poleceń. Klucz API uwierzytelnia żądania do punktów końcowych modelu CometAPI.

Utwórz klucz API w [CometAPI Console → API Keys](https://www.cometapi.com/console/token).

Ustaw go jedną z tych metod:

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

### Token dostępu

Opcjonalny. Token dostępu jest wymagany dla poleceń na poziomie konta: `account`, `stats`, `tokens`, `logs` i `tasks`.

Wygeneruj token dostępu w [CometAPI Console → Personal Settings](https://www.cometapi.com/console/personal).

Ustaw go jedną z tych metod:

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

## Bezpieczeństwo

CLI stosuje następujące praktyki bezpieczeństwa:

* Klucze API i tokeny dostępu nigdy nie są logowane ani wyświetlane w całości. W danych diagnostycznych pokazywane są tylko ostatnie 4 znaki.
* Plik konfiguracyjny jest tworzony z restrykcyjnymi uprawnieniami (`0600`) — odczytywalny tylko przez właściciela pliku.
* Poświadczeń nigdy nie należy commitować do kontroli wersji. W razie potrzeby dodaj ścieżkę do pliku konfiguracyjnego do `.gitignore`.

<Warning>
  Ponosisz odpowiedzialność za wszelkie użycie i opłaty poniesione przy użyciu swoich kluczy API. Przechowuj klucze w bezpieczny sposób i rotuj je, jeśli podejrzewasz nieautoryzowany dostęp.
</Warning>

## Rozwiązywanie problemów

| Błąd                          | Rozwiązanie                                                                                             |
| ----------------------------- | ------------------------------------------------------------------------------------------------------- |
| `API key not configured`      | Uruchom `cometapi init` lub ustaw zmienną środowiskową `COMETAPI_KEY`                                   |
| `Connection failed`           | Uruchom `cometapi doctor`, aby zdiagnozować łączność                                                    |
| `Access token not configured` | Potrzebny tylko dla `account`/`stats`/`tokens`/`logs`/`tasks`. Uruchom `cometapi init`, aby dodać jeden |