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

# פתרון בעיות

> תסמין ← גורם ← פתרון, בנוסף לשאלות נפוצות

## חיפוש מהיר

| האפליקציה אומרת | כמעט בוודאות | פתרון |
| - | - | - |
| `401 Unauthorized`, `Invalid token` | מפתח שגוי, תווים חסרים, פג תוקף, או מושבת | הדביקו את המפתח ב[דף הבדיקה](https://gpt.teamsoclo.site/check) |
| `404 Not Found` | Base URL חסר `/v1` (או כפול ל-`/v1/v1`) | תקנו את ה-Base URL |
| `No available channel for model ... under group ...` | מפתח של חבילה אחת קורא למודל של החבילה השנייה | השתמשו במודל של החבילה שלכם, ראו [מודלים](/he/models) |
| `model not found`, שגיאת שם מודל מיידית | שגיאת כתיב בשם המודל | העתיקו את השם מ[טבלת המודלים](/he/models) |
| `429 Too Many Requests` | חריגה ממגבלת הבקשות לדקה | המתינו לדקה הבאה, האטו |
| `insufficient quota` | המפתח השתמש בכל הטוקנים שלו | רכשו קוד חדש |
| ההגדרות נערכו אך שום דבר לא השתנה | האפליקציה לא נסגרה לחלוטין, או הטרמינל לא נפתח מחדש | סגרו לחלוטין ופתחו מחדש |

## מפתחות ומכסה

### מפתח שגוי או קטום

הבעיה הנפוצה ביותר אינה מפתח פגוע אלא **כמה תווים שאבדו** בעת סימון טקסט עם העכבר. השתמשו תמיד בכפתור **Copy** בדף המימוש. הדביקו את המפתח ב[דף הבדיקה](https://gpt.teamsoclo.site/check): אם הוא אומר תקף, המפתח תקין והבעיה בהגדרות האפליקציה.

### פקיעת תוקף המפתח

לכל חבילה יש תקופת תוקף הנספרת ממימוש (מודפסת על המוצר). לאחר הפקיעה כל בקשה מחזירה 401 גם אם נותרה מכסה. דף הבדיקה מציג את תאריך הפקיעה. טוקנים שלא נוצלו אינם עוברים לקוד חדש.

### מכסה אזלה

הכל עבד, ופתאום כל בקשה נכשלת עם *insufficient quota*. בדקו מה נשאר בדף הבדיקה. ירידה מהירה באופן חריג במכסה בדרך כלל נובעת מסוכן שקורא את המאגר כולו, או מהשיחה ארוכה מאוד שנשלחת מחדש בכל תור.

### מפתח אבוד

ממשו את אותו קוד CDK שוב ב-[redeem.teamsoclo.site](https://redeem.teamsoclo.site); הדף מציג את המפתח המקורי. קודים אינם מונפקים מחדש עם מפתח חדש.

### כמה מכשירים לכל מפתח

אין מגבלת מכשירים, אך **מגבלת הבקשות לדקה** משותפת לכל המכשירים המשתמשים במפתח. שיתוף מפתח פירושו תחרות על אותה מגבלה והגעה מהירה יותר ל-429.

## חיבור

### חסר /v1

ה-Base URL הנכון הוא `https://gpt.teamsoclo.site/v1`. ללא `/v1` הבקשות מגיעות לאתר במקום ל-API והאפליקציה מדווחת על 404 או "could not connect".

<Warning>
  ההפך גם נכשל: אפליקציות מסוימות (Chatbox, גרסאות מסוימות של Cline) מוסיפות `/v1` בעצמן. אם הכנסתם אותו וקיבלתם 404, נסו ללא `/v1`; הכתובת האמיתית עלולה להפוך ל-`/v1/v1`.
</Warning>

### קריאה למודל של חבילה אחרת

`No available channel for model gpt-astra under group default` פירושו שמפתח GPT קורא למודל Astra (או להיפך). כל מפתח יכול לקרוא רק למודל של חבילתו. ודאו עם:

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

### 429 Too Many Requests

לכל מפתח יש מספר מקסימלי של בקשות מוצלחות לדקה שנקבע על ידי חבילתו. מעל זה מקבלים 429 עם הודעת "request limit reached". המתינו לדקה הבאה. בסקריפטים אצווה הוסיפו השהייה בין קריאות, או רכשו קוד נוסף לפיזור העומס.

### תשובה שנקטעת באמצע

לשאלות שדורשות חשיבה ממושכת, בקשה לא-streaming עלולה להיפגע לפני הטוקן הראשון. הפעילו `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:

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

אותה תיקייה בתוספת `/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 (macOS `Cmd + Q`, Windows סגרו כל חלון ותהליך ברקע). זו השאלה הנפוצה ביותר על Codex.

### `EACCES: permission denied` בהתקנת npm

Node הותקן עם הרשאות מערכת, נפוץ ב-Linux. שנו את ה-prefix של npm:

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

הוסיפו שורת `export` ל-`~/.bashrc` או `~/.zshrc`. לטווח ארוך, התקינו Node דרך nvm, ראו [תחילת העבודה](/he/getting-started).

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

PowerShell חוסם קבצי `.ps1`, ו-`codex` / `npm` שנכתבים ב-PowerShell עוברים דרך shims של `.ps1` של npm. הפעילו פעם אחת:

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

ואז פתחו PowerShell חדש. לחלופין, כתבו `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 לא יכול לקרוא. הריצו שוב את [פקודת ההתקנה](/he/setup/codex) (כותבת UTF-8 ללא BOM), או שמרו את הקובץ ב-VS Code כ-**UTF-8** (לא UTF-8 with BOM).

### שחזור ההגדרות הקודמות

כל הפעלה של פקודת ההתקנה מגבה את ההגדרות הישנות ליד החדשות:

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

עם הכלי, בחרו **Reset** והוא ישחזר אוטומטית.

## שאלות נפוצות

### כיצד אני מחליף מפתחות

הריצו שוב את [פקודת התקנת Codex](/he/setup/codex) עם המפתח החדש, או הריצו שוב את הכלי. עבור Cursor, Cline ו-Chatbox, ערכו את שדה ה-API Key בהגדרות.

### האם בטוח להריץ את פקודת ההתקנה מספר פעמים

כן. היא מתוכננת להרצות חוזרות: ההגדרות הישנות נשמרות כ-`.bak.<timestamp>`, ה-CLI משודרג, ושורת המפתח הישנה בקובץ ה-shell rc מוחלפת.

### האם הפקודה שולחת את המפתח שלי לאן שהוא

לא. אתם מדביקים את המפתח לפקודה על המחשב שלכם; היא רק כותבת משתנה סביבה וקובץ הגדרות מקומי. הפקודה כולה מוצגת בדף, קראו כל שורה לפני הרצה.

### הסרת הכל

ראו **Uninstall** בדף [Codex](/he/setup/codex). לאפליקציות אחרות פשוט מחקו את המפתח בהגדרות האפליקציה.

## עדיין לא עובד

<Steps>
  <Step title="האם המפתח פעיל">
    הדביקו אותו ב[דף הבדיקה](https://gpt.teamsoclo.site/check). שגיאה כאן פירושה המפתח (שגוי, פג תוקף, אזלה המכסה), לא האפליקציה.
  </Step>

  <Step title="קראו ל-API ישירות עם 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"}]}'
    ```

    אם זה עובד והאפליקציה לא, הבעיה בהגדרות האפליקציה.
  </Step>

  <Step title="בדקו שלושה דברים באפליקציה">
    Base URL מסתיים ב-`/v1`, המפתח מלא, המודל תואם לחבילה שלכם. אלה גורמים לכמעט כל בעיה.
  </Step>

  <Step title="פנו לתמיכה">
    שלחו צילום מסך של השגיאה ו-4 התווים האחרונים של המפתח שלכם אל [t.me/teamsoclo](https://t.me/teamsoclo). אל תשלחו אף פעם את המפתח המלא.
  </Step>
</Steps>


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