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

# Yapılandırma

> CometAPI CLI'ını yapılandırın: config dosyası konumu, kullanılabilir ayarlar, kimlik bilgisi yönetimi, environment variables ve güvenlik uygulamaları.

CometAPI CLI, ayarları bir TOML config dosyasından, environment variables'tan ve komut satırı bayraklarından okur. Aynı ayar birden fazla kaynaktan उपलब्ध olduğunda, öncelik sırası şöyledir:

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

## Config dosyası

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

Config dosyasını etkileşimli olarak oluşturmak için kurulum sihirbazını çalıştırın:

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

Ya da `config` alt komutuyla tek tek ayarları yönetin:

```bash theme={null}
# Mevcut yapılandırmayı görüntüle
cometapi config show

# Bir değer ayarla
cometapi config set api_key "$COMETAPI_KEY"

# Bir değeri kaldır
cometapi config unset api_key

# Config dosyası yolunu göster
cometapi config path
```

## Kullanılabilir ayarlar

| Config anahtarı | Environment variable     | Açıklama                                                                |
| --------------- | ------------------------ | ----------------------------------------------------------------------- |
| `api_key`       | `COMETAPI_KEY`           | API key (tüm komutlar için gerekli)                                     |
| `access_token`  | `COMETAPI_ACCESS_TOKEN`  | Hesap düzeyi komutlar için access token                                 |
| `base_url`      | `COMETAPI_BASE_URL`      | API base URL (varsayılan: `https://api.cometapi.com/v1`)                |
| `default_model` | `COMETAPI_DEFAULT_MODEL` | `chat` ve `run` için varsayılan model (fallback: `gpt-5.4`)             |
| `output_format` | —                        | Varsayılan çıktı biçimi: `table`, `json`, `yaml`, `csv` veya `markdown` |

## Kimlik bilgileri

CLI iki tür kimlik bilgisi kullanır:

### API key

Tüm komutlar için gereklidir. API key, CometAPI model endpoints'lerine yapılan istekleri doğrular.

Bir API key oluşturmak için [CometAPI Console → API Keys](https://www.cometapi.com/console/token) adresine gidin.

Bunu aşağıdaki yöntemlerden biriyle ayarlayın:

<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

İsteğe bağlıdır. Access token, hesap düzeyi komutlar için gereklidir: `account`, `stats`, `tokens`, `logs` ve `tasks`.

Bir access token oluşturmak için [CometAPI Console → Personal Settings](https://www.cometapi.com/console/personal) adresine gidin.

Bunu aşağıdaki yöntemlerden biriyle ayarlayın:

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

## Güvenlik

CLI aşağıdaki güvenlik uygulamalarını uygular:

* API key'ler ve access token'lar asla tam olarak günlüğe kaydedilmez veya gösterilmez. Diagnostics çıktısında yalnızca son 4 karakter gösterilir.
* Config dosyası kısıtlayıcı izinlerle (`0600`) oluşturulur — yalnızca dosya sahibi tarafından okunabilir.
* Kimlik bilgileri asla version control'e commit edilmemelidir. Uygunsa config dosyası yolunu `.gitignore` dosyanıza ekleyin.

<Warning>
  API key'lerinizle yapılan tüm kullanımdan ve oluşan ücretlerden siz sorumlusunuz. Key'lerinizi güvende tutun ve yetkisiz erişimden şüpheleniyorsanız onları rotate edin.
</Warning>

## Sorun giderme

| Hata                          | Çözüm                                                                                                                |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `API key not configured`      | `cometapi init` çalıştırın veya `COMETAPI_KEY` environment variable'ını ayarlayın                                    |
| `Connection failed`           | Bağlantı sorunlarını teşhis etmek için `cometapi doctor` çalıştırın                                                  |
| `Access token not configured` | Yalnızca `account`/`stats`/`tokens`/`logs`/`tasks` için gereklidir. Bir tane eklemek için `cometapi init` çalıştırın |