# Руководство по корпоративной версии

Корпоративная версия QCode рассчитана на **команды от 3 разработчиков** и даёт выделенный домен, управление дочерними API-ключами, защиту от блокировок и другие корпоративные возможности. В этой статье подробно разобраны ключевые функции, порядок развёртывания и лучшие практики.

---

## Корпоративная vs Персональная версия

| Параметр | Персональная | Корпоративная |
|--------|--------|-----------|
| **Домен API** | Общий `api.qcode.cc` (пользователям из Китая тоже доступен `api.qcode.cc`) | Выделенный `e-xxx.qcode.cc` |
| **Управление API Key** | 1 ключ | Неограниченно дочерних ключей с отдельными квотами |
| **Панель управления** | Базовая | Полноценная консоль администратора |
| **Изоляция API** | Общий инстанс | Отдельный бэкенд-инстанс |
| **Защита от блокировок** | Есть | Есть (замена в тот же день) |
| **Мониторинг в реальном времени** | Базовый | Полный (расход / частота / стоимость) |
| **Счета** | Нет | Банковский перевод от юрлица + официальные счета |
| **Поддерживаемые инструменты** | Claude Code + Codex | Claude Code + Codex + Cline + Aider + OpenCode + Gemini CLI |
| **Размер команды** | 1 человек | 3–100+ человек |
| **Стоимость на человека** | По тарифу | **от ¥320 в месяц** |

> **Главное отличие**: у каждого корпоративного клиента **полностью отдельный бэкенд-инстанс и домен**, поэтому трафик API изолирован от других клиентов.

---

## Пять ключевых возможностей

### 1. Выделенный домен и система управления

Каждый корпоративный клиент получает собственный домен `e-xxx.qcode.cc`:

```
Адрес API вашей команды:
https://e-xxx.qcode.cc/api

Панель администратора:
https://e-xxx.qcode.cc/admin
```

- Отдельная панель и отдельная система входа
- Адрес API полностью изолирован от других клиентов
- Мониторинг использования API командой в реальном времени

### 2. Гибкое управление дочерними API-ключами

Администратор может создавать несколько дочерних ключей, у каждого — своя квота и свои ограничения:

```
Пример распределения ключей в команде:
├── key-frontend-team    → дневная квота $50, 3 человека
├── key-backend-team     → дневная квота $80, 4 человека
├── key-devops           → дневная квота $20, 2 человека
└── key-intern           → дневная квота $10, 1 человек
```

- Технически количество дочерних ключей не ограничено
- У каждого ключа своя квота и свои ограничения частоты
- Включать и отключать можно в любой момент
- **Рекомендация**: оптимально, когда один аккаунт Max X20 используют 3 человека (это снижает риск блокировки из-за слишком частых обращений)

### 3. Защита от блокировок

Если аккаунт Max X20 заблокирован со стороны Anthropic, QCode **бесплатно и быстро заменит его**:

- В рабочее время замена занимает примерно **1–3 часа**
- В течение срока действия замена предоставляется бесплатно
- Конфигурация с несколькими аккаунтами снижает риск простоя

> **Настоятельно рекомендуем**: держите 2 и более аккаунтов — тогда даже во время замены основного команда сразу переключится на резервный.

### 4. Поддержка разных инструментов

Один корпоративный аккаунт — все AI-инструменты разработки делят общую квоту:

| Инструмент | Как настроить |
|------|---------|
| **Claude Code** | `ANTHROPIC_BASE_URL=https://e-xxx.qcode.cc/api` |
| **Codex CLI** | `base_url = "https://e-xxx.qcode.cc/openai"` |
| **Cline** | Указать API base URL в настройках VS Code |
| **Aider** | `--openai-api-base https://e-xxx.qcode.cc/openai` |
| **OpenCode** | Через переменные окружения |
| **Gemini CLI** | Через слой совместимости API |

### 5. Гибкое масштабирование под команду

Начните с одного аккаунта и добавляйте по мере необходимости:

| Этап | Аккаунтов | Рекомендуемая команда | Цена в месяц |
|------|--------|---------|---------|
| Старт | 1 | 3 человека | ¥1,800 |
| Рост | 3 | 9 человек | ¥1,760 |
| Расширение | 7 | 21 человек | ¥1,720 |
| Масштаб | 11+ | 33+ человек | ¥1,680 |

