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

# Configuração

> Configure a CLI do CometAPI: localização do arquivo de configuração, configurações disponíveis, gerenciamento de credenciais, variáveis de ambiente e práticas de segurança.

A CLI do CometAPI lê configurações de um arquivo de configuração TOML, de variáveis de ambiente e de flags de linha de comando. Quando a mesma configuração está disponível em várias fontes, a ordem de prioridade é:

**Flags da CLI > arquivo de configuração > variáveis de ambiente > padrões**

## Arquivo de configuração

Localização: `~/.config/cometapi/config.toml`

Execute o assistente de configuração para criar o arquivo de configuração de forma interativa:

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

Ou gerencie configurações individuais com o 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
```

## Configurações disponíveis

| Chave de configuração | Variável de ambiente     | Descrição                                                             |
| --------------------- | ------------------------ | --------------------------------------------------------------------- |
| `api_key`             | `COMETAPI_KEY`           | API key (obrigatória para todos os comandos)                          |
| `access_token`        | `COMETAPI_ACCESS_TOKEN`  | Access token para comandos em nível de conta                          |
| `base_url`            | `COMETAPI_BASE_URL`      | URL base da API (padrão: `https://api.cometapi.com/v1`)               |
| `default_model`       | `COMETAPI_DEFAULT_MODEL` | Modelo padrão para `chat` e `run` (fallback: `gpt-5.4`)               |
| `output_format`       | —                        | Formato de saída padrão: `table`, `json`, `yaml`, `csv` ou `markdown` |

## Credenciais

A CLI usa dois tipos de credenciais:

### API key

Obrigatória para todos os comandos. A API key autentica requisições para os endpoints de modelo do CometAPI.

Crie uma API key em [CometAPI Console → API Keys](https://www.cometapi.com/console/token).

Defina-a de uma destas formas:

<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. O access token é necessário para comandos em nível de conta: `account`, `stats`, `tokens`, `logs` e `tasks`.

Gere um access token em [CometAPI Console → Personal Settings](https://www.cometapi.com/console/personal).

Defina-o de uma destas formas:

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

## Segurança

A CLI aplica as seguintes práticas de segurança:

* API keys e access tokens nunca são registrados em log nem exibidos por completo. Apenas os últimos 4 caracteres são mostrados na saída de diagnóstico.
* O arquivo de configuração é criado com permissões restritivas (`0600`) — legível apenas pelo proprietário do arquivo.
* As credenciais nunca devem ser commitadas no controle de versão. Adicione o caminho do arquivo de configuração ao seu `.gitignore`, se aplicável.

<Warning>
  Você é responsável por todo o uso e pelos custos gerados com suas API keys. Mantenha suas chaves seguras e faça a rotação delas se suspeitar de acesso não autorizado.
</Warning>

## Solução de problemas

| Erro                          | Solução                                                                                                     |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `API key not configured`      | Execute `cometapi init` ou defina a variável de ambiente `COMETAPI_KEY`                                     |
| `Connection failed`           | Execute `cometapi doctor` para diagnosticar a conectividade                                                 |
| `Access token not configured` | Necessário apenas para `account`/`stats`/`tokens`/`logs`/`tasks`. Execute `cometapi init` para adicionar um |