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

# Configuration

> Configurez la CLI CometAPI : emplacement du fichier de configuration, paramètres disponibles, gestion des identifiants, variables d’environnement et pratiques de sécurité.

La CLI CometAPI lit les paramètres à partir d’un fichier de configuration TOML, de variables d’environnement et d’options de ligne de commande. Lorsqu’un même paramètre est disponible depuis plusieurs sources, l’ordre de priorité est le suivant :

**Options CLI > fichier de configuration > variables d’environnement > valeurs par défaut**

## Fichier de configuration

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

Exécutez l’assistant de configuration pour créer le fichier de configuration de manière interactive :

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

Ou gérez des paramètres individuels avec la sous-commande `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
```

## Paramètres disponibles

| Clé de configuration | Variable d’environnement | Description                                                                |
| -------------------- | ------------------------ | -------------------------------------------------------------------------- |
| `api_key`            | `COMETAPI_KEY`           | API key (obligatoire pour toutes les commandes)                            |
| `access_token`       | `COMETAPI_ACCESS_TOKEN`  | Access token pour les commandes au niveau du compte                        |
| `base_url`           | `COMETAPI_BASE_URL`      | URL de base de l’API (par défaut : `https://api.cometapi.com/v1`)          |
| `default_model`      | `COMETAPI_DEFAULT_MODEL` | Modèle par défaut pour `chat` et `run` (repli : `gpt-5.4`)                 |
| `output_format`      | —                        | Format de sortie par défaut : `table`, `json`, `yaml`, `csv` ou `markdown` |

## Identifiants

La CLI utilise deux types d’identifiants :

### API key

Obligatoire pour toutes les commandes. L’API key authentifie les requêtes vers les endpoints de modèles CometAPI.

Créez une API key dans [CometAPI Console → API Keys](https://www.cometapi.com/console/token).

Définissez-la de l’une des façons suivantes :

<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

Facultatif. L’access token est requis pour les commandes au niveau du compte : `account`, `stats`, `tokens`, `logs` et `tasks`.

Générez un access token dans [CometAPI Console → Personal Settings](https://www.cometapi.com/console/personal).

Définissez-le de l’une des façons suivantes :

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

## Sécurité

La CLI applique les pratiques de sécurité suivantes :

* Les API keys et access tokens ne sont jamais journalisés ni affichés en entier. Seuls les 4 derniers caractères sont affichés dans la sortie de diagnostic.
* Le fichier de configuration est créé avec des permissions restrictives (`0600`) — lisible uniquement par le propriétaire du fichier.
* Les identifiants ne doivent jamais être commit dans le contrôle de version. Ajoutez le chemin du fichier de configuration à votre `.gitignore` si nécessaire.

<Warning>
  Vous êtes responsable de toute utilisation et de tous les frais engagés avec vos API keys. Conservez vos clés en sécurité et faites-les tourner si vous suspectez un accès non autorisé.
</Warning>

## Dépannage

| Erreur                        | Solution                                                                                                          |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `API key not configured`      | Exécutez `cometapi init` ou définissez la variable d’environnement `COMETAPI_KEY`                                 |
| `Connection failed`           | Exécutez `cometapi doctor` pour diagnostiquer la connectivité                                                     |
| `Access token not configured` | Nécessaire uniquement pour `account`/`stats`/`tokens`/`logs`/`tasks`. Exécutez `cometapi init` pour en ajouter un |