# Часто задаваемые вопросы (FAQ)

## Платформа QCode.cc

### Q: Где получить API Key?

**A:** Войдите в [панель управления QCode.cc](https://qcode.cc/dashboard) и создайте или просмотрите свой API Key на странице «Управление API Key».

### Q: С чего начинается API Key?

**A:** API Key от QCode.cc начинается с `cr_`, например `cr_xxxxxxxxxxxxxx`.

### Q: Почему мой API Key не работает?

**A:** Распространённые причины:

1. **Ошибка при копировании**: проверьте, нет ли лишних пробелов или пропущенных символов
2. **Подписка истекла**: проверьте статус аккаунта в [панели управления](https://qcode.cc/dashboard)
3. **Переменная окружения не применилась**: откройте терминал заново или выполните `source ~/.zshrc`
4. **Неверная конечная точка API**: убедитесь, что `ANTHROPIC_BASE_URL` задан как `https://api.qcode.cc/api`

### Q: Мой API Key утёк — как его заменить?

**A:** Зависит от типа ключа:

- **Основной API Key (начинается с `cr_`)**: самостоятельного сброса сейчас нет. Как можно скорее напишите в [онлайн-поддержку](javascript:void(Tawk_API.toggle())) или на [hi@qcode.cc](mailto:hi@qcode.cc). Заодно проверьте по [рекомендациям по безопасности](/docs/advanced/security), не попал ли ключ в историю Git или в логи.
- **Токен доступа к открытому API (начинается с `rsk_`, для партнёров)**: на странице «Открытый API / Токен доступа» в консоли нажмите **Сбросить** — токен перевыпускается, а **старый сразу перестаёт работать**. См. [Открытый API для партнёров](/docs/reference/partner-api).

---

## Потребление и тарифы

### Q: Как посмотреть потребление текущей сессии?

**A:** Два способа:

**Dashboard (рекомендуется)**: войдите в [панель управления](https://qcode.cc/dashboard) и просмотрите количество вызовов моделей, детализацию расходов и потребление тарифа на странице «Статистика использования».

**Быстрый просмотр в CLI**: используйте команду `/cost` для просмотра сводки по текущей сессии:
```text
/cost
```

> Тарификация в Dashboard основана на [таблице цен qcode.cc/models](https://qcode.cc/models) и точнее, чем данные в CLI.

### Q: Есть ли лимит использования аккаунтов Max x20 в тарифах «Премиум» и «Корпоративный»?

**A:** Да. Лимит каждого аккаунта Max x20 составляет **$5 000** за 30 дней (фактическое потребление обычно $4 500–$4 800). Мы используем пул аккаунтных ресурсов, поэтому подавляющее большинство пользователей никогда не достигает этого лимита. При особых потребностях в высоком потреблении обратитесь в службу поддержки.

### Q: Каковы ограничения параллелизма и временного окна для каждого тарифа?

**A:**

**Ограничения параллелизма:**
- Индивидуальные тарифы (Базовый / Продвинутый / Премиум): **5 параллельных** запросов на один API Key
- Корпоративный тариф: **35 параллельных** запросов на один аккаунтный ресурс, поддерживает одновременную работу 3–5 пользователей

**Ограничение 4-часового временного окна:**
- Индивидуальные тарифы: **полностью отменено с июля 2026** — никаких ограничений временного окна
- Корпоративный тариф: **нет** ограничения временного окна, поддерживает непрерывную разработку

### Q: Поддерживается ли возврат средств?

**A:** Мы продаём цифровой сетевой товар. После активации аккаунтные ресурсы начинают использоваться, поэтому **возврат средств не поддерживается**.

**Альтернатива — перевод баланса**: переводы между участниками QCode поддерживаются. Найдя покупателя, отправьте письмо на [hi@qcode.cc](mailto:hi@qcode.cc) с указанием суммы перевода и email-адреса аккаунта QCode получателя. Перевод выполняется в течение 1 рабочего дня.

Возврат может быть рассмотрен только в следующих случаях: перебой в работе сервиса более 24 часов из-за сбоя платформы; одностороннее прекращение обслуживания платформой при наличии остатка; ошибочное пополнение, о котором сообщено в течение 24 часов и без какого-либо использования.

### Q: У меня есть подписка Claude Pro / ChatGPT Plus — можно ли использовать её с QCode?

**A:** Нет. Подписка — это членство в официальных приложениях, она не включает квоту API; QCode тарифицирует токены. Это независимые системы, они могут сосуществовать — подробности в [Подписка, официальный API и ключ QCode](/docs/reference/subscription-vs-api-key).

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

**A:** Для Claude Code, Codex, расширений IDE / CLI и десктопных клиентов есть отдельные страницы в разделе «Подключение инструментов»; какой протокол что поддерживает и работает ли Claude — в [Обзоре совместимости инструментов](/docs/ide/tool-compatibility).

### Q: Выдаёте ли вы счета (инвойсы), подойдёт ли он для возмещения расходов?

**A:** Да, счёт подходит для корпоративного возмещения расходов. За выставление счёта берётся сбор: **¥80, если сумма счёта меньше ¥2 000**, и **5% от суммы, если больше ¥2 000**. Убедитесь, что на балансе достаточно средств, и напишите на [hi@qcode.cc](mailto:hi@qcode.cc).

В корпоративном тарифе дополнительно доступны **банковский перевод от юрлица** и **официальные НДС-счета**, а также подписание официального договора. См. [Руководство по корпоративной версии](/docs/reference/enterprise-guide).

### Q: Появилось «достигнут дневной лимит расходов» — что делать?

**A:** Дневной лимит — это **потолок расходов на API за сутки**, он сбрасывается в **00:00 по пекинскому времени**. Есть два выхода:

1. **Купить бустер-пакет**: оформите его сами в [консоли](https://qcode.cc/dashboard), квота на сегодня увеличится сразу. Бустер-пакеты сбрасываются отдельно — в **02:00 по пекинскому времени на следующий день**, на два часа позже дневного лимита, что даёт запас, если вы работаете за полночь.
2. **Поднять дневной лимит**: измените параметры тарифа на [qcode.cc/pricing](https://qcode.cc/pricing).

> Ограничение по 4-часовому окну убрано со всех личных тарифов в июле 2026 года, поэтому это сообщение может относиться только к дневному лимиту, но не к оконному.

---

## Краткий справочник

### Q: Я купил тариф — с чего начать?

**A:** Три шага, примерно 60 секунд:

1. **Получите ключ**: войдите в [консоль](https://qcode.cc/dashboard) → «Управление API Key» и скопируйте ключ, начинающийся с `cr_`.
2. **Настройте**: запустите [скрипт установки в один клик](/docs/getting-started/one-click-install) или задайте `ANTHROPIC_BASE_URL` и `ANTHROPIC_AUTH_TOKEN` вручную (см. [Эндпоинты и форматы API](/docs/getting-started/endpoints-and-api-paths)).
3. **Выберите инструмент**: найдите свою IDE или CLI в разделе [Подключение инструментов](/docs/ide) и следуйте той странице.

Один ключ одновременно обслуживает Claude Code, Codex, Gemini и китайские модели — все они делят одну и ту же квоту тарифа.

### Q: Как установить Claude Code?

**A:** Установите глобально через npm, затем настройте переменные окружения:

```bash
npm install -g @anthropic-ai/claude-code
```

Подробные инструкции (для всех трёх платформ) → [Руководство по установке](/docs/getting-started/installation)

### Q: Как настроить прокси QCode.cc?

**A:** Задайте следующие переменные окружения:

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

Рекомендуется добавить их в файл конфигурации оболочки (`~/.zshrc` или `~/.bashrc`). Подробнее → [Руководство по установке](/docs/getting-started/installation)

### Q: Как перейти в Plan Mode?

**A:** Нажмите `Shift+Tab` дважды или задайте режим по умолчанию в `.claude/settings.json`:

```json
{ "permissions": { "defaultMode": "plan" } }
```

В Plan Mode Claude только анализирует запрос, не выполняя никаких действий.

### Q: Как переключить модель?

**A:** Используйте команду `/model`:

```text
/model opus
/model sonnet
```

### Q: Как попросить Claude сделать коммит или ревью кода?

**A:** Используйте `/commit` для создания коммита и `/review` для ревью кода. Можно также напрямую сказать Claude: «закоммить эти изменения» или «сделай ревью этого PR».

### Q: Как сообщить об ошибке?

**A:** Перейдите на [GitHub Issues](https://github.com/anthropics/claude-code/issues) и предоставьте шаги воспроизведения и соответствующую информацию об ошибке.

### Q: Может ли Claude генерировать изображения?

**A:** Модели Claude **понимают изображения, но не генерируют их** (про ввод изображений см. [Ввод изображений](/docs/usage/vision-input)).

Для генерации используйте `gpt-image-2` — он работает с тем же ключом `cr_`, полностью совместим с OpenAI и поддерживает и генерацию по тексту, и редактирование изображений. См. [gpt-image-2: генерация и редактирование изображений](/docs/usage/image-2).

---

## Дополнительная помощь

Не нашли ответ? Обратитесь к тематическим документам:

| Тема | Документация |
|------|---------|
| Управление контекстом, /compact, переполнение длинных сессий | [Управление контекстом](/docs/usage/context-management) |
| Настройка разрешений, правила allow/deny | [Разрешения](/docs/usage/permissions) |
| Конфигурация проекта CLAUDE.md | [Конфигурация CLAUDE.md](/docs/usage/claude-md) |
| Настройка и отладка MCP-серверов | [MCP-серверы](/docs/advanced/mcp) |
| Справочник кодов ошибок и устранение неполадок | [Коды ошибок](/docs/reference/errors) |
| Принципы тарификации и ценообразование | [Тарификация](/docs/reference/billing) |

**Связаться с поддержкой**: онлайн-чат в правом нижнем углу сайта или email [hi@qcode.cc](mailto:hi@qcode.cc)