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

# الإعداد

> قم بإعداد CometAPI CLI: موقع ملف الإعداد، الإعدادات المتاحة، إدارة بيانات الاعتماد، متغيرات البيئة، وممارسات الأمان.

يقرأ CometAPI CLI الإعدادات من ملف إعداد TOML، ومتغيرات البيئة، وأعلام سطر الأوامر. وعندما يكون الإعداد نفسه متاحًا من عدة مصادر، يكون ترتيب الأولوية كما يلي:

**أعلام CLI > ملف الإعداد > متغيرات البيئة > القيم الافتراضية**

## ملف الإعداد

الموقع: `~/.config/cometapi/config.toml`

شغّل معالج الإعداد لإنشاء ملف الإعداد بشكل تفاعلي:

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

أو أدر الإعدادات الفردية باستخدام الأمر الفرعي `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
```

## الإعدادات المتاحة

| مفتاح الإعداد   | متغير البيئة             | الوصف                                                                       |
| --------------- | ------------------------ | --------------------------------------------------------------------------- |
| `api_key`       | `COMETAPI_KEY`           | مفتاح API (مطلوب لجميع الأوامر)                                             |
| `access_token`  | `COMETAPI_ACCESS_TOKEN`  | Access token لأوامر مستوى الحساب                                            |
| `base_url`      | `COMETAPI_BASE_URL`      | عنوان URL الأساسي لـ API (الافتراضي: `https://api.cometapi.com/v1`)         |
| `default_model` | `COMETAPI_DEFAULT_MODEL` | النموذج الافتراضي لـ `chat` و `run` (البديل الاحتياطي: `gpt-5.4`)           |
| `output_format` | —                        | تنسيق الإخراج الافتراضي: `table` أو `json` أو `yaml` أو `csv` أو `markdown` |

## بيانات الاعتماد

يستخدم CLI نوعين من بيانات الاعتماد:

### API key

مطلوب لجميع الأوامر. يقوم API key بمصادقة الطلبات إلى نقاط نهاية نماذج CometAPI.

أنشئ API key من [CometAPI Console → API Keys](https://www.cometapi.com/console/token).

قم بتعيينه بإحدى هذه الطرق:

<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

اختياري. Access token مطلوب لأوامر مستوى الحساب: `account` و `stats` و `tokens` و `logs` و `tasks`.

أنشئ Access token من [CometAPI Console → Personal Settings](https://www.cometapi.com/console/personal).

قم بتعيينه بإحدى هذه الطرق:

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

## الأمان

يطبق CLI ممارسات الأمان التالية:

* لا يتم أبدًا تسجيل API keys وAccess tokens أو عرضها كاملة. يتم إظهار آخر 4 أحرف فقط في مخرجات التشخيص.
* يتم إنشاء ملف الإعداد بأذونات مقيدة (`0600`) — بحيث لا يمكن قراءته إلا من قبل مالك الملف.
* يجب عدم تضمين بيانات الاعتماد أبدًا في نظام التحكم بالإصدارات. أضف مسار ملف الإعداد إلى `.gitignore` إذا كان ذلك منطبقًا.

<Warning>
  أنت مسؤول عن جميع مرات الاستخدام والرسوم المترتبة على مفاتيح API الخاصة بك. حافظ على أمان مفاتيحك وقم بتدويرها إذا اشتبهت في وجود وصول غير مصرّح به.
</Warning>

## استكشاف الأخطاء وإصلاحها

| الخطأ                         | الحل                                                                                     |
| ----------------------------- | ---------------------------------------------------------------------------------------- |
| `API key not configured`      | شغّل `cometapi init` أو عيّن متغير البيئة `COMETAPI_KEY`                                 |
| `Connection failed`           | شغّل `cometapi doctor` لتشخيص الاتصال                                                    |
| `Access token not configured` | مطلوب فقط لـ `account`/`stats`/`tokens`/`logs`/`tasks`. شغّل `cometapi init` لإضافة واحد |