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

# Configuración

> Configura la CLI de CometAPI: ubicación del archivo de configuración, ajustes disponibles, gestión de credenciales, variables de entorno y prácticas de seguridad.

La CLI de CometAPI lee la configuración desde un archivo de configuración TOML, variables de entorno y flags de línea de comandos. Cuando la misma configuración está disponible desde varias fuentes, el orden de prioridad es:

**Flags de CLI > archivo de configuración > variables de entorno > valores predeterminados**

## Archivo de configuración

Ubicación: `~/.config/cometapi/config.toml`

Ejecuta el asistente de configuración para crear el archivo de configuración de forma interactiva:

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

O administra configuraciones individuales con el subcomando `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
```

## Configuraciones disponibles

| Config key      | Environment variable     | Description                                                                   |
| --------------- | ------------------------ | ----------------------------------------------------------------------------- |
| `api_key`       | `COMETAPI_KEY`           | API key (obligatoria para todos los comandos)                                 |
| `access_token`  | `COMETAPI_ACCESS_TOKEN`  | Access token para comandos a nivel de cuenta                                  |
| `base_url`      | `COMETAPI_BASE_URL`      | URL base de la API (predeterminada: `https://api.cometapi.com/v1`)            |
| `default_model` | `COMETAPI_DEFAULT_MODEL` | Modelo predeterminado para `chat` y `run` (respaldo: `gpt-5.4`)               |
| `output_format` | —                        | Formato de salida predeterminado: `table`, `json`, `yaml`, `csv` o `markdown` |

## Credenciales

La CLI usa dos tipos de credenciales:

### API key

Obligatoria para todos los comandos. La API key autentica las solicitudes a los endpoints de modelos de CometAPI.

Crea una API key en [CometAPI Console → API Keys](https://www.cometapi.com/console/token).

Configúrala de una de estas maneras:

<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

Opcional. El access token es obligatorio para los comandos a nivel de cuenta: `account`, `stats`, `tokens`, `logs` y `tasks`.

Genera un access token en [CometAPI Console → Personal Settings](https://www.cometapi.com/console/personal).

Configúralo de una de estas maneras:

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

## Seguridad

La CLI aplica las siguientes prácticas de seguridad:

* Las API keys y los access tokens nunca se registran ni se muestran completos. Solo se muestran los últimos 4 caracteres en la salida de diagnóstico.
* El archivo de configuración se crea con permisos restrictivos (`0600`) — solo puede leerlo el propietario del archivo.
* Las credenciales nunca deben enviarse al control de versiones. Agrega la ruta del archivo de configuración a tu `.gitignore` si corresponde.

<Warning>
  Eres responsable de todo el uso y los cargos generados con tus API keys. Mantén tus claves seguras y rótalas si sospechas de acceso no autorizado.
</Warning>

## Solución de problemas

| Error                         | Solution                                                                                                   |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `API key not configured`      | Ejecuta `cometapi init` o configura la variable de entorno `COMETAPI_KEY`                                  |
| `Connection failed`           | Ejecuta `cometapi doctor` para diagnosticar la conectividad                                                |
| `Access token not configured` | Solo es necesario para `account`/`stats`/`tokens`/`logs`/`tasks`. Ejecuta `cometapi init` para agregar uno |