CC逆引きリファレンス

ネットワークエラーを解決したい

15. トラブルシューティング

コマンド / 機能

接続確認とプロキシ設定

ネットワーク接続の問題を診断

概要

インターネット接続やプロキシ設定に起因する接続エラーを解決します。企業ネットワークやファイアウォール環境での設定方法も解説します。

設定例

# 接続テスト
curl -I https://api.anthropic.com
# → HTTP/2 200 なら接続OK

# プロキシ環境での設定
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
claude

# settings.json でプロキシを設定
{
  "proxy": "http://proxy.example.com:8080"
}

# 証明書エラーの場合
# 企業の自己署名証明書を追加
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.crt

# よくあるネットワークエラー
# "ECONNREFUSED" → API サーバーに接続できない
#   → プロキシ設定、ファイアウォールを確認

# "ETIMEDOUT" → 接続がタイムアウト
#   → ネットワーク速度、タイムアウト設定を確認

# "CERT_HAS_EXPIRED" → 証明書エラー
#   → システム時刻、CA証明書を確認

# DNS 問題の確認
nslookup api.anthropic.com
# → 正常に解決されるか確認

こんな時に使う

  • API に接続できない時
  • 企業のプロキシ環境で使う時
  • 証明書エラーが発生する時

使い方

  1. 1curl でAPI接続をテスト
  2. 2プロキシ環境では環境変数を設定
  3. 3証明書エラーは CA 証明書を追加

Tips

  • 企業ネットワークではプロキシ設定が必要なことが多い
  • VPN 使用時は接続先を確認
  • ファイアウォールで api.anthropic.com を許可