運用とトラブル対応初心者向け更新日
接続が遅い、またはリクエストに失敗した場合は？
ステータスコードとエラー原文を見てからアドレスを変えます。予備ドメインは、Key、モデル、エンドポイントの問題を直しません。
現象ごとに確認する
| 現象 | 先に確認すること |
|---|---|
| 401 | Key が欠けておらず、ローテーションまたは無効化されていないこと。環境変数が新しいターミナルに入っていること |
| 403 / モデル不可 | エンドポイント選択でそのモデル系列を保存済みか。モデル ID が機能カタログにあるか |
| 429 | リクエストが密すぎます。待ってから再試行し、バックオフを入れ、連続再送しないでください |
| タイムアウト、接続リセット、回り続ける | アドレスが https://api.icodeeasy.cc か。まだ遅いときだけ下の予備ドメインに変える |
| Gemini のパスが 404 | GOOGLE_GEMINI_BASE_URL はドメインのみ。/v1beta は付けない |
予備ドメイン。パスと Key はそのままです。
https://jp.icodeeasy.cc
https://sg.icodeeasy.cc
変える項目：Claude Code、GLM、MiniMax は ANTHROPIC_BASE_URL。Codex は base_url。Kimi Code CLI は base_url で /v1 を残す。Gemini CLI は GOOGLE_GEMINI_BASE_URL。
変更の確認
同じクライアントから短い会話を 1 通送ります。成功したらリクエストログを開き、モデル、状態、料金が今回のリクエストであることを確認します。まだ失敗するときは、ステータスコードとエラー原文をチケットに送ってください。API Key 全文は付けないでください。
各クライアントの設定は Claude Code、Codex、Gemini CLI、FAQにあります。
関連ガイド
よくある質問
API キー、401・429 応答、Windows 環境変数、クライアント接続、利用枠、問い合わせ方法などの一般的な問題を解決します。
Claude Code のインストール・API 設定・Windows トラブル対処
Claude Code のインストールから API Key・接続先の設定、Windows・macOS・Linux の確認方法、認証エラーや接続障害への対処、Desktop・Kimi・GLM の設定まで解説します。
Codex 設定
Codex CLI をインストールし、auth.json に API キーを保存して provider と Base URL を設定し、最初のセッションを開始します。