---

## Руководство по развёртыванию в команде

### Шаг 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_выданный_администратором_ключ
```

**Codex CLI:**
```toml
# ~/.codex/config.toml
[providers.openai]
base_url = "https://e-xxx.qcode.cc/openai"
```

```bash
export CRS_OAI_KEY=cr_выданный_администратором_ключ
```

### Шаг 4: общий CLAUDE.md для команды

Рекомендуем создать в корне проекта единый CLAUDE.md и закоммитить его в Git, чтобы им пользовалась вся команда:

```markdown
# CLAUDE.md командного проекта

## Правила команды
- Стиль кода: следовать .eslintrc и .prettierrc
- Ветки Git: feature/xxx, прямой push в main запрещён
- PR должен пройти ревью двух человек
- Покрытие тестами выше 80%

## Частые команды
- dev: pnpm dev
- test: pnpm test
- build: pnpm build

## Примечания
- Не коммитить API Key в репозиторий
- Список чувствительных файлов — в .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** | У каждого клиента свой домен и свой бэкенд-инстанс |
| **Данные не хранятся** | Код, диалоги и бизнес-данные не сохраняются |
| **Прозрачная пересылка запросов** | Все запросы напрямую передаются в вышестоящий API |
| **SLA 99.9%** | Узлы в нескольких регионах (Гонконг / Япония), автоматическое переключение |
| **Быстрая реакция** | 7 дней в неделю, 14 часов (9:00–23:00), блокировки решаются в тот же день |
| **Соответствие требованиям** | Возможно подписание соглашения о безопасности данных |

---

## Сравнение затрат

### По сравнению с собственным решением

| Параметр | Собственное решение | Корпоративный QCode |
|--------|---------|-------------|
| Месяц (команда 9 человек) | от ¥8,000 (аккаунты + серверы + сопровождение) | ¥5,280 (3 × Max X20) |
| На человека в месяц | от ¥890 | **¥533** |
| Система управления | Разрабатывать самим | Готова к использованию |
| Защита от блокировок | На вашей стороне | Бесплатная замена |
| Трудозатраты на эксплуатацию | Нужен отдельный человек | Нулевые |

### По сравнению с официальным Anthropic

| Параметр | Официальный Anthropic | Корпоративный QCode |
|--------|--------------|-------------|
| На человека в месяц | ~$60 (около ¥420) | **¥320–360** |
| Поддерживаемые инструменты | Только Claude Code | Claude Code + Codex и другие |
| Доступ из Китая | Нужен VPN | Прямое подключение к азиатским узлам |
| Счета | Зарубежные счета | **Официальные китайские счета** |
| Защита от блокировок | Нет | Бесплатная замена |

---

## Частые вопросы

### Какой минимум аккаунтов нужно купить?

Достаточно одного. Можно начать с одного аккаунта Max X20 и расширяться по мере роста команды.

### Что если аккаунт заблокируют?

QCode бесплатно и быстро заменит его — в тот же день, когда обнаружена блокировка. Чтобы снизить риск простоя, рекомендуем держать несколько аккаунтов.

### Какие инструменты поддерживаются?

Claude Code, Codex CLI, Cline, Aider, OpenCode, Gemini CLI. Одна квота делится между всеми инструментами.

### Поддерживается ли банковский перевод от юрлица?

Да. Мы выставляем официальные НДС-счета (сбор за оформление 5%) и можем подписать официальный договор на обслуживание.

### Можно сначала попробовать?

Конечно. Сначала купите персональный пробный тариф на [странице цен](https://qcode.cc/pricing) (¥60 в месяц), а после — перейдите на корпоративный.

### Совместим ли API с персональной версией?

Полностью. У корпоративной версии отличается только домен API (`e-xxx.qcode.cc` вместо `api.qcode.cc`), всё остальное настраивается одинаково — код менять не нужно.

---

## Начать сейчас

Готовы улучшить условия разработки для команды?

- **Онлайн-чат**: [qcode.cc](https://qcode.cc), кнопка в правом нижнем углу
- **Почта**: hi@qcode.cc
- **Подробнее о корпоративной версии**: [qcode.cc/enterprise](https://qcode.cc/enterprise)

> При обращении укажите: размер команды, ожидаемое число пользователей и желаемое количество аккаунтов.