AIツールのネットワーク環境
と接続先

Web版：ログイン用リソースと生成リクエストを分けて確認

ページが表示されても、成功したのは一部のリクエストだけかもしれません。メッセージを送信しても応答がない場合は、ブラウザーの開発者ツールでネットワークパネルを確認し、DNSの名前解決、接続の確立、プラットフォームから返されたエラーを切り分けましょう。ブラウザー拡張機能がリクエストを書き換えたり、リソースをブロックしたりすることもあります。切り分けには別のブラウザープロファイルを使って比較できますが、元のアカウントや地域の条件は維持してください。

API：通信エラーと認証・利用上限を切り分ける

APIには独自の認証、プロジェクト、課金ルールがあります。Web版の有料プランがAPIの利用権限も含むとは限りません。サードパーティーアプリに表示されるモデル名も、想定したサービスにリクエストが送られている証拠にはなりません。呼び出す前に公式エンドポイント、キーが属するプロジェクト、モデルの利用権限、アカウントの利用上限を確認してください。キーは環境変数やシークレット管理システムで扱い、公開リポジトリやフロントエンドに記載しないでください。

ストリーミングAPIでは、呼び出し元とリバースプロキシのタイムアウト、バッファリング、キャンセル処理も確認が必要です。サーバー側で生成が始まってもクライアントに表示されない場合、中継層でデータが蓄積されている可能性があります。通信できているのに認証、利用上限、レート制限のエラーが返る場合は、アカウントと呼び出し方を確認してください。料金や副作用が発生する可能性のあるリクエストは、結果を確認せずに繰り返し送信しないでください。

コマンドライン：環境変数だけでは設定できない場合も

HTTPS_PROXY、HTTP_PROXY、ALL_PROXYを参照するコマンドラインツールもあれば、個別にプロキシを設定する必要があるツールもあります。同じ環境変数名でも、すべてのランタイムが同じプロキシプロトコルに対応しているとは限りません。利用するSDKやネットワークライブラリのドキュメントを確認し、クライアントが実際に提供するローカル接続先を使いましょう。NO_PROXYの設定によって、対象ドメインが意図せず直接接続されていないかも確認してください。

設定を変更したら、同じターミナル、同じランタイムから実際にリクエストを送って確認してください。別のターミナルでのテスト結果をアプリの動作と見なしたり、接続エラーを解決するために証明書の検証を無効にしたりしないでください。企業ネットワークの証明書に問題がある場合は、管理者に信頼チェーンとアクセス方針を確認してください。

IDE拡張機能：ブラウザー認証とエディターからの通信は別経路

CursorやGitHub Copilotなどの開発ツールでは、ブラウザーで認証した後に、エディターのプロセスが生成リクエストを送る場合があります。ブラウザーの認証は成功するのに拡張機能が読み込み中のままなら、エディターのプロキシ設定、拡張機能のログ、組織のポリシーを確認してください。システムプロキシを変更した後、設定を読み込むためにプロセスの再起動が必要な場合があります。

リモート開発、コンテナ、リモート拡張機能ホストを使う場合は、リクエストがローカル端末とリモートホストのどちらから送られているかも確認してください。ローカルクライアントのネットワーク設定は、通常リモートホストには自動で引き継がれません。リモート環境の接続元を、ローカルで選んだ回線と取り違えないようにしましょう。

CI：実行環境のネットワークを確認

CIタスクは実行環境のネットワーク上で動作し、開発用PCが接続されていても同じ接続元が自動的に使われるわけではありません。実行環境の地域、外向き通信のポリシー、プロキシ環境変数の受け渡し、シークレット変数の権限を確認してください。ログには、認証ヘッダーやリクエスト全体を出力せず、機密情報を取り除いたエラーの種類だけを残しましょう。

共有ランナーの接続元やタスクの同時実行数も、API呼び出しに影響する場合があります。プラットフォームによるレート制限が発生したら、公式の応答に従って再試行、待機時間、同時実行数を調整してください。ネットワーク回線で利用枠を管理することはできません。チーム環境では、コード、ドキュメント、業務データの取り扱いに関する組織のルールも守ってください。