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

# Konfiguration

> Konfiguriere die CometAPI CLI: Speicherort der Konfigurationsdatei, verfügbare Einstellungen, Anmeldedatenverwaltung, Umgebungsvariablen und Sicherheitspraktiken.

Die CometAPI CLI liest Einstellungen aus einer TOML-Konfigurationsdatei, Umgebungsvariablen und Befehlszeilen-Flags. Wenn dieselbe Einstellung aus mehreren Quellen verfügbar ist, gilt folgende Priorität:

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

## Konfigurationsdatei

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

Führe den Einrichtungsassistenten aus, um die Konfigurationsdatei interaktiv zu erstellen:

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

Oder verwalte einzelne Einstellungen mit dem Unterbefehl `config`:

```bash theme={null}
# Aktuelle Konfiguration anzeigen
cometapi config show

# Einen Wert setzen
cometapi config set api_key "$COMETAPI_KEY"

# Einen Wert entfernen
cometapi config unset api_key

# Den Pfad der Konfigurationsdatei anzeigen
cometapi config path
```

## Verfügbare Einstellungen

| Config key      | Environment variable     | Beschreibung                                                           |
| --------------- | ------------------------ | ---------------------------------------------------------------------- |
| `api_key`       | `COMETAPI_KEY`           | API key (erforderlich für alle Befehle)                                |
| `access_token`  | `COMETAPI_ACCESS_TOKEN`  | Access token für kontoebene Befehle                                    |
| `base_url`      | `COMETAPI_BASE_URL`      | API-Basis-URL (Standard: `https://api.cometapi.com/v1`)                |
| `default_model` | `COMETAPI_DEFAULT_MODEL` | Standard-Model für `chat` und `run` (Fallback: `gpt-5.4`)              |
| `output_format` | —                        | Standard-Ausgabeformat: `table`, `json`, `yaml`, `csv` oder `markdown` |

## Anmeldedaten

Die CLI verwendet zwei Arten von Anmeldedaten:

### API key

Erforderlich für alle Befehle. Der API key authentifiziert Anfragen an die CometAPI model endpoints.

Erstelle einen API key unter [CometAPI Console → API Keys](https://www.cometapi.com/console/token).

Lege ihn auf eine der folgenden Arten fest:

<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. Der Access token ist für kontoebene Befehle erforderlich: `account`, `stats`, `tokens`, `logs` und `tasks`.

Erzeuge einen Access token unter [CometAPI Console → Personal Settings](https://www.cometapi.com/console/personal).

Lege ihn auf eine der folgenden Arten fest:

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

## Sicherheit

Die CLI wendet die folgenden Sicherheitspraktiken an:

* API keys und Access tokens werden niemals vollständig protokolliert oder angezeigt. In Diagnoseausgaben werden nur die letzten 4 Zeichen angezeigt.
* Die Konfigurationsdatei wird mit restriktiven Berechtigungen (`0600`) erstellt — nur für den Dateieigentümer lesbar.
* Anmeldedaten sollten niemals in die Versionsverwaltung eingecheckt werden. Füge den Pfad der Konfigurationsdatei zu deiner `.gitignore` hinzu, falls zutreffend.

<Warning>
  Du bist für sämtliche Nutzung und anfallende Gebühren verantwortlich, die mit deinen API keys entstehen. Bewahre deine Schlüssel sicher auf und rotiere sie, wenn du unbefugten Zugriff vermutest.
</Warning>

## Fehlerbehebung

| Error                         | Lösung                                                                                                           |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `API key not configured`      | Führe `cometapi init` aus oder setze die Umgebungsvariable `COMETAPI_KEY`                                        |
| `Connection failed`           | Führe `cometapi doctor` aus, um die Verbindung zu diagnostizieren                                                |
| `Access token not configured` | Nur für `account`/`stats`/`tokens`/`logs`/`tasks` erforderlich. Führe `cometapi init` aus, um einen hinzuzufügen |