> ## 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.

# Rozwiązywanie problemów

> Objaw → przyczyna → rozwiązanie, plus często zadawane pytania

## Szybkie wyszukiwanie

| Aplikacja mówi | Niemal na pewno | Rozwiązanie |
| - | - | - |
| `401 Unauthorized`, `Invalid token` | Błędny klucz, brakujące znaki, wygasły lub wyłączony | Wklej klucz na [stronie sprawdzania](https://gpt.teamsoclo.site/check) |
| `404 Not Found` | Base URL brakuje `/v1` (lub podwójne `/v1/v1`) | Popraw Base URL |
| `No available channel for model ... under group ...` | Klucz jednego pakietu wywołuje model drugiego pakietu | Użyj modelu swojego pakietu, zobacz [Modele](/pl/models) |
| `model not found`, natychmiastowy błąd nazwy modelu | Literówka w nazwie modelu | Skopiuj nazwę z [tabeli modeli](/pl/models) |
| `429 Too Many Requests` | Przekroczono limit żądań na minutę klucza | Poczekaj do następnej minuty, zwolnij |
| `insufficient quota` | Klucz zużył wszystkie tokeny | Kup nowy kod |
| Konfiguracja edytowana, ale nic się nie zmienia | Aplikacja nie w pełni zamknięta lub terminal nie otwarty ponownie | Zamknij całkowicie i otwórz ponownie |

## Klucze i limit

### Błędny lub obcięty klucz

Najczęstszy problem to nie zepsuty klucz, ale **kilka zgubionych znaków** przy zaznaczaniu tekstu myszą. Zawsze używaj przycisku **Copy** na stronie wymiany. Wklej klucz na [stronie sprawdzania](https://gpt.teamsoclo.site/check): jeśli mówi, że jest ważny, klucz jest prawidłowy, a problem leży w konfiguracji aplikacji.

### Klucz wygasł

Każdy pakiet ma okres ważności liczony od wymiany (podany na produkcie). Po wygaśnięciu każde żądanie zwraca 401, nawet jeśli pozostał limit. Strona sprawdzania pokazuje datę ważności. Niewykorzystane tokeny nie przechodzą na nowy kod.

### Limit wyczerpany

Wszystko działało, potem nagle każde żądanie kończy się błędem *insufficient quota*. Sprawdź, ile pozostało, na stronie sprawdzania. Limit spadający niezwykle szybko to zwykle agent czytający całe repozytorium lub bardzo długa rozmowa wysyłana ponownie przy każdej turze.

### Zgubiony klucz

Wymień ten sam kod CDK ponownie na [redeem.teamsoclo.site](https://redeem.teamsoclo.site); strona pokaże oryginalny klucz. Kody nie są ponownie wydawane z nowym kluczem.

### Ile urządzeń na klucz

Nie ma limitu urządzeń, ale **limit żądań na minutę** jest dzielony przez każde urządzenie używające klucza. Udostępnianie klucza oznacza, że użytkownicy konkurują o ten sam limit i szybciej trafiają na 429.

## Połączenie

### Brakujące /v1

Prawidłowy Base URL to `https://gpt.teamsoclo.site/v1`. Bez `/v1` żądania trafiają na stronę zamiast API, a aplikacja zgłasza 404 lub "nie można połączyć".

<Warning>
  Odwrotność też nie działa: niektóre aplikacje (Chatbox, niektóre wersje Cline) same dołączają `/v1`. Jeśli go wpisałeś i nadal dostajesz 404, spróbuj bez `/v1`; prawdziwy adres mógł stać się `/v1/v1`.
</Warning>

### Wywoływanie modelu innego pakietu

`No available channel for model gpt-astra under group default` oznacza, że klucz GPT wywołuje model Astra (lub odwrotnie). Każdy klucz może wywoływać tylko model własnego pakietu. Sprawdź:

```bash theme={null}
curl https://gpt.teamsoclo.site/v1/models -H "Authorization: Bearer sk-xxx"
```

### 429 Too Many Requests

Każdy klucz ma maksymalną liczbę udanych żądań na minutę ustawioną przez pakiet. Powyżej tego otrzymujesz 429 z komunikatem "request limit reached". Poczekaj do następnej minuty. W skryptach wsadowych dodaj opóźnienie między wywołaniami lub kup kolejny kod, aby rozłożyć obciążenie.

### Odpowiedź urwana w połowie

W przypadku pytań wymagających długiego myślenia, żądanie bez streamingu może zostać przerwane przed pierwszym tokenem. Włącz `stream: true`. Większość aplikacji czatowych już to robi; dodaj to przy wywołaniach z kodu.

### `Unsupported parameter: reasoning_effort`

Tylko Chat Completions akceptuje `reasoning_effort` na najwyższym poziomie. W Responses API użyj `"reasoning": {"effort": "high"}`. Codex obsługuje to samodzielnie.

## Codex

### `codex: command not found` po instalacji

npm zakończył pracę, ale obecny terminal nie przeładował PATH. **Otwórz nowy terminal**. Jeśli nadal nie działa, sprawdź, czy folder bin npm jest w PATH:

```bash theme={null}
npm config get prefix
```

Ten folder plus `/bin` musi być w `$PATH`.

### Codex nadal prosi o login OpenAI

Zmienna `TEAMSOCLO_API_KEY` nie dotarła do procesu Codex:

* Terminal: otwórz nową kartę, sprawdź `echo $TEAMSOCLO_API_KEY`.
* VS Code na macOS: zamknij `Cmd + Q` i otwórz ponownie. Polecenie instalacyjne ustawiło zmienną dla aplikacji GUI przez `launchctl`.
* VS Code na Linux: uruchom VS Code z terminala (`code .`) lub wyloguj się i zaloguj ponownie.
* Windows: otwórz **nowy** PowerShell lub VS Code po `setx`.

Sprawdź, czy `config.toml` zawiera `requires_openai_auth = false` i `env_key = "TEAMSOCLO_API_KEY"`.

### Edytowano config.toml, ale Codex się nie zmienia

Konfiguracja jest odczytywana tylko przy starcie procesu. **Reload Window nie wystarczy**; zamknij VS Code całkowicie (macOS `Cmd + Q`, Windows zamknij każde okno i proces w tle). To najczęściej zadawane pytanie dotyczące Codex.

### `EACCES: permission denied` przy npm install

Node został zainstalowany z uprawnieniami systemowymi, co jest powszechne na Linux. Zmień prefiks npm:

```bash theme={null}
npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
```

Dodaj wiersz `export` do `~/.bashrc` lub `~/.zshrc`. Długoterminowo: zainstaluj Node przez nvm, zobacz [Pierwsze kroki](/pl/getting-started).

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

PowerShell blokuje pliki `.ps1`, a `codex` / `npm` wpisane w PowerShell przechodzą przez shim `.ps1` npm. Uruchom raz:

```powershell theme={null}
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
```

Następnie otwórz nowy PowerShell. Lub wpisz `codex.cmd`, `npm.cmd`.

### Windows: `EBUSY: resource busy or locked`

Codex jest uruchomiony (CLI, rozszerzenie lub aplikacja), więc npm nie może nadpisać `codex.exe`. Zamknij wszystko, co uruchamia Codex, i uruchom ponownie polecenie instalacyjne. Konfiguracja była już zapisana przed tym krokiem; pominięto tylko aktualizację CLI.

### Windows: błąd kodowania pliku konfiguracyjnego

Edycja przez PowerShell 5.1 z `Set-Content -Encoding UTF8` dodaje BOM, którego Codex nie może odczytać. Użyj ponownie [polecenia instalacyjnego](/pl/setup/codex) (zapisuje UTF‑8 bez BOM) lub zapisz plik w VS Code jako **UTF-8** (nie UTF-8 z BOM).

### Przywróć poprzednią konfigurację

Każde uruchomienie polecenia instalacyjnego tworzy kopię zapasową starej konfiguracji obok nowej:

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

Za pomocą narzędzia wybierz **Resetuj** i przywróci automatycznie.

## Często zadawane pytania

### Jak zmienić klucze

Uruchom ponownie [polecenie instalacyjne Codex](/pl/setup/codex) z nowym kluczem lub uruchom ponownie narzędzie. W Cursor, Cline i Chatbox edytuj pole klucza API w Ustawieniach.

### Czy bezpiecznie jest uruchamiać polecenie instalacyjne kilka razy

Tak. Jest zaprojektowane do ponownych uruchomień: stara konfiguracja jest zapisywana jako `.bak.<timestamp>`, CLI jest aktualizowane, a stara linia klucza w rc powłoki jest zastępowana.

### Czy polecenie wysyła mój klucz gdzieś

Nie. Wklejasz klucz do polecenia na własnym komputerze; zapisuje tylko zmienną środowiskową i lokalny plik konfiguracyjny. Całe polecenie jest wyświetlane na stronie, przeczytaj każdą linię przed uruchomieniem.

### Usuń wszystko

Zobacz **Odinstalowanie** na stronie [Codex](/pl/setup/codex). W przypadku innych aplikacji po prostu usuń klucz w ustawieniach aplikacji.

## Nadal nie działa

<Steps>
  <Step title="Czy klucz jest aktywny">
    Wklej go na [stronie sprawdzania](https://gpt.teamsoclo.site/check). Błąd tutaj oznacza klucz (błędny, wygasły, brak limitu), nie aplikację.
  </Step>

  <Step title="Wywołaj API bezpośrednio przez 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"}]}'
    ```

    Jeśli to działa, a aplikacja nie, problem leży w konfiguracji aplikacji.
  </Step>

  <Step title="Sprawdź ponownie trzy rzeczy w aplikacji">
    Base URL kończy się na `/v1`, klucz jest kompletny, model pasuje do twojego pakietu. To powoduje prawie każdy problem.
  </Step>

  <Step title="Skontaktuj się z pomocą techniczną">
    Wyślij zrzut ekranu błędu i ostatnie 4 znaki swojego klucza do [t.me/teamsoclo](https://t.me/teamsoclo). Nigdy nie wysyłaj pełnego klucza.
  </Step>
</Steps>


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