# راهنمای پلن تیمی

پلن تیمی QCode برای **تیم‌های توسعه سه نفر یا بیشتر** ساخته شده است. این پلن دامنه اختصاصی، مدیریت کلید فرعی API، تضمین سرویس و سایر قابلیت‌های سازمانی را فراهم می‌کند. مبنای سنجش آن سهمیه تیم × واحد است: 1 واحد = $4,000 در ماه، 35 درخواست هم‌زمان، 3–5 نفر پیشنهاد می‌شود. این مقاله قابلیت‌های اصلی، نحوه استقرار و رویه‌هایی را که پیشنهاد می‌کنیم پوشش می‌دهد.

---

## پلن تیمی در برابر پلن شخصی

| | شخصی | پلن تیمی |
|--------|--------|-----------|
| **دامنه API** | اشتراکی `api.qcode.cc` (همچنین برای کاربران در چین در دسترس است) | اختصاصی `e-xxx.qcode.cc` |
| **مدیریت کلید API** | یک کلید | کلیدهای فرعی نامحدود، هر یک با سهمیه خودش |
| **پنل مدیریت** | پنل پایه | کنسول مدیریت کامل |
| **جداسازی API** | نمونه اشتراکی | نمونه بک‌اند اختصاصی |
| **تضمین سرویس** | بله | مشکلات سرویس همان روز رسیدگی و سرویس بازیابی می‌شود |
| **پایش لحظه‌ای** | پایه | جامع (مصرف / نرخ / هزینه) |
| **حواله بانکی شرکتی** | خیر | بله |
| **ابزارهای پشتیبانی‌شده** | Claude Code + Codex | Claude Code + Codex + Cline + Aider + OpenCode |
| **اندازه تیم** | 1 نفر | 3–100+ نفر |
| **سنجش و قیمت** | بسته به پلن | سهمیه تیم × واحدها؛ قیمت‌های پله‌ای در [صفحه /enterprise](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 همان روز به آن رسیدگی می‌کند و سرویس را بازیابی می‌کند:

- واحد سنجش، سهمیه تیم × واحدها است: 1 واحد = $4,000 در ماه، 35 درخواست هم‌زمان، 3–5 نفر پیشنهاد می‌شود
- برای هم‌زمانی بیشتر یا سهمیه بیشتر، واحدهای بیشتری اضافه کنید
- برای شرایط دقیق سرویس، [صفحه /enterprise](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+ نفر |

قیمت به‌ازای هر نفر ثابت نیست؛ قیمت‌های پله‌ای در [صفحه /enterprise](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 |
|--------|---------|-------------|
| سیستم مدیریت | خودتان بسازید | آماده استفاده |
| تضمین سرویس | مشکل خودتان | مشکلات سرویس در همان روز رسیدگی و رفع می‌شود |
| بار عملیاتی | نیازمند فرد اختصاصی | ندارد |

### قیمت‌گذاری

صورت‌حساب بر اساس توکن محاسبه می‌شود؛ نرخ هر مدل در [qcode.cc/models](https://qcode.cc/models) آمده است. قیمت پلن تیمی بر اساس واحد اعلام می‌شود؛ قیمت‌های پلکانی در [qcode.cc/enterprise](https://qcode.cc/enterprise) موجود است.

---

## پرسش‌های متداول

### حداقل تعداد واحد چقدر است؟

یک واحد. 1 واحد = $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)

> هنگام تماس، لطفاً اندازه تیم، تعداد افرادی که از آن استفاده می‌کنند و تعداد واحدهای موردنیاز خود را به ما اعلام کنید.