Claude Code API接続エラー：タイムアウトと修正方法

エラーテキスト

API Error (Connection error.) · Unable to connect to API (ECONNREFUSED) · Request timed out

段階的な修正方法

1. 1. アドレスを確認

   「/status」を実行してください。エンドポイントは https 経由の api.aicodewith.ai である必要があります。/v1 は付けず、タイプミスも避けてください。

   ~/.claude/settings.json

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
       "ANTHROPIC_API_KEY": "",
       "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
     }
   }

2. 2. ネットワークをテスト

   同じターミナルで curl -I https://api.aicodewith.ai を実行してください。応答がない、または失敗する場合、問題はネットワークにあり、Claude Code にはありません。

3. 3. プロキシとファイアウォール

   プロキシを使用する場合は、そのターミナルで HTTPS_PROXY をエクスポートしてください（または env ブロックに追加してください）。企業のファイアウォールでは api.aicodewith.ai の許可が必要な場合があります。

4. 4. タイムアウトを引き上げる

   遅いリクエストや長いリクエストの場合は、env ブロックに "API_TIMEOUT_MS": "600000" を追加して再起動してください。

よくある原因

失敗したリクエストは課金されますか？

失敗したリクエスト（4xx/5xx、タイムアウト、接続切断）は課金されません。正常に完了したリクエストに対してのみ課金されます。上流の障害が自動的に再試行されて成功した場合は、1回だけ課金されます。

それでも失敗する場合？

• •aicodewith でモデルのページを確認してください。各チャネルの最近の稼働状況が表示されます。
• •ダッシュボードの利用記録でリクエストを検索して、モデル、ステータス、コストを確認してください。
• •エラーが発生した時刻、モデル、エラーテキストを添えて support@aicodewith.com までメールしてください（完全なAPIキーは決して送らないでください）。

モデルのステータスと価格サポートに問い合わせドキュメント

FAQ