Saltar al contenido principal
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: 
cometapi init
O administra configuraciones individuales con el subcomando config: 
# View current configuration
cometapi config show

# Set a value
cometapi config set api_key sk-...

# Remove a value
cometapi config unset api_key

# Show the config file path
cometapi config path

​
Ajustes disponibles

Clave de configuraciónVariable de entornoDescripción
api_keyCOMETAPI_KEYAPI key (obligatoria para todos los comandos)
access_tokenCOMETAPI_ACCESS_TOKENAccess token para comandos a nivel de cuenta
base_urlCOMETAPI_BASE_URLURL base de la API (predeterminada: https://api.cometapi.com/v1)
default_modelCOMETAPI_DEFAULT_MODELModelo predeterminado para chat (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. Configúrala de una de estas maneras: 
export COMETAPI_KEY="<COMETAPI_KEY>"

​
Access token

Opcional. El access token es obligatorio para comandos a nivel de cuenta: account, stats, tokens, logs y tasks. Genera un access token en CometAPI Console → Personal Settings. Configúralo de una de estas maneras: 
export COMETAPI_ACCESS_TOKEN="your-access-token"

​
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 confirmarse en el control de versiones. Agrega la ruta del archivo de configuración a tu .gitignore si corresponde.
Eres responsable de todo uso y cargo generado con tus API keys. Mantén tus claves seguras y rótalas si sospechas de acceso no autorizado.

​
Resolución de problemas

ErrorSolución
API key not configuredEjecuta cometapi init o configura la variable de entorno COMETAPI_KEY
Connection failedEjecuta cometapi doctor para diagnosticar la conectividad
Access token not configuredSolo se necesita para account/stats/tokens/logs/tasks. Ejecuta cometapi init para agregar uno