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

# Sorun Giderme

> Belirti → neden → çözüm ve sık sorulan sorular

## Hızlı arama

| Uygulama diyor ki | Neredeyse kesinlikle | Çözüm |
| - | - | - |
| `401 Unauthorized`, `Invalid token` | Yanlış anahtar, eksik karakterler, süresi dolmuş veya devre dışı | Anahtarı [kontrol sayfasına](https://gpt.teamsoclo.site/check) yapıştır |
| `404 Not Found` | Base URL'de `/v1` eksik (veya `/v1/v1` olmuş) | Base URL'yi düzelt |
| `No available channel for model ... under group ...` | Bir paketin anahtarı diğer paketin modelini çağırıyor | Paketinin modelini kullan, bkz. [Modeller](/tr/models) |
| `model not found`, anlık model adı hatası | Model adında yazım hatası | Adı [model tablosundan](/tr/models) kopyala |
| `429 Too Many Requests` | Anahtarın dakika başına istek sınırı aşıldı | Bir sonraki dakikayı bekle, yavaşla |
| `insufficient quota` | Anahtar tüm tokenlarını tüketti | Yeni bir kod satın al |
| Yapılandırma düzenlendi ama hiçbir şey değişmedi | Uygulama tamamen kapatılmadı veya terminal yeniden açılmadı | Tamamen kapat ve yeniden aç |

## Anahtarlar ve kota

### Yanlış veya kısaltılmış anahtar

En yaygın sorun bozuk bir anahtar değil, **fare ile metin seçilirken kaybolan birkaç karakter**tir. Kullanım sayfasındaki **Copy** butonunu her zaman kullan. Anahtarı [kontrol sayfasına](https://gpt.teamsoclo.site/check) yapıştır: geçerli diyorsa anahtar iyi demektir ve sorun uygulama yapılandırmasındadır.

### Anahtarın süresi dolmuş

Her paketin kullanımdan itibaren sayılan bir geçerlilik süresi vardır (üründe yazılıdır). Süresi dolduktan sonra kota kalmış olsa bile her istek 401 döndürür. Kontrol sayfası son kullanım tarihini gösterir. Kullanılmayan tokenlar yeni koda aktarılmaz.

### Kota tükendi

Her şey çalışıyordu, sonra aniden her istek *insufficient quota* ile başarısız oluyor. Kontrol sayfasında ne kaldığına bak. Kotanın alışılmadık hızda azalması genellikle tüm depoyu okuyan bir ajan veya her turda yeniden gönderilen çok uzun bir konuşmadan kaynaklanır.

### Anahtar kayboldu

[redeem.teamsoclo.site](https://redeem.teamsoclo.site) adresinde aynı CDK kodunu tekrar kullan; sayfa orijinal anahtarı gösterir. Kodlar yeni bir anahtarla yeniden verilmez.

### Anahtar başına kaç makine

Cihaz sınırı yoktur, ancak **dakika başına istek sınırı** anahtarı kullanan her makine tarafından paylaşılır. Anahtar paylaşmak, kullanıcıların aynı sınır için rekabet etmesi ve 429'a daha erken çarpmasi anlamına gelir.

## Bağlantı

### /v1 eksik

Doğru Base URL `https://gpt.teamsoclo.site/v1`'dir. `/v1` olmadan istekler API yerine web sitesine gider ve uygulama 404 veya "bağlanılamadı" hatası bildirir.

<Warning>
  Tersi de başarısız olur: bazı uygulamalar (Chatbox, bazı Cline sürümleri) `/v1`'i kendileri ekler. Girdiysen ve hala 404 alıyorsan, gerçek adres `/v1/v1` olmuş olabilir, `/v1` olmadan dene.
</Warning>

### Diğer paketin modelini çağırma

`No available channel for model gpt-astra under group default` bir GPT anahtarının Astra modelini çağırdığı anlamına gelir (veya tersi). Her anahtar yalnızca kendi paketinin modellerini çağırabilir. Şununla doğrula:

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

### 429 Too Many Requests

Her anahtarın paketi tarafından belirlenen dakika başına maksimum başarılı istek sayısı vardır. Bu sayıyı aşarsan "request limit reached" mesajıyla 429 alırsın. Bir sonraki dakikayı bekle. Toplu scriptlerde çağrılar arasına gecikme ekle veya yükü dağıtmak için başka bir kod satın al.

### Yanıt ortada kesildi

Uzun düşünme gerektiren sorular için, akış dışı bir istek ilk tokenden önce atılabilir. `stream: true`'yu etkinleştir. Çoğu sohbet uygulaması bunu zaten yapıyor; koddan çağırırken ekle.

### `Unsupported parameter: reasoning_effort`

Yalnızca Chat Completions üst düzey `reasoning_effort`'ı kabul eder. Responses API ile `"reasoning": {"effort": "high"}` kullan. Codex bunu kendisi halleder.

## Codex

### Kurulumdan sonra `codex: command not found`

npm tamamlandı ancak mevcut terminal PATH'ı yeniden yüklemedi. **Yeni bir terminal aç**. Hala başarısız olursa, npm'nin bin klasörünün PATH'ta olup olmadığını kontrol et:

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

Bu klasör artı `/bin` `$PATH`'ta olmalıdır.

### Codex hala OpenAI girişi istiyor

`TEAMSOCLO_API_KEY` değişkeni Codex sürecine ulaşmadı:

* Terminal: yeni sekme aç, `echo $TEAMSOCLO_API_KEY`'i kontrol et.
* macOS'ta VS Code: `Cmd + Q` ile kapat ve yeniden aç. Kurulum komutu değişkeni GUI uygulamaları için `launchctl` üzerinden ayarladı.
* Linux'ta VS Code: VS Code'u terminalden başlat (`code .`) veya oturumu kapat ve tekrar aç.
* Windows: `setx`'ten sonra **yeni** bir PowerShell veya VS Code aç.

`config.toml`'da `requires_openai_auth = false` ve `env_key = "TEAMSOCLO_API_KEY"` olduğunu kontrol et.

### config.toml'ı düzenledim ama Codex değişmiyor

Yapılandırma yalnızca süreç başlangıcında okunur. **Pencereyi Yeniden Yükle yetmez**; VS Code'u tamamen kapat (macOS `Cmd + Q`, Windows tüm pencereleri ve arka plan süreçlerini kapat). Bu en sık sorulan Codex sorusudur.

### npm kurulumunda `EACCES: permission denied`

Node sistem ayrıcalıklarıyla kurulmuş, Linux'ta yaygın. npm'nin önekini değiştir:

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

`export` satırını `~/.bashrc` veya `~/.zshrc`'ye ekle. Uzun vadede Node'u nvm üzerinden kur, bkz. [Başlarken](/tr/getting-started).

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

PowerShell `.ps1` dosyalarını engeller ve PowerShell'de yazılan `codex` / `npm` npm'nin `.ps1` shimlerinden geçer. Bir kez çalıştır:

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

Ardından yeni bir PowerShell aç. Ya da bunun yerine `codex.cmd`, `npm.cmd` yaz.

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

Codex çalışıyor (CLI, eklenti veya uygulama), bu yüzden npm `codex.exe`'nin üzerine yazamıyor. Codex çalıştıran her şeyi kapat ve kurulum komutunu yeniden çalıştır. Yapılandırma bu adımdan önce zaten yazıldı; yalnızca CLI güncellemesi atlandı.

### Windows: yapılandırma dosyası kodlama hatası

PowerShell 5.1 ve `Set-Content -Encoding UTF8` ile düzenleme, Codex'in okuyamadığı bir BOM ekler. [Kurulum komutunu](/tr/setup/codex) tekrar kullan (BOM olmadan UTF‑8 yazar) ya da dosyayı VS Code'da **UTF-8** (UTF-8 with BOM değil) olarak kaydet.

### Önceki yapılandırmayı geri yükle

Kurulum komutunun her çalıştırılması eski yapılandırmayı yenisinin yanına yedekler:

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

Araçla **Sıfırla**'yı seç ve otomatik olarak geri yükler.

## Sık sorulan sorular

### Anahtarları nasıl değiştiririm

[Codex kurulum komutunu](/tr/setup/codex) yeni anahtarla yeniden çalıştır veya aracı yeniden çalıştır. Cursor, Cline ve Chatbox için Ayarlar'daki API Key alanını düzenle.

### Kurulum komutunu birkaç kez çalıştırmak güvenli mi

Evet. Yeniden çalıştırma için tasarlanmıştır: eski yapılandırma `.bak.<timestamp>` olarak kaydedilir, CLI yükseltilir ve shell rc'nizdeki eski anahtar satırı değiştirilir.

### Komut anahtarımı bir yere gönderiyor mu

Hayır. Anahtarı kendi makinende komuta yapıştırırsın; yalnızca bir ortam değişkeni ve yerel bir yapılandırma dosyası yazar. Komutun tamamı sayfada gösterilir, çalıştırmadan önce her satırı oku.

### Her şeyi kaldır

[Codex](/tr/setup/codex) sayfasındaki **Kaldır** bölümüne bakın. Diğer uygulamalar için Ayarlar'daki anahtarı sil.

## Hala çalışmıyor

<Steps>
  <Step title="Anahtar canlı mı">
    [Kontrol sayfasına](https://gpt.teamsoclo.site/check) yapıştır. Buradaki hata anahtar demektir (yanlış, süresi dolmuş, kotası tükenmis), uygulama değil.
  </Step>

  <Step title="API'yi doğrudan cURL ile çağır">
    ```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"}]}'
    ```

    Bu çalışıyor ama uygulama çalışmıyorsa sorun uygulama yapılandırmasındadır.
  </Step>

  <Step title="Uygulamada üç şeyi yeniden kontrol et">
    Base URL `/v1` ile bitiyor, anahtar tam, model paketinle eşleşiyor. Bunlar neredeyse her soruna neden oluyor.
  </Step>

  <Step title="Desteğe başvur">
    Hatanın ekran görüntüsünü ve anahtarının son 4 karakterini [t.me/teamsoclo](https://t.me/teamsoclo) adresine gönder. Anahtarın tamamını asla gönderme.
  </Step>
</Steps>


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