> ## 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 ...` | Ключ одного пакету викликає модель іншого пакету | Використовуйте модель вашого пакету, дивіться [Моделі](/uk/models) |
| `model not found`, негайна помилка імені моделі | Помилка в назві моделі | Скопіюйте назву з [таблиці моделей](/uk/models) |
| `429 Too Many Requests` | Перевищено ліміт запитів на хвилину | Зачекайте до наступної хвилини, уповільніться |
| `insufficient quota` | Ключ вичерпав усі токени | Купіть новий код |
| Конфіг відредаговано, але нічого не змінилось | Застосунок не повністю закрито або термінал не перезапущено | Повністю закрийте і перевідкрийте |

## Ключі та квота

### Неправильний або скорочений ключ

Найпоширеніша проблема — не зіпсований ключ, а **кілька пропущених символів** при виділенні тексту мишею. Завжди використовуйте кнопку **Copy** на сторінці активації. Вставте ключ на [сторінку перевірки](https://gpt.teamsoclo.site/check): якщо вона каже "valid", ключ в порядку, а проблема в налаштуваннях застосунку.

### Ключ застарів

Кожен пакет має строк дії, що відраховується з моменту активації (вказано на продукті). Після закінчення терміну кожен запит повертає 401, навіть якщо залишилась квота. Сторінка перевірки показує термін дії. Невикористані токени не переносяться на новий код.

### Квота вичерпана

Все працювало, а потім раптом кожен запит повертає *insufficient quota*. Перевірте залишок на сторінці перевірки. Незвично швидке зменшення квоти зазвичай пов'язане з агентом, який читає весь репозиторій, або дуже довгим діалогом, що пересилається при кожному повідомленні.

### Втрачений ключ

Активуйте той самий CDK-код знову на [redeem.teamsoclo.site](https://redeem.teamsoclo.site); сторінка покаже оригінальний ключ. Коди не перевипускаються з новим ключем.

### Скільки пристроїв на один ключ

Обмеження пристроїв немає, але **ліміт запитів на хвилину** спільний для всіх пристроїв, що використовують ключ. Спільне використання ключа означає конкуренцію за той самий ліміт і швидше отримання 429.

## З'єднання

### Відсутній /v1

Правильний Base URL: `https://gpt.teamsoclo.site/v1`. Без `/v1` запити потрапляють на сайт, а не на API, і застосунок повідомляє 404 або "could not connect".

<Warning>
  Зворотне також не працює: деякі застосунки (Chatbox, деякі збірки Cline) самі додають `/v1`. Якщо ви його ввели і все одно отримуєте 404, спробуйте без `/v1`; реальна адреса могла стати `/v1/v1`.
</Warning>

### Виклик моделі іншого пакету

`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`

Лише Chat Completions приймає `reasoning_effort` на верхньому рівні. З 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, дивіться [Початок роботи](/uk/getting-started).

### Windows: `running scripts is disabled on this system`

PowerShell блокує `.ps1`-файли, і `codex` / `npm`, введені в PowerShell, використовують `.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 не може читати. Знову запустіть [команду встановлення](/uk/setup/codex) (записує UTF-8 без BOM), або збережіть файл у VS Code як **UTF-8** (не UTF-8 з BOM).

### Відновлення попередньої конфігурації

Кожен запуск команди встановлення робить резервну копію старого конфігу поряд з новим:

```bash theme={null}
ls ~/.codex/*.bak.*
cp ~/.codex/config.toml.bak.20260925143000 ~/.codex/config.toml
```

З інструментом виберіть **Reset** — він відновить автоматично.

## Часті запитання

### Як змінити ключ

Повторно запустіть [команду встановлення Codex](/uk/setup/codex) з новим ключем або повторно запустіть інструмент. Для Cursor, Cline і Chatbox відредагуйте поле API Key у налаштуваннях.

### Чи безпечно запускати команду встановлення кілька разів

Так. Вона призначена для повторного запуску: старий конфіг зберігається як `.bak.<timestamp>`, CLI оновлюється, а старий рядок з ключем у shell rc замінюється.

### Чи надсилає команда мій ключ куди-небудь

Ні. Ви вставляєте ключ у команду на своєму комп'ютері; вона лише записує змінну середовища і локальний конфіг-файл. Вся команда відображається на сторінці — прочитайте кожен рядок перед запуском.

### Видалити все

Дивіться **Uninstall** на сторінці [Codex](/uk/setup/codex). Для інших застосунків просто видаліть ключ у налаштуваннях застосунку.

## Все ще не працює

<Steps>
  <Step title="Чи активний ключ">
    Вставте його на [сторінку перевірки](https://gpt.teamsoclo.site/check). Помилка тут означає проблему з ключем (неправильний, застарів, вичерпано квоту), а не з застосунком.
  </Step>

  <Step title="Викличте API напряму через cURL">
    ```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"}]}'
    ```

    Якщо це працює, а застосунок — ні, проблема в конфігурації застосунку.
  </Step>

  <Step title="Перевірте три речі в застосунку">
    Base URL закінчується на `/v1`, ключ повний, модель відповідає вашому пакету. Це причина майже кожної проблеми.
  </Step>

  <Step title="Зверніться до підтримки">
    Надішліть скріншот помилки та останні 4 символи вашого ключа до [t.me/teamsoclo](https://t.me/teamsoclo). Ніколи не надсилайте повний ключ.
  </Step>
</Steps>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.