Teapot Router / ドキュメント
Claude Code トラブルシュート：接続不能・401・クォータ
エラーの種類で切り分ける：ネットワークとプロキシ、キーとアドレス、残高とクォータ——3 系統 3 通りの確認方法。
ワークスペースを開く接続不能/タイムアウト：まずネットワーク経路
- CLI はシステムプロキシを引き継ぎません。`echo $https_proxy` を実行し、空なら export して再試行。
- VSCode 拡張は独立したネットワークスタックを持ち、システムプロキシや環境変数を引き継がないことがあります——拡張側でプロキシを設定してください。
- カスタムエンドポイントでは ANTHROPIC_BASE_URL の過不足（余分な文字やスラッシュ）を確認。公式 URL とゲートウェイ URL を混在させないでください。
別のネットワーク（スマホのテザリング）でつながるなら、純粋なネットワーク問題でキーは無関係です。
401/403：キーとアドレスを確認
- 401 はまずキー：コピー漏れ（前後の空白）・失効/期限切れ・他社のキーを貼っていないか。
- カスタムエンドポイントではキーとアドレスはペア——A 社のキーで B 社の URL は必ず 401 になります。
- settings.js の env のフィールド名を書き間違えると、黙ってデフォルト端点へフォールバックすることがあります。設定したつもりでも公式 URL に向いている状態です。
失効したキーは復活しません。キー交換後はクライアントを再起動。
429・クォータ・モデル不存在
- 429 はレート制限：ウィンドウのリセットを待つか並行度を下げる。
- 「クォータ不足」は 2 層で確認：アカウント残高と、そのキーの独立上限——キー上限は使用量の天井で、追加チャージではありません。
- 「モデルが存在しない」：クライアントのモデル ID が「モデル」カタログと完全一致（大小文字・バージョン）しているか確認。
各リクエストのモデル/トークン/費用は「利用記録」で確認可能——解決後、黙って再試行された二重請求がないか 1 件突き合わせを。