早見表
キーと残高
キーの誤り・欠け
最も多いのはキーの故障ではなく、マウス選択時に数文字欠けることです。交換ページの Copy ボタンを必ず使ってください。確認ページにキーを貼り、有効と出ればキーは正常で、問題はアプリ設定にあります。キーの期限切れ
各プランには交換時点から数える有効期間があります（商品に記載）。期限後は残高があっても全リクエストが 401 になります。確認ページに有効期限が表示されます。未使用トークンは新しいコードに移りません。残高切れ
正常だったのに突然全リクエストが insufficient quota で失敗する状態です。確認ページで残りを見てください。残高が異常に速く減るのは、エージェントがリポジトリ全体を読んでいるか、非常に長い会話が毎ターン再送されているのが原因です。キーの紛失
redeem.teamsoclo.site で同じ CDK コードをもう一度交換すると元のキーが表示されます。交換済みコードに新しいキーは発行されません。1 つのキーで何台まで
台数制限はありませんが、1 分あたりのリクエスト上限はそのキーを使う全マシンで共有されます。キーを共有すると同じ上限を取り合い、429 に当たりやすくなります。接続
/v1 が無い
正しい Base URL はhttps://gpt.teamsoclo.site/v1 です。/v1 が無いとリクエストが API ではなく Web サイトに届き、404 や「接続できません」になります。
別プランのモデルを呼んでいる
No available channel for model gpt-astra under group default は、GPT キーで Astra モデルを呼んでいる（またはその逆）ことを意味します。各キーは自プランのモデルだけ呼べます。確認:
429 Too Many Requests
各キーにはプランで決まる 1 分あたりの成功リクエスト上限があります。超えると「request limit reached」付きの 429 が返ります。次の分まで待ってください。バッチ処理では呼び出し間に待ちを入れるか、コードを追加購入して負荷を分散します。回答が途中で切れる
長く考える必要がある質問では、非ストリーミングのリクエストが最初のトークンより前に切断されることがあります。stream: true を有効にしてください。ほとんどのチャットアプリは既に有効で、コードから呼ぶ場合は追加します。
Unsupported parameter: reasoning_effort
トップレベルの reasoning_effort を受け付けるのは Chat Completions だけです。Responses API では "reasoning": {"effort": "high"} を使います。Codex はこれを自動で扱います。
Codex
インストール後に codex: command not found
npm は完了しましたが現在のターミナルが PATH を再読込していません。新しいターミナルを開いてください。それでも駄目なら npm の bin フォルダーが PATH にあるか確認します:
/bin が $PATH に含まれている必要があります。
Codex がまだ OpenAI ログインを求める
環境変数TEAMSOCLO_API_KEY が Codex のプロセスに届いていません:
- ターミナル: 新しいタブを開き
echo $TEAMSOCLO_API_KEYを確認。 - macOS の VS Code:
Cmd + Qで終了して再起動。インストールコマンドはlaunchctlで GUI アプリ向けに変数を設定済みです。 - Linux の VS Code: ターミナルから VS Code を起動（
code .）するか、ログアウトして再ログイン。 - Windows:
setxの後に新しい PowerShell や VS Code を開く。
config.toml に requires_openai_auth = false と env_key = "TEAMSOCLO_API_KEY" があるか確認してください。
config.toml を編集しても Codex が変わらない
設定はプロセス起動時にしか読まれません。Reload Window では不十分で、VS Code を完全に終了してください（macOSCmd + Q、Windows は全ウィンドウとバックグラウンドプロセスを閉じる）。Codex で最も多い質問です。
npm install で EACCES: permission denied
Node がシステム権限でインストールされている場合に起きます（Linux で多い）。npm の prefix を変更します:
export 行を ~/.bashrc か ~/.zshrc に追加します。長期的には nvm で Node を入れるのが安全です。始め方参照。
Windows: running scripts is disabled on this system
PowerShell が .ps1 を禁止しており、PowerShell で打った codex / npm は npm の .ps1 シムを経由します。一度だけ実行:
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 が読めなくなります。インストールコマンドを再実行する（BOM 無し UTF‑8 で書く）か、VS Code で UTF-8（UTF-8 with BOM ではなく）として保存してください。
以前の設定を復元する
インストールコマンドを実行するたびに古い設定が隣にバックアップされます:よくある質問
キーを変えるには
新しいキーで Codex インストールコマンドを再実行するか、ツールを再実行します。Cursor、Cline、Chatbox は Settings の API Key 欄を書き換えます。インストールコマンドを何度も実行しても大丈夫か
大丈夫です。再実行を前提に設計されており、古い設定は.bak.<タイムスタンプ> として保存、CLI は更新、シェル rc 内の古いキー行は置き換えられます。
コマンドはキーをどこかへ送るのか
送りません。キーは自分のマシン上でコマンドに貼り、コマンドは環境変数とローカル設定ファイルにだけ書きます。コマンド全文がページに表示されているので、実行前に全行を確認できます。すべて削除する
Codex ページのアンインストールを参照。その他のアプリは Settings でキーを消すだけです。それでも動かない
1
キーは生きているか
確認ページに貼ります。ここでエラーならキー（誤り、期限切れ、残高切れ）の問題で、アプリではありません。
2
cURL で直接呼ぶ
3
アプリの 3 点を再確認
Base URL が
/v1 で終わる、キーが完全、モデルがプランに合っている。ほぼすべての問題はこの 3 つです。4
サポートに連絡
エラーのスクリーンショットとキーの末尾 4 文字を t.me/teamsoclo へ。キー全体は絶対に送らないでください。