> ## 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.
# Řešení problémů
> Příznak → příčina → oprava, plus často kladené otázky
## Rychlé vyhledávání
| Aplikace říká | Téměř jistě | Oprava |
| - | - | - |
| `401 Unauthorized`, `Invalid token` | Špatný klíč, chybějící znaky, vypršela platnost nebo zakázán | Vlož klíč na [stránku kontroly](https://gpt.teamsoclo.site/check) |
| `404 Not Found` | Base URL chybí `/v1` (nebo zdvojeno na `/v1/v1`) | Oprav Base URL |
| `No available channel for model ... under group ...` | Klíč jednoho balíčku volá model jiného balíčku | Použij model svého balíčku, viz [Modely](/cs/models) |
| `model not found`, okamžitá chyba názvu modelu | Překlep v názvu modelu | Zkopíruj název z [tabulky modelů](/cs/models) |
| `429 Too Many Requests` | Překročen limit požadavků klíče za minutu | Počkej na další minutu, zpomal |
| `insufficient quota` | Klíč vyčerpal všechny tokeny | Kup nový kód |
| Konfigurace upravena, ale nic se nemění | Aplikace nebyla plně ukončena nebo terminál nebyl znovu otevřen | Plně ukonči a znovu otevři |
## Klíče a kvóta
### Špatný nebo zkrácený klíč
Nejčastější problém není rozbitý klíč, ale **pár ztracených znaků** při výběru textu myší. Vždy používej tlačítko **Copy** na stránce uplatnění. Vlož klíč na [stránku kontroly](https://gpt.teamsoclo.site/check): pokud říká platný, klíč je v pořádku a problém je v konfiguraci aplikace.
### Klíč vypršel
Každý balíček má dobu platnosti počítanou od uplatnění (uvedeno na produktu). Po vypršení každý požadavek vrátí 401 i když zbývá kvóta. Stránka kontroly zobrazuje datum vypršení. Nevyužité tokeny se na nový kód nepřevádí.
### Kvóta vyčerpána
Vše fungovalo, pak najednou každý požadavek selže s *insufficient quota*. Zjisti, co zbývá na stránce kontroly. Neobvykle rychlé ubývání kvóty obvykle způsobuje agent čtoucí celé úložiště nebo velmi dlouhý rozhovor znovu odesílaný každý tah.
### Ztracený klíč
Uplatni stejný CDK kód znovu na [redeem.teamsoclo.site](https://redeem.teamsoclo.site); stránka zobrazí původní klíč. Kódy nejsou znovu vydávány s novým klíčem.
### Kolik počítačů na klíč
Žádný limit zařízení neexistuje, ale **limit požadavků za minutu** sdílí každý počítač používající klíč. Sdílení klíče znamená, že uživatelé soutěží o stejný limit a rychleji narazí na 429.
## Připojení
### Chybějící /v1
Správná Base URL je `https://gpt.teamsoclo.site/v1`. Bez `/v1` požadavky míří na web místo API a aplikace hlásí 404 nebo "nelze se připojit".
Opak také selže: některé aplikace (Chatbox, některé verze Cline) přidávají `/v1` samy. Pokud jsi ho zadal a stále dostáváš 404, zkus bez `/v1`; skutečná adresa se mohla stát `/v1/v1`.
### Volání modelu jiného balíčku
`No available channel for model gpt-astra under group default` znamená, že GPT klíč volá Astra model (nebo naopak). Každý klíč může volat pouze modely svého balíčku. Ověř s:
```bash theme={null}
curl https://gpt.teamsoclo.site/v1/models -H "Authorization: Bearer sk-xxx"
```
### 429 Too Many Requests
Každý klíč má maximální počet úspěšných požadavků za minutu nastavený jeho balíčkem. Pokud ho překročíš, dostaneš 429 se zprávou "request limit reached". Počkej na další minutu. V dávkových skriptech přidej zpoždění mezi voláními nebo kup další kód pro rozložení zátěže.
### Odpověď přerušena uprostřed
Pro otázky vyžadující dlouhé přemýšlení může být nestreamovaný požadavek zahozen před prvním tokenem. Povol `stream: true`. Většina chatovacích aplikací to již dělá; přidej to při volání z kódu.
### `Unsupported parameter: reasoning_effort`
Pouze Chat Completions přijímá nejvyšší úroveň `reasoning_effort`. S Responses API použij `"reasoning": {"effort": "high"}`. Codex to řeší sám.
## Codex
### `codex: command not found` po instalaci
npm skončil, ale aktuální terminál nenačetl PATH znovu. **Otevři nový terminál**. Pokud stále selže, zkontroluj, že adresář bin npm je v PATH:
```bash theme={null}
npm config get prefix
```
Tento adresář plus `/bin` musí být v `$PATH`.
### Codex stále žádá přihlášení OpenAI
Proměnná `TEAMSOCLO_API_KEY` nedosáhla procesu Codex:
* Terminál: otevři novou kartu, zkontroluj `echo $TEAMSOCLO_API_KEY`.
* VS Code na macOS: ukonči pomocí `Cmd + Q` a znovu otevři. Instalační příkaz nastavil proměnnou pro GUI aplikace přes `launchctl`.
* VS Code na Linuxu: spusť VS Code z terminálu (`code .`), nebo se odhlás a přihlas.
* Windows: otevři **nový** PowerShell nebo VS Code po `setx`.
Zkontroluj, že `config.toml` má `requires_openai_auth = false` a `env_key = "TEAMSOCLO_API_KEY"`.
### Upravil jsem config.toml, ale Codex se nemění
Konfigurace se načítá pouze při spuštění procesu. **Reload Window nestačí**; plně ukonči VS Code (macOS `Cmd + Q`, Windows zavři všechna okna a procesy na pozadí). To je nejčastěji kladená otázka o Codexu.
### `EACCES: permission denied` při instalaci npm
Node nainstalován s oprávněními systému, běžné na Linuxu. Změň prefix npm:
```bash theme={null}
npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
```
Přidej řádek `export` do `~/.bashrc` nebo `~/.zshrc`. Dlouhodobě nainstaluj Node přes nvm, viz [Začínáme](/cs/getting-started).
### Windows: `running scripts is disabled on this system`
PowerShell blokuje `.ps1` soubory a `codex` / `npm` napsané v PowerShell procházejí přes `.ps1` shims npm. Spusť jednou:
```powershell theme={null}
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
```
Pak otevři nový PowerShell. Nebo místo toho napiš `codex.cmd`, `npm.cmd`.
### Windows: `EBUSY: resource busy or locked`
Codex běží (CLI, rozšíření nebo aplikace), takže npm nemůže přepsat `codex.exe`. Zavři vše spouštějící Codex a znovu spusť instalační příkaz. Konfigurace byla zapsána již před tímto krokem; přeskočila se pouze aktualizace CLI.
### Windows: chyba kódování konfiguračního souboru
Úprava pomocí PowerShell 5.1 a `Set-Content -Encoding UTF8` přidá BOM, který Codex nemůže číst. Znovu použij [instalační příkaz](/cs/setup/codex) (zapíše UTF‑8 bez BOM), nebo ulož soubor ve VS Code jako **UTF-8** (ne UTF-8 with BOM).
### Obnovení předchozí konfigurace
Každé spuštění instalačního příkazu zálohuje starou konfiguraci vedle nové:
```bash theme={null}
ls ~/.codex/*.bak.*
cp ~/.codex/config.toml.bak.20260925143000 ~/.codex/config.toml
```
S nástrojem vyber **Resetovat** a obnoví automaticky.
## Často kladené otázky
### Jak změním klíče
Znovu spusť [příkaz instalace Codexu](/cs/setup/codex) s novým klíčem nebo znovu spusť nástroj. Pro Cursor, Cline a Chatbox uprav pole API Key v Nastavení.
### Je bezpečné spouštět instalační příkaz několikrát
Ano. Je navržen pro opakované spouštění: stará konfigurace se uloží jako `.bak.`, CLI se aktualizuje a starý řádek klíče v shell rc se nahradí.
### Posílá příkaz můj klíč někam
Ne. Vložíš klíč do příkazu na svém vlastním počítači; zapíše pouze proměnnou prostředí a místní konfigurační soubor. Celý příkaz se zobrazuje na stránce, přečti každý řádek před spuštěním.
### Odebrat vše
Viz **Odinstalace** na stránce [Codex](/cs/setup/codex). Pro ostatní aplikace jednoduše smaž klíč v Nastavení aplikace.
## Stále nefunguje
Vlož ho na [stránku kontroly](https://gpt.teamsoclo.site/check). Chyba zde znamená klíč (špatný, vypršel, bez kvóty), ne aplikaci.
```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"}]}'
```
Pokud toto funguje a aplikace ne, problém je v konfiguraci aplikace.
Base URL končí na `/v1`, klíč je kompletní, model odpovídá tvému balíčku. Ty způsobují téměř každý problém.
Pošli snímek obrazovky s chybou a poslední 4 znaky svého klíče na [t.me/teamsoclo](https://t.me/teamsoclo). Nikdy neposílej celý klíč.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.