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

# Cấu hình

> Cấu hình CometAPI CLI: vị trí tệp cấu hình, các thiết lập khả dụng, quản lý thông tin xác thực, biến môi trường và các thực hành bảo mật.

CometAPI CLI đọc các thiết lập từ tệp cấu hình TOML, biến môi trường và cờ dòng lệnh. Khi cùng một thiết lập có sẵn từ nhiều nguồn, thứ tự ưu tiên là:

**Cờ CLI > tệp cấu hình > biến môi trường > mặc định**

## Tệp cấu hình

Vị trí: `~/.config/cometapi/config.toml`

Chạy trình hướng dẫn thiết lập để tạo tệp cấu hình theo cách tương tác:

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

Hoặc quản lý từng thiết lập bằng lệnh con `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
```

## Các thiết lập khả dụng

| Khóa cấu hình   | Biến môi trường          | Mô tả                                                                     |
| --------------- | ------------------------ | ------------------------------------------------------------------------- |
| `api_key`       | `COMETAPI_KEY`           | API key (bắt buộc cho mọi lệnh)                                           |
| `access_token`  | `COMETAPI_ACCESS_TOKEN`  | Access token cho các lệnh ở cấp tài khoản                                 |
| `base_url`      | `COMETAPI_BASE_URL`      | URL cơ sở của API (mặc định: `https://api.cometapi.com/v1`)               |
| `default_model` | `COMETAPI_DEFAULT_MODEL` | model mặc định cho `chat` và `run` (dự phòng: `gpt-5.4`)                  |
| `output_format` | —                        | Định dạng đầu ra mặc định: `table`, `json`, `yaml`, `csv` hoặc `markdown` |

## Thông tin xác thực

CLI sử dụng hai loại thông tin xác thực:

### API key

Bắt buộc cho mọi lệnh. API key xác thực các yêu cầu tới các endpoint model của CometAPI.

Tạo một API key tại [CometAPI Console → API Keys](https://www.cometapi.com/console/token).

Thiết lập bằng một trong các cách sau:

<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

Tùy chọn. Access token là bắt buộc cho các lệnh ở cấp tài khoản: `account`, `stats`, `tokens`, `logs` và `tasks`.

Tạo access token tại [CometAPI Console → Personal Settings](https://www.cometapi.com/console/personal).

Thiết lập bằng một trong các cách sau:

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

## Bảo mật

CLI áp dụng các thực hành bảo mật sau:

* API key và access token không bao giờ được ghi log hoặc hiển thị đầy đủ. Chỉ 4 ký tự cuối cùng được hiển thị trong đầu ra chẩn đoán.
* Tệp cấu hình được tạo với quyền hạn chế (`0600`) — chỉ chủ sở hữu tệp mới có thể đọc.
* Không bao giờ nên commit thông tin xác thực vào hệ thống quản lý phiên bản. Thêm đường dẫn tệp cấu hình vào `.gitignore` nếu phù hợp.

<Warning>
  Bạn chịu trách nhiệm cho mọi mức sử dụng và chi phí phát sinh với API key của mình. Hãy giữ khóa của bạn an toàn và xoay vòng chúng nếu bạn nghi ngờ có truy cập trái phép.
</Warning>

## Khắc phục sự cố

| Lỗi                           | Giải pháp                                                                           |
| ----------------------------- | ----------------------------------------------------------------------------------- |
| `API key not configured`      | Chạy `cometapi init` hoặc thiết lập biến môi trường `COMETAPI_KEY`                  |
| `Connection failed`           | Chạy `cometapi doctor` để chẩn đoán kết nối                                         |
| `Access token not configured` | Chỉ cần cho `account`/`stats`/`tokens`/`logs`/`tasks`. Chạy `cometapi init` để thêm |