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

# Pemecahan masalah

> Gejala → penyebab → solusi, plus pertanyaan yang sering diajukan

## Pencarian cepat

| Aplikasi menampilkan | Hampir pasti | Solusi |
| - | - | - |
| `401 Unauthorized`, `Invalid token` | Key salah, karakter hilang, kedaluwarsa, atau dinonaktifkan | Tempel key di [halaman cek](https://gpt.teamsoclo.site/check) |
| `404 Not Found` | Base URL tidak ada `/v1` (atau dobel menjadi `/v1/v1`) | Perbaiki Base URL |
| `No available channel for model ... under group ...` | Key satu paket memanggil model paket lain | Gunakan model paket Anda, lihat [Model](/id/models) |
| `model not found`, error nama model langsung | Typo pada nama model | Salin nama dari [tabel model](/id/models) |
| `429 Too Many Requests` | Melebihi batas permintaan per menit key | Tunggu menit berikutnya, perlambat |
| `insufficient quota` | Key telah menggunakan semua tokennya | Beli kode baru |
| Konfigurasi diedit tapi tidak ada yang berubah | Aplikasi belum ditutup sepenuhnya, atau terminal belum dibuka kembali | Tutup sepenuhnya dan buka kembali |

## Key dan kuota

### Key salah atau terpotong

Masalah paling umum bukan key yang rusak tapi **beberapa karakter hilang** saat memilih teks dengan mouse. Selalu gunakan tombol **Copy** di halaman redeem. Tempel key ke [halaman cek](https://gpt.teamsoclo.site/check): jika dikatakan valid, key baik-baik saja dan masalah ada pada konfigurasi aplikasi.

### Key kedaluwarsa

Setiap paket memiliki masa berlaku dihitung dari saat redeem (tercetak di produk). Setelah kedaluwarsa setiap permintaan mengembalikan 401 meskipun kuota masih ada. Halaman cek menampilkan tanggal kedaluwarsa. Token yang tidak digunakan tidak dipindahkan ke kode baru.

### Kuota habis

Semuanya bekerja, lalu tiba-tiba setiap permintaan gagal dengan *insufficient quota*. Lihat sisa kuota di halaman cek. Kuota yang turun sangat cepat biasanya karena agen membaca seluruh repo, atau percakapan yang sangat panjang dikirim ulang setiap giliran.

### Key hilang

Tukar kode CDK yang sama lagi di [redeem.teamsoclo.site](https://redeem.teamsoclo.site); halaman menampilkan key asli. Kode tidak diterbitkan ulang dengan key baru.

### Berapa mesin per key

Tidak ada batas perangkat, tetapi **batas permintaan per menit** dibagi oleh setiap mesin yang menggunakan key tersebut. Berbagi key berarti pengguna bersaing untuk batas yang sama dan lebih cepat mencapai 429.

## Koneksi

### /v1 tidak ada

Base URL yang benar adalah `https://gpt.teamsoclo.site/v1`. Tanpa `/v1` permintaan mengenai website bukan API dan aplikasi melaporkan 404 atau "could not connect".

<Warning>
  Sebaliknya juga gagal: beberapa aplikasi (Chatbox, beberapa build Cline) menambahkan `/v1` sendiri. Jika Anda memasukkannya dan masih mendapat 404, coba tanpa `/v1`; alamat sebenarnya mungkin sudah menjadi `/v1/v1`.
</Warning>

### Memanggil model paket lain

`No available channel for model gpt-astra under group default` berarti key GPT memanggil model Astra (atau sebaliknya). Setiap key hanya bisa memanggil model paketnya sendiri. Verifikasi dengan:

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

### 429 Too Many Requests

Setiap key memiliki jumlah maksimum permintaan sukses per menit yang ditetapkan oleh paketnya. Di atas itu Anda mendapat 429 dengan pesan "request limit reached". Tunggu menit berikutnya. Untuk skrip batch tambahkan penundaan antara panggilan, atau beli kode lain untuk membagi beban.

### Balasan terpotong di tengah

Untuk pertanyaan yang membutuhkan pemikiran panjang, permintaan non-streaming bisa terputus sebelum token pertama. Aktifkan `stream: true`. Sebagian besar aplikasi chat sudah melakukannya; tambahkan saat memanggil dari kode.

### `Unsupported parameter: reasoning_effort`

Hanya Chat Completions yang menerima `reasoning_effort` di level atas. Dengan Responses API gunakan `"reasoning": {"effort": "high"}`. Codex menangani ini sendiri.

## Codex

### `codex: command not found` setelah instal

npm selesai tapi terminal saat ini belum memuat ulang PATH. **Buka terminal baru**. Jika masih gagal, periksa bahwa folder bin npm ada di PATH:

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

Folder tersebut ditambah `/bin` harus ada di `$PATH`.

### Codex masih meminta login OpenAI

Variabel `TEAMSOCLO_API_KEY` belum mencapai proses Codex:

* Terminal: buka tab baru, periksa `echo $TEAMSOCLO_API_KEY`.
* VS Code di macOS: tutup dengan `Cmd + Q` dan buka kembali. Perintah instal menyetel variabel untuk aplikasi GUI melalui `launchctl`.
* VS Code di Linux: mulai VS Code dari terminal (`code .`), atau keluar dan masuk kembali.
* Windows: buka **baru** PowerShell atau VS Code setelah `setx`.

Periksa bahwa `config.toml` memiliki `requires_openai_auth = false` dan `env_key = "TEAMSOCLO_API_KEY"`.

### Mengedit config.toml tapi Codex tidak berubah

Konfigurasi hanya dibaca saat proses dimulai. **Reload Window tidak cukup**; tutup VS Code sepenuhnya (macOS `Cmd + Q`, Windows tutup semua jendela dan proses latar belakang). Ini adalah pertanyaan Codex yang paling sering ditanyakan.

### `EACCES: permission denied` saat instal npm

Node diinstal dengan hak sistem, umum di Linux. Ubah prefix npm:

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

Tambahkan baris `export` ke `~/.bashrc` atau `~/.zshrc`. Jangka panjang, instal Node melalui nvm, lihat [Mulai](/id/getting-started).

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

PowerShell memblokir file `.ps1`, dan `codex` / `npm` yang diketik di PowerShell melewati shim `.ps1` npm. Jalankan sekali:

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

Kemudian buka PowerShell baru. Atau ketik `codex.cmd`, `npm.cmd` sebagai gantinya.

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

Codex sedang berjalan (CLI, ekstensi atau aplikasi) sehingga npm tidak bisa menimpa `codex.exe`. Tutup semua yang menjalankan Codex dan jalankan ulang perintah instal. Konfigurasi sudah ditulis sebelum langkah ini; hanya pembaruan CLI yang dilewati.

### Windows: error encoding file konfigurasi

Mengedit dengan PowerShell 5.1 dan `Set-Content -Encoding UTF8` menambahkan BOM yang tidak bisa dibaca Codex. Gunakan [perintah instal](/id/setup/codex) lagi (menulis UTF-8 tanpa BOM), atau simpan file di VS Code sebagai **UTF-8** (bukan UTF-8 with BOM).

### Pulihkan konfigurasi sebelumnya

Setiap kali menjalankan perintah instal, konfigurasi lama dicadangkan di sebelah yang baru:

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

Dengan alat, pilih **Reset** dan secara otomatis dipulihkan.

## Pertanyaan yang sering diajukan

### Bagaimana cara mengganti key

Jalankan ulang [perintah instal Codex](/id/setup/codex) dengan key baru, atau jalankan ulang alat. Untuk Cursor, Cline, dan Chatbox, edit field API Key di Settings.

### Apakah aman menjalankan perintah instal beberapa kali

Ya. Dirancang untuk dijalankan ulang: konfigurasi lama disimpan sebagai `.bak.<timestamp>`, CLI diperbarui, dan baris key lama di shell rc Anda diganti.

### Apakah perintah mengirim key saya ke mana pun

Tidak. Anda menempel key ke perintah di mesin Anda sendiri; hanya menulis variabel lingkungan dan file konfigurasi lokal. Seluruh perintah ditampilkan di halaman, baca setiap baris sebelum menjalankan.

### Hapus semua

Lihat **Uninstall** di halaman [Codex](/id/setup/codex). Untuk aplikasi lain cukup hapus key di Settings aplikasi.

## Masih tidak berfungsi

<Steps>
  <Step title="Apakah key masih aktif">
    Tempel ke [halaman cek](https://gpt.teamsoclo.site/check). Error di sini berarti key (salah, kedaluwarsa, kuota habis), bukan aplikasi.
  </Step>

  <Step title="Panggil API langsung dengan 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"}]}'
    ```

    Jika ini berhasil dan aplikasi tidak, masalahnya ada pada konfigurasi aplikasi.
  </Step>

  <Step title="Periksa ulang tiga hal di aplikasi">
    Base URL diakhiri dengan `/v1`, key lengkap, model sesuai paket Anda. Ini menyebabkan hampir setiap masalah.
  </Step>

  <Step title="Hubungi dukungan">
    Kirim tangkapan layar error dan 4 karakter terakhir key Anda ke [t.me/teamsoclo](https://t.me/teamsoclo). Jangan pernah kirim key lengkap.
  </Step>
</Steps>


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