# Руководство по консоли (Dashboard)

Войдите на [qcode.cc](https://qcode.cc) и откройте консоль [qcode.cc/dashboard](https://qcode.cc/dashboard).
Сама консоль описывает себя одной строкой — *“Manage your API keys, top-up and usage”* — и это **одна**
страница: ключи, баланс, тарифы, расход, реферальные награды и поддержка находятся на ней.

> Неясно, чем ключ QCode отличается от подписки Claude / ChatGPT? Сначала
> [Subscriptions vs API Keys vs QCode Keys](/docs/reference/subscription-vs-api-key).
> Вы находитесь вне материкового Китая? Начните с [QCode для пользователей вне материкового Китая](/docs/getting-started/international-users).

## Что есть в консоли

| Блок | Что там делают |
|---|---|
| Пользовательская строка (справа сверху) | Видны e-mail входа и `ID: …`, баланс в обеих валютах, кнопки **Recharge** и **Buy Plan** |
| API Access Address | Копируют адрес, который идёт в `ANTHROPIC_BASE_URL` / `base_url` |
| API Key Management | Создают ключ, показывают и копируют его значение, продлевают, раскрывают просроченные ключи |
| One-Click Setup (внутри карточки ключа) | Копируют команду установки Claude Code или Codex |
| Open API | Управляют токеном доступа для программной проверки срока и расхода ключей |
| Usage Statistics | Расход квоты активного ключа и месячные итоги |
| Docs & Resources | Интеграции с IDE и популярные руководства |
| Service Guide / Referral Rewards / Quick Links | Правила работы, реферальная ссылка, получение награды, статьи помощи, коды ошибок, часы поддержки |

## API Access Address

Блок называется буквально **API Access Address**, и у каждой строки адреса есть своя кнопка копирования.
**Какая строка помечена как рекомендованная, зависит от языка интерфейса консоли, в котором вы вошли:**

- **Китайский интерфейс** — подсвечена `https://asia.qcode.cc/api`, а под ней показано примечание
  *“Mainland China users should use the accelerated address; others use the global address. Both offer
  identical performance”*.
- **Любой не-китайский интерфейс** (ныне английский, японский, русский) — подсвечена
  `https://api.qcode.cc`, а строки под ней помечены как **Backup** (США `https://us.qcode.cc/api`,
  Азия `https://asia.qcode.cc/api`).

Скопированный адрес всё равно нужно дополнить правильным **префиксом пути** под ваше средство — см.
[Эндпоинты и пути API](/docs/getting-started/endpoints-and-api-paths). Для Claude Code это выглядит так:

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"
```

## API-ключи: создание, просмотр и копирование

Блок с кнопкой **Create Key & Activate Service** — это **API Key Management**. Если ключа ещё нет, пустое
состояние прямо перечисляет порядок действий: **Top Up Balance** → **Buy a Plan** → **Start Using**.

1. Пополните баланс на [qcode.cc/recharge](https://qcode.cc/recharge) (см.
   [Обзор способов оплаты](/docs/reference/payment-methods)).
2. Выберите тариф на [qcode.cc/subscribe](https://qcode.cc/subscribe) — вкладка **Recommended Plans** или
   **Custom Configuration** — и подтвердите. Успешная покупка гласит
   *“Subscription Activated — Your API Key is created and ready to use”*; ключ показан с кнопкой
   копирования и ссылкой **Go to Dashboard**.
3. В консоли значение ключа **по умолчанию не отображается**: строка показывает *Loading…*, пока вы не
   нажмёте кнопку-глаз, а затем **Copy**. Если нажать копирование до загрузки, консоль сообщит об этом,
   вместо того чтобы скопировать пустую строку.

Что ещё в этом же блоке:

- Только что заказанный ключ может показывать *“API key is being activated, we will process it as soon as
  possible”* со ссылкой на онлайн-поддержку.
- У уже действующего ключа может быть кнопка **Renew** — быстрое продление за счёт баланса.
- Истратившие себя ключи лежат в свёрнутом списке **Expired keys** с пометкой *Key expired or disabled*.
- Каждая карточка ссылается на три клиента, которые обслуживает один ключ: Claude, Codex и Gemini.

## Команды установки в один клик

В каждой действующей карточке ключа есть блок **One-Click Setup (Recommended)** с вкладками
**macOS / Linux** и **Windows**, по одной команде для Claude Code и для Codex и со своей кнопкой **Copy**:

```bash
curl -fsSL https://qcode.cc/install/claude-code.sh | bash
curl -fsSL https://qcode.cc/install/codex.sh | bash
```

Подпись блока дословно: *“Paste your key above when the script prompts for it.”* На вкладке Windows это
эквиваленты `irm … | iex`, а ниже расположен свёрнутый раздел с командой для CMD и запускаемым скриптом —
для машин, где `irm` недоступен или блокируется политикой выполнения. Полный разбор, включая то, как задать
язык интерфейса скрипта, — в [Установка в один клик](/docs/getting-started/one-click-install).

## Usage Statistics

Блок **Usage Statistics** привязан к активному ключу (*“Quota usage for current active key”*) и может
обновляться по таймеру (Off / 5 / 10 / 30 / 60 минут) либо по кнопке **Refresh**.

| Раздел | О чём он |
|---|---|
| Daily Cost Limit | Максимальная трата за день; сброс в полночь по пекинскому времени, при достижении лимита API встаёт и возобновляется на следующий день |
| Time Window Limit | Число запросов и стоимость в скользящем 4-часовом окне. Личные тарифы *“removed the 4h rate window entirely in July 2026 — only the daily limit remains”*, поэтому раздел может показывать *No window limit* |
| Opus Weekly Limit | Отдельный недельный лимит для моделей уровня Opus, сброс по понедельникам (пекинское время); тарифы без Opus сообщают об этом здесь |
| Monthly Usage Overview | Total Tokens, Total Requests, Total Cost — считается со дня создания ключа |
| Today's Model Calls | Токены input / output / cache-write / cache-read по моделям за текущий день |
| Booster | Активен ли бустер-пакет; см. ниже |

Дисклеймер самой панели: *“Data shown here may have slight variations, actual limits are based on Claude Code
responses.”* Приблизительную стоимость сессии даёт `/cost` внутри Claude Code, а как деньги считаются — в
[Информации о тарификации](/docs/reference/billing).

## Пополнение, тарифы, бустеры и апгрейд

- **Балансы разделены по валютам.** *“CNY and USD balances are separate. Recharge amount will be added to the
  corresponding currency balance.”* Обе цифры стоят в пользовательской строке рядом.
- **Лимиты пополнения** на странице: минимум **¥100** для CNY, от **$1** до **$2,000** для USD; у отдельных
  каналов есть свои лимиты на транзакцию, и страница сообщает об этом при превышении:
  *“Due to the payment channel's per-transaction limit … Please split it into several smaller recharges.”*
- **После пополнения** консоль показывает баннер *“Balance received — You can activate a plan now.”* с кнопкой
  **Choose a plan**. Остаток не сгорает: *“Any balance left after your top-up isn't wasted: use it later toward
  an upgrade or a booster pack.”*
- **Покупка на несколько месяцев** скидочная: *“Subscribe for 3+ months for up to 25% off (12 months).”*
- **Бустер-пакеты** (*Self-service Booster Pack*) покупаются из консоли с баланса и расширяют лимит сразу;
  сброс в 02:00 по пекинскому времени (UTC+8).
- **Апгрейд** — это не кнопка в консоли: сначала купите более старший тариф, затем напишите на
  [hi@qcode.cc](mailto:hi@qcode.cc), чтобы старый закрыли и вернули неиспользованное на баланс.

## Субключи и командные возможности

Личная консоль работает по принципу **один основной ключ на тариф** — самостоятельного управления субключами
в ней **нет**. Субключи входят в командные продукты:

- Страница **Enterprise Team Edition** описывает *Sub-API Key Management Center* с
  *“fine-grained configuration and management for each team member”*: в таблице сравнения тарифов указаны
  *безлимитные субключи, каждый со своей квотой*. Там же заявлены
  **Bank Transfer Supported**, **Official Invoices Available** и **Custom Service Agreements**. Порядок
  подключения: [Руководство для команд](/docs/reference/enterprise-guide).
- На странице подписки командная карточка гласит *“Flexible quota & sub-key mgmt”* и отправляет писать на
  [hi@qcode.cc](mailto:hi@qcode.cc).
- Сама консоль предлагает только **навигацию** в тему команды: пункт **Team / Enterprise** в приветственном
  окне и диалог *Team Features* для Max X20 Team Edition («Multi-account management for team collaboration»,
  «Customized service…», «Dedicated technical support…»).
- **Реселлеры** получают отдельный Partner Dashboard с выдачей субключей — см.
  [Partner Open API Guide](/docs/reference/partner-api).

## Токен Open API

Карточка **Open API** гласит: *“Use an access token to query your API keys' expiry and daily usage
programmatically.”* Кнопка **Manage token** ведёт на `/dashboard/openapi-token`, где токен можно создать,
сбросить или отозвать:

```bash
curl -H "Authorization: Bearer qot_..." \
  https://qcode.cc/api/v1/openapi/keys
```

- На странице перечислены два read-only эндпоинта: срок и расход всех активных ключей, и сводка расхода по
  аккаунту.
- Токен показывается **один раз**: *“Your new token (shown only once) — copy it now”*, и далее *“We store only
  a hash — if you lose it, reset to get a new one (the old token stops working immediately).”*
- И сброс, и отзыв требуют подтверждения; после отзыва доступ Open API закрыт, пока не создадите новый токен.

## Поддержка и вопросы по заказам

- Строка **Support** в консоли: *“Weekdays 10:00 - 21:00 (UTC+8) online response”*, в нерабочее время сообщения
  *“checked intermittently, replies may be delayed”*, и *“Email available anytime: hi@qcode.cc”*.
- Живая поддержка — кнопка **Contact Us** в правом нижнем углу (Telegram или почта).
- **Request Urgent Processing** объясняет ожидание: на оформление и настройку нового аккаунта вверх по течению
  нужно от одного до двух часов.
- В Quick Links также есть **Usage Help** (база знаний) и **Common Error Codes**; по симптомам см.
  [Руководство по устранению неполадок](/docs/reference/troubleshooting) и
  [Справочник кодов ошибок](/docs/reference/errors).

## Связанные страницы

- [Обзор способов оплаты](/docs/reference/payment-methods) — какие каналы доступны на пополнении
- [Информация о тарификации](/docs/reference/billing) — как расход превращается в деньги
- [Эндпоинты и пути API](/docs/getting-started/endpoints-and-api-paths) — адрес плюс префикс пути
- [Переменные окружения](/docs/getting-started/environment) — куда их вписывать
- [Установка в один клик](/docs/getting-started/one-click-install) — что делают команды из консоли
- [Subscriptions vs API Keys vs QCode Keys](/docs/reference/subscription-vs-api-key)
- [Руководство для команд](/docs/reference/enterprise-guide) — субключи и закрывающие документы
- [Partner Open API Guide](/docs/reference/partner-api)
- [FAQ](/docs/reference/faq)