# دليل خطة الفرق

صُممت خطة فرق QCode لـ **فرق التطوير المكوّنة من ثلاثة أشخاص أو أكثر**. وهي توفر نطاقًا مخصصًا، وإدارة مفاتيح API فرعية، وضمان الخدمة، وميزات مؤسسية أخرى. تُقاس بحصة الفرق × الوحدات: الوحدة الواحدة = $4,000 شهريًا، و35 طلبًا متزامنًا، ويوصى بـ 3–5 أشخاص. تتناول هذه المقالة القدرات الأساسية، وكيفية نشرها، والممارسات التي نوصي بها.

---

## خطة الفرق مقابل الخطط الشخصية

| | الشخصية | خطة الفرق |
|--------|--------|-----------|
| **نطاق API** | مشترك `api.qcode.cc` (متاح أيضًا للمستخدمين في الصين) | مخصص `e-xxx.qcode.cc` |
| **إدارة مفاتيح API** | مفتاح واحد | مفاتيح فرعية غير محدودة، لكل منها حصتها |
| **لوحة الإدارة** | لوحة أساسية | وحدة تحكم إدارة كاملة |
| **عزل API** | مثيل مشترك | مثيل خلفي مخصص |
| **ضمان الخدمة** | نعم | تُعالَج مشكلات الخدمة وتُستعاد في اليوم نفسه |
| **المراقبة الفورية** | أساسية | شاملة (الاستخدام / المعدل / التكلفة) |
| **التحويل البنكي للشركات** | لا | نعم |
| **الأدوات المدعومة** | Claude Code + Codex | Claude Code + Codex + Cline + Aider + OpenCode |
| **حجم الفريق** | شخص واحد | 3–100+ أشخاص |
| **القياس والسعر** | يعتمد على الخطة | حصة الفرق × الوحدات؛ الأسعار المتدرجة على [صفحة المؤسسات](https://qcode.cc/enterprise) |

> **الفرق الأساسي**: يحصل كل عميل مؤسسي على **مثيل خلفي ونطاق منفصلين تمامًا**، لذا تكون حركة API معزولة بالكامل عن العملاء الآخرين.

---

## الميزات الخمس الأساسية

### 1. النطاق المخصص ونظام الإدارة

يحصل كل عميل مؤسسي على نطاق مخصص `e-xxx.qcode.cc`:

```
Your team's API address:
https://e-xxx.qcode.cc/api

Admin console:
https://e-xxx.qcode.cc/admin
```

- وحدة تحكم منفصلة بنظام تسجيل دخول خاص بها
- عنوان API معزول بالكامل عن العملاء الآخرين
- مراقبة استخدام الفريق لـ API في الوقت الفعلي

### 2. إدارة مرنة لمفاتيح API الفرعية

يمكن للمسؤول إنشاء عدة مفاتيح API فرعية، لكل منها حصتها وحدودها:

```
Example key allocation for a team:
├── key-frontend-team    → daily quota $50, used by 3 people
├── key-backend-team     → daily quota $80, used by 4 people
├── key-devops           → daily quota $20, used by 2 people
└── key-intern           → daily quota $10, used by 1 person
```

- لا يوجد حد تقني لعدد المفاتيح الفرعية
- لكل مفتاح حصته وحدود معدل الطلبات الخاصة به
- إمكانية تفعيلها أو تعطيلها في أي وقت

### 3. ضمان الخدمة

عند ظهور مشكلة في الخدمة، تتعامل QCode معها وتستعيد الخدمة في اليوم نفسه:

- وحدة القياس هي حصة الفرق × الوحدات: الوحدة الواحدة = $4,000 شهريًا، و35 طلبًا متزامنًا، ويوصى بـ 3–5 أشخاص
- لزيادة التزامن أو الحصة، أضف المزيد من الوحدات
- للاطلاع على شروط الخدمة الدقيقة، راجع [صفحة المؤسسات](https://qcode.cc/enterprise)

### 4. دعم أدوات متعددة

حساب مؤسسي واحد، وتتشارك كل أدوات البرمجة بالذكاء الاصطناعي الحصة نفسها:

| الأداة | طريقة الإعداد |
|------|---------|
| **Claude Code** | `ANTHROPIC_BASE_URL=https://e-xxx.qcode.cc/api` |
| **Codex CLI** | `base_url = "https://e-xxx.qcode.cc/openai"` |
| **Cline** | عيّن Base URL الخاص بـ API في إعدادات VS Code |
| **Aider** | `--openai-api-base https://e-xxx.qcode.cc/openai` |
| **OpenCode** | عبر متغيرات البيئة |

### 5. يتوسع مع الفريق

ابدأ بوحدة واحدة وأضف المزيد متى احتجت:

| المرحلة | الوحدات | الفريق الموصى به (3–5 أشخاص لكل وحدة) |
|------|--------|---------|
| البداية | 1 | 3–5 أشخاص |
| النمو | 3 | 9–15 شخصًا |
| التوسع | 7 | 21–35 شخصًا |
| على نطاق واسع | 11+ | 33–55+ شخصًا |

السعر لكل شخص غير ثابت؛ الأسعار المتدرجة على [صفحة المؤسسات](https://qcode.cc/enterprise).

---
## دليل نشر الفريق

### الخطوة 1: فتح حساب مؤسسات

تواصل مع دعم QCode لفتح حساب مؤسسات:
- **الدردشة المباشرة**: [qcode.cc](https://qcode.cc)، في الزاوية السفلية اليمنى
- **البريد الإلكتروني**: hi@qcode.cc

أخبرنا بحجم فريقك، وعدد الوحدات التي تتوقع احتياجك إليها، وأي متطلبات خاصة.

### الخطوة 2: إعداد المسؤول

بعد فتحه، يسجّل المسؤول الدخول إلى لوحة التحكم المخصصة على `e-xxx.qcode.cc/admin`:

1. إنشاء مفاتيح API فرعية (واحد لكل عضو في الفريق أو لكل مجموعة)
2. تعيين حصة يومية لكل مفتاح
3. توزيعها على الفريق

### الخطوة 3: إعداد أعضاء الفريق

يعيّن كل عضو متغيرات البيئة محليًا:

**Claude Code:**
```bash
export ANTHROPIC_BASE_URL=https://e-xxx.qcode.cc/api
export ANTHROPIC_AUTH_TOKEN=cr_the_sub_key_your_admin_gave_you
```

**Codex CLI:**
```toml
# ~/.codex/config.toml
model_provider = "qcode"

[model_providers.qcode]
name = "qcode"
base_url = "https://e-xxx.qcode.cc/openai"
wire_api = "responses"
env_key = "QCODE_API_KEY"
```

```bash
export QCODE_API_KEY=cr_the_sub_key_your_admin_gave_you
```

### الخطوة 4: ملف CLAUDE.md مشترك للفريق

نوصي بإنشاء ملف CLAUDE.md واحد في جذر المشروع وإيداعه في Git ليتشاركه الفريق بأكمله:

```markdown
# Team project CLAUDE.md

## Team conventions
- Code style: follow .eslintrc and .prettierrc
- Git branches: feature/xxx; never push directly to main
- Every PR needs two approvals
- Test coverage above 80%

## Common commands
- dev: pnpm dev
- test: pnpm test
- build: pnpm build

## Notes
- Never commit an API key to the repository
- Sensitive files are listed in .gitignore
```

> للاطلاع على الدليل الكامل لـ CLAUDE.md راجع [إعداد CLAUDE.md](/docs/usage/claude-md).

### الخطوة 5: سياسة الأمان

استخدم Hooks لفرض سياسة أمان على مستوى الفريق بأكمله:

```json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [{
          "type": "command",
          "command": "echo $TOOL_INPUT | grep -qE 'rm -rf|sudo rm|git push --force' && exit 2 || exit 0"
        }]
      },
      {
        "matcher": "Read|Write|Edit",
        "hooks": [{
          "type": "command",
          "command": "echo $TOOL_INPUT | grep -qE '\\.env|credentials|secret' && exit 2 || exit 0"
        }]
      }
    ]
  }
}
```

> راجع [نظام Hooks](/docs/advanced/hooks) و[أفضل ممارسات الأمان](/docs/advanced/security).

---
## الأمان

| الضمان | التفصيل |
|--------|------|
| **عزل API كامل** | نطاق مخصص ومثيل خلفي مخصص لكل عميل |
| **عدم الاحتفاظ بالبيانات** | لا نخزّن الأكواد أو المحادثات أو بيانات الأعمال |
| **تمرير شفاف** | يُمرَّر كل طلب كما هو |
| **نشر متعدد المناطق** | عقد في مناطق متعددة (آسيا: كوريا / تايوان / هونغ كونغ؛ أمريكا الشمالية / أوروبا: لوس أنجلوس، الولايات المتحدة) مع تجاوز تلقائي للأعطال |
| **استجابة سريعة** | متاحون يوميًا عبر الإنترنت من 10:00 إلى 22:00؛ تُعالَج مشكلات الخدمة ويُستعاد العمل في اليوم نفسه |
| **الامتثال** | يمكننا توقيع اتفاقية أمن بيانات |

---

## مقارنة التكلفة

### مقارنة بالبناء الذاتي

| | البناء الذاتي | خطة الفرق من QCode |
|--------|---------|-------------|
| نظام الإدارة | تبنيه بنفسك | جاهز للاستخدام |
| ضمان الخدمة | مسؤوليتك | تُعالَج مشكلات الخدمة ويُستعاد العمل في اليوم نفسه |
| جهد التشغيل | يتطلب شخصًا مخصصًا | لا شيء |

### الأسعار

الفوترة لكل token؛ وتُدرج أسعار كل نموذج في [qcode.cc/models](https://qcode.cc/models). تُسعَّر خطة الفرق لكل وحدة؛ والأسعار المتدرجة على [qcode.cc/enterprise](https://qcode.cc/enterprise).

---

## الأسئلة الشائعة

### ما الحد الأدنى لعدد الوحدات؟

واحدة. الوحدة الواحدة = $4,000 شهريًا، وعدد الطلبات المتزامنة: 35، ويُوصى بـ3–5 أشخاص؛ أضف وحدات مع نمو الفريق.

### ماذا لو حدثت مشكلة في الخدمة؟

تتولى QCode معالجتها وتُعيد الخدمة في اليوم نفسه. وللحصول على تزامن أعلى، يمكنك إضافة المزيد من الوحدات.

### ما الأدوات المدعومة؟

Claude Code وCodex CLI وCline وAider وOpenCode. وتتشارك جميعها حصة واحدة.

### هل تدعمون التحويل البنكي للشركات؟

نعم. التحويل البنكي للشركات مدعوم ويمكننا توقيع اتفاقية خدمة رسمية.

### هل يمكننا التجربة قبل الشراء؟

بالتأكيد. اشترِ خطة Starter ($9/mo) من [صفحة الأسعار](https://qcode.cc/pricing) أولًا، أو باقة الدفع حسب الاستخدام (ابتداءً من $4، انظر [كيف تختار خطة](/docs/getting-started/choose-a-plan))، ثم ارتقِ إلى خطة الفرق عندما تطمئن إلى النتيجة.

### هل API متوافق مع الخطة الشخصية؟

تمامًا. الفرق الوحيد هو نطاق API (`e-xxx.qcode.cc` بدلًا من `api.qcode.cc`)؛ وما عدا ذلك فالإعداد متطابق، ولا حاجة إلى أي تغييرات في الكود.

---

## ابدأ الآن

جاهز للارتقاء بتجربة التطوير في فريقك؟

- **الدردشة المباشرة**: [qcode.cc](https://qcode.cc)، الزاوية السفلية اليمنى
- **البريد الإلكتروني**: hi@qcode.cc
- **تفاصيل خطة الفرق**: [qcode.cc/enterprise](https://qcode.cc/enterprise)

> عند تواصلك معنا، يُرجى إخبارنا بحجم فريقك، وعدد الأشخاص الذين سيستخدمون الخدمة، وعدد الوحدات التي تريدها.