> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teamsoclo.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Устранение неполадок
> Симптом → причина → решение, плюс частые вопросы
## Быстрая таблица
| Приложение пишет | Почти наверняка | Решение |
| - | - | - |
| `401 Unauthorized`, `Invalid token` | Неверный ключ, пропущены символы, срок истёк или ключ отключён | Вставьте ключ на [странице проверки](https://gpt.teamsoclo.site/check) |
| `404 Not Found` | В Base URL нет `/v1` (или он удвоен до `/v1/v1`) | Исправьте Base URL |
| `No available channel for model ... under group ...` | Ключ одного пакета вызывает модель другого | Используйте модель своего пакета, см. [Модели](/ru/models) |
| `model not found`, мгновенная ошибка имени модели | Опечатка в имени модели | Скопируйте имя из [таблицы моделей](/ru/models) |
| `429 Too Many Requests` | Превышен лимит запросов в минуту для ключа | Подождите следующей минуты, снизьте частоту |
| `insufficient quota` | Ключ израсходовал все токены | Купите новый код |
| Конфиг изменён, но ничего не меняется | Приложение не закрыто полностью или терминал не переоткрыт | Полностью закройте и откройте снова |
## Ключи и квота
### Неверный или обрезанный ключ
Чаще всего проблема не в сломанном ключе, а в **потерянных символах** при выделении текста мышью. Всегда используйте кнопку **Copy** на странице активации. Вставьте ключ на [странице проверки](https://gpt.teamsoclo.site/check): если он действителен, ключ в порядке, а проблема в настройках приложения.
### Срок ключа истёк
У каждого пакета есть срок действия с момента активации (указан на товаре). После истечения каждый запрос возвращает 401, даже если квота осталась. Страница проверки показывает дату окончания. Неиспользованные токены на новый код не переносятся.
### Квота исчерпана
Всё работало, и вдруг каждый запрос падает с *insufficient quota*. Посмотрите остаток на странице проверки. Аномально быстрый расход обычно означает, что агент читает весь репозиторий или очень длинный диалог пересылается каждый ход.
### Потерян ключ
Активируйте тот же код CDK снова на [redeem.teamsoclo.site](https://redeem.teamsoclo.site); страница покажет исходный ключ. Новые ключи для уже активированных кодов не выдаются.
### Сколько машин на один ключ
Ограничения по устройствам нет, но **лимит запросов в минуту** делится между всеми машинами, использующими ключ. При совместном использовании пользователи конкурируют за один лимит и быстрее упираются в 429.
## Подключение
### Пропущен /v1
Правильный Base URL — `https://gpt.teamsoclo.site/v1`. Без `/v1` запросы уходят на сайт вместо API, и приложение показывает 404 или «не удалось подключиться».
Обратное тоже не работает: некоторые приложения (Chatbox, некоторые сборки Cline) сами добавляют `/v1`. Если вы его указали и всё равно 404, попробуйте без `/v1`: реальный адрес мог стать `/v1/v1`.
### Вызов модели другого пакета
`No available channel for model gpt-astra under group default` значит, что ключ GPT вызывает модель Astra (или наоборот). Каждый ключ вызывает только модель своего пакета. Проверьте:
```bash theme={null}
curl https://gpt.teamsoclo.site/v1/models -H "Authorization: Bearer sk-xxx"
```
### 429 Too Many Requests
У каждого ключа есть максимум успешных запросов в минуту, заданный пакетом. Сверх него вы получаете 429 с сообщением «request limit reached». Подождите следующей минуты. Для пакетных скриптов добавьте паузу между вызовами или купите ещё один код, чтобы разделить нагрузку.
### Ответ обрывается
На вопросах, требующих долгих размышлений, запрос без стриминга может оборваться до первого токена. Включите `stream: true`. Большинство чат-приложений уже так делают; при вызове из кода добавьте сами.
### `Unsupported parameter: reasoning_effort`
Верхнеуровневый `reasoning_effort` принимает только Chat Completions. В Responses API используйте `"reasoning": {"effort": "high"}`. Codex делает это сам.
## Codex
### `codex: command not found` после установки
npm завершился, но текущий терминал не перечитал PATH. **Откройте новый терминал**. Если не помогло, проверьте, что папка bin из npm есть в PATH:
```bash theme={null}
npm config get prefix
```
Эта папка плюс `/bin` должны быть в `$PATH`.
### Codex всё ещё просит войти в OpenAI
Переменная `TEAMSOCLO_API_KEY` не дошла до процесса Codex:
* Терминал: откройте новую вкладку, проверьте `echo $TEAMSOCLO_API_KEY`.
* VS Code на macOS: выйдите через `Cmd + Q` и откройте снова. Команда установки задала переменную для GUI-приложений через `launchctl`.
* VS Code на Linux: запустите VS Code из терминала (`code .`) или перелогиньтесь.
* Windows: откройте **новый** PowerShell или VS Code после `setx`.
Проверьте, что в `config.toml` есть `requires_openai_auth = false` и `env_key = "TEAMSOCLO_API_KEY"`.
### config.toml изменён, но Codex не меняется
Конфиг читается только при старте процесса. **Reload Window недостаточно**: полностью закройте VS Code (macOS `Cmd + Q`, Windows — все окна и фоновые процессы). Это самый частый вопрос про Codex.
### `EACCES: permission denied` при npm install
Node установлен с системными правами, часто на Linux. Смените prefix npm:
```bash theme={null}
npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
```
Добавьте строку `export` в `~/.bashrc` или `~/.zshrc`. В долгосрочной перспективе ставьте Node через nvm, см. [Начало работы](/ru/getting-started).
### Windows: `running scripts is disabled on this system`
PowerShell блокирует файлы `.ps1`, а набранные в PowerShell `codex` / `npm` идут через `.ps1`-шимы npm. Выполните один раз:
```powershell theme={null}
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
```
Затем откройте новый PowerShell. Или набирайте `codex.cmd`, `npm.cmd`.
### Windows: `EBUSY: resource busy or locked`
Codex запущен (CLI, расширение или приложение), и npm не может перезаписать `codex.exe`. Закройте всё, где работает Codex, и повторите команду установки. Конфиг уже записан до этого шага; пропущено только обновление CLI.
### Windows: ошибка кодировки конфига
Правка в PowerShell 5.1 через `Set-Content -Encoding UTF8` добавляет BOM, который Codex не читает. Снова выполните [команду установки](/ru/setup/codex) (пишет UTF‑8 без BOM) или сохраните файл в VS Code как **UTF-8** (не UTF-8 with BOM).
### Восстановить прежний конфиг
Каждый запуск команды установки сохраняет старый конфиг рядом с новым:
```bash theme={null}
ls ~/.codex/*.bak.*
cp ~/.codex/config.toml.bak.20260925143000 ~/.codex/config.toml
```
В инструменте выберите **Reset** — он восстановит сам.
## Частые вопросы
### Как сменить ключ
Повторите [команду установки Codex](/ru/setup/codex) с новым ключом или перезапустите инструмент. В Cursor, Cline и Chatbox измените поле API Key в Settings.
### Можно ли запускать команду установки несколько раз
Да. Она рассчитана на повтор: старый конфиг сохраняется как `.bak.<метка времени>`, CLI обновляется, старая строка ключа в rc-файле оболочки заменяется.
### Отправляет ли команда мой ключ куда-то
Нет. Вы вставляете ключ в команду на своей машине; она пишет только переменную окружения и локальный конфиг. Команда целиком показана на странице — прочитайте каждую строку перед запуском.
### Удалить всё
См. **Удаление** на странице [Codex](/ru/setup/codex). В других приложениях просто удалите ключ в их Settings.
## Всё ещё не работает
Вставьте его на [странице проверки](https://gpt.teamsoclo.site/check). Ошибка здесь означает проблему с ключом (неверный, истёк, без квоты), а не с приложением.
```bash theme={null}
curl https://gpt.teamsoclo.site/v1/chat/completions \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"hi"}]}'
```
Если это работает, а приложение нет, проблема в настройках приложения.
Base URL заканчивается на `/v1`, ключ полный, модель соответствует пакету. Это почти все причины.
Отправьте скриншот ошибки и последние 4 символа ключа в [t.me/teamsoclo](https://t.me/teamsoclo). Никогда не отправляйте ключ целиком.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.