Швидкий довідник
Ключі та квота
Неправильний або скорочений ключ
Найпоширеніша проблема — не зіпсований ключ, а кілька пропущених символів при виділенні тексту мишею. Завжди використовуйте кнопку Copy на сторінці активації. Вставте ключ на сторінку перевірки: якщо вона каже “valid”, ключ в порядку, а проблема в налаштуваннях застосунку.Ключ застарів
Кожен пакет має строк дії, що відраховується з моменту активації (вказано на продукті). Після закінчення терміну кожен запит повертає 401, навіть якщо залишилась квота. Сторінка перевірки показує термін дії. Невикористані токени не переносяться на новий код.Квота вичерпана
Все працювало, а потім раптом кожен запит повертає insufficient quota. Перевірте залишок на сторінці перевірки. Незвично швидке зменшення квоти зазвичай пов’язане з агентом, який читає весь репозиторій, або дуже довгим діалогом, що пересилається при кожному повідомленні.Втрачений ключ
Активуйте той самий CDK-код знову на redeem.teamsoclo.site; сторінка покаже оригінальний ключ. Коди не перевипускаються з новим ключем.Скільки пристроїв на один ключ
Обмеження пристроїв немає, але ліміт запитів на хвилину спільний для всіх пристроїв, що використовують ключ. Спільне використання ключа означає конкуренцію за той самий ліміт і швидше отримання 429.З’єднання
Відсутній /v1
Правильний Base URL:https://gpt.teamsoclo.site/v1. Без /v1 запити потрапляють на сайт, а не на API, і застосунок повідомляє 404 або “could not connect”.
Виклик моделі іншого пакету
No available channel for model gpt-astra under group default означає, що GPT-ключ викликає Astra-модель (або навпаки). Кожен ключ може викликати лише модель свого пакету. Перевірте:
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:
/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 (macOSCmd + Q, Windows закрийте всі вікна та фонові процеси). Це найпоширеніше запитання про Codex.
EACCES: permission denied при npm install
Node встановлено з правами системи, що поширено на Linux. Змініть prefix npm:
export до ~/.bashrc або ~/.zshrc. Довгостроково встановіть Node через nvm, дивіться Початок роботи.
Windows: running scripts is disabled on this system
PowerShell блокує .ps1-файли, і codex / npm, введені в PowerShell, використовують .ps1-шими npm. Виконайте один раз:
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 не може читати. Знову запустіть команду встановлення (записує UTF-8 без BOM), або збережіть файл у VS Code як UTF-8 (не UTF-8 з BOM).
Відновлення попередньої конфігурації
Кожен запуск команди встановлення робить резервну копію старого конфігу поряд з новим:Часті запитання
Як змінити ключ
Повторно запустіть команду встановлення Codex з новим ключем або повторно запустіть інструмент. Для Cursor, Cline і Chatbox відредагуйте поле API Key у налаштуваннях.Чи безпечно запускати команду встановлення кілька разів
Так. Вона призначена для повторного запуску: старий конфіг зберігається як.bak.<timestamp>, CLI оновлюється, а старий рядок з ключем у shell rc замінюється.
Чи надсилає команда мій ключ куди-небудь
Ні. Ви вставляєте ключ у команду на своєму комп’ютері; вона лише записує змінну середовища і локальний конфіг-файл. Вся команда відображається на сторінці — прочитайте кожен рядок перед запуском.Видалити все
Дивіться Uninstall на сторінці Codex. Для інших застосунків просто видаліть ключ у налаштуваннях застосунку.Все ще не працює
1
Чи активний ключ
Вставте його на сторінку перевірки. Помилка тут означає проблему з ключем (неправильний, застарів, вичерпано квоту), а не з застосунком.
2
Викличте API напряму через cURL
3
Перевірте три речі в застосунку
Base URL закінчується на
/v1, ключ повний, модель відповідає вашому пакету. Це причина майже кожної проблеми.4
Зверніться до підтримки
Надішліть скріншот помилки та останні 4 символи вашого ключа до t.me/teamsoclo. Ніколи не надсилайте повний ключ.