導入
ClaudeCodeを起動しても「接続できません」「タイムアウトしました」というエラーが出て使えない、そんな経験はありませんか。エンジニアではない方にとって、ネットワーク関連のトラブルは原因が見えづらく、どこを直せばいいのか分からないことが多いはずです。特に会社のネットワークやVPN環境で使う場合、特有の問題が起こりやすくなります。本記事では、ClaudeCodeのネットワークエラーを「接続タイムアウト」「SSL証明書エラー」「プロキシ・企業ネットワーク」「VPN影響」の4つの観点に分けて、原因と解決策をやさしく解説します。コマンド例や設定ファイルのサンプルも豊富に紹介するので、専門知識がなくても順を追って解決にたどり着けます。読了後には、ネットワーク関連のトラブルを自力で診断・解決できるようになります。
結論
ClaudeCodeでネットワークエラーが出た時の解決手順は、シンプルに「上から順に試す」のが最短です。まず(1)インターネット接続そのものが生きているかブラウザで確認し、(2)claude --versionコマンドでClaudeCode自体が動作するか確かめ、(3)ping api.anthropic.comで接続先サーバーへ到達できるか調べ、(4)VPNやプロキシを一時的にオフにして試してみる、という流れです。多くの場合、(4)で原因が判明します。会社のネットワークでは、プロキシ設定が必須なケースが多く、HTTPS_PROXY環境変数を設定するだけで解決します。SSL証明書エラーは社内の証明書を信頼ストアに追加すれば直ります。本記事を読めば、これらの設定方法と、どんな時にどのコマンドを使うべきかが分かるようになります。「ネットワーク=難しい」と諦めず、順を追って試すことが解決の鍵です。
まずは基本の接続確認から始める
ネットワークエラーに遭遇したら、いきなり設定をいじる前に、基本の確認をしましょう。ここを飛ばすと、関係ない設定を変えて状況をさらに悪化させることがあります。
1つ目の確認は「インターネットは繋がっているか」です。ブラウザでhttps://www.anthropic.comを開いてみてください。表示されれば、インターネット自体は生きています。表示されなければWi-Fiやイーサネット接続、ルーターの再起動から始めましょう。
2つ目は「ClaudeCodeが起動しているか」です。
claude --version
このコマンドでバージョンが表示されれば、ClaudeCode本体は正常です。エラーが出る場合は、インストールやPATH設定の問題が考えられます。
3つ目は「Anthropicのサーバーに到達できるか」です。
ping api.anthropic.com
応答があれば、Anthropic側のサーバーへ到達できています。応答がない場合は、ファイアウォールや会社のネットワーク制限が疑われます。
4つ目は「DNS解決ができているか」です。
nslookup api.anthropic.com
IPアドレスが返ってくればDNSは正常です。返ってこなければ、DNSサーバーの設定を見直す必要があります。
基本確認の流れまとめ：
1. ブラウザでAnthropicサイトが見れるか
2. claude --version が通るか
3. ping でサーバーに届くか
4. nslookup で名前解決できるか
この4ステップを順に試すだけで、原因の8割は絞り込めます。
タイムアウトエラーの原因と対処
「Request timeout」「Connection timed out」というエラーは、サーバーに接続を試みたものの一定時間内に応答がなかった場合に発生します。原因はいくつか考えられ、それぞれ対処法が異なります。
最も多いのが「ネットワークが遅い・不安定」というケースです。Wi-Fiの電波が弱い、回線が混雑している、モバイル回線が不安定などが該当します。この場合は有線接続に切り替えたり、ルーターの近くで作業したりすると改善します。
次に多いのが「タイムアウト時間が短すぎる」場合です。ClaudeCodeには接続のタイムアウト時間を設定できる項目があります。デフォルトでは短めに設定されているため、回線が遅い環境では延長すると安定します。
# タイムアウトを60秒に延長する例
export CLAUDE_TIMEOUT=60000
.zshrcや.bashrcに追記しておけば、毎回設定する必要がなくなります。
# ~/.zshrc に追記する例
export CLAUDE_TIMEOUT=60000
export CLAUDE_REQUEST_TIMEOUT=120000
3つ目は「サーバー側の障害」です。Anthropic自体が一時的にダウンしていることもあります。確認するにはAnthropicのステータスページを見てください。Operationalと表示されていれば正常、Incidentと表示されていれば障害中です。
タイムアウトの種類：
- Connect Timeout：接続開始すらできない
- Read Timeout：接続後、応答が返ってこない
- Idle Timeout：通信が一定時間途切れた
エラーメッセージの種類で、どこに問題があるかある程度判断できます。
SSL証明書エラーへの対処
「SSL certificate problem」「unable to verify the first certificate」「SELF_SIGNED_CERT_IN_CHAIN」といったエラーは、SSL/TLS証明書の検証に失敗した時に出ます。特に企業ネットワーク環境で頻繁に見られるエラーです。
このエラーの主な原因は、会社のセキュリティ機器（プロキシやファイアウォール）が通信を一度復号化して再暗号化しているケースです。この処理を「SSLインスペクション」と呼びます。社内のセキュリティ機器が独自の証明書で署名し直すため、ClaudeCodeから見ると「知らない証明書」になり、エラーが出るわけです。
解決策は「社内の証明書を信頼するように設定する」ことです。情報システム部門に問い合わせて、社内CA証明書（ルート証明書）を入手してください。それをClaudeCodeに信頼させる方法はOSによって異なります。
# macOS の場合：キーチェーンに追加
sudo security add-trusted-cert -d -r trustRoot \
-k /Library/Keychains/System.keychain company-ca.crt
# Linuxの場合：CA証明書を追加
sudo cp company-ca.crt /usr/local/share/ca-certificates/
sudo update-ca-certificates
# Windowsの場合（PowerShell管理者権限）
Import-Certificate -FilePath "C:\company-ca.crt" `
-CertStoreLocation Cert:\LocalMachine\Root
Node.js経由でClaudeCodeを使っている場合は、追加で環境変数の設定も必要です。
export NODE_EXTRA_CA_CERTS=/path/to/company-ca.crt
絶対にやってはいけない対処：
× SSL検証を完全に無効化する（NODE_TLS_REJECT_UNAUTHORIZED=0）
→ セキュリティリスクが極めて高いため、応急処置でも避ける
○ 正規の手順で証明書を信頼する
「面倒だから検証オフ」は厳禁です。中間者攻撃のリスクが高まり、社内ネットワークの安全性を損ないます。
プロキシ設定の方法
会社のネットワークでは、外部への通信が「プロキシサーバー」を経由するよう義務付けられている場合があります。プロキシを設定しないと、ClaudeCodeはAnthropicのサーバーに接続できません。
プロキシのアドレスは情報システム部門から教えてもらいます。よくある形式はhttp://proxy.company.local:8080のようなURLです。
設定方法は環境変数を使います。
# 一時的に設定（そのセッションのみ）
export HTTP_PROXY=http://proxy.company.local:8080
export HTTPS_PROXY=http://proxy.company.local:8080
export NO_PROXY=localhost,127.0.0.1,.company.local
# 恒久的に設定する場合（~/.zshrc 等に追記）
export HTTP_PROXY=http://proxy.company.local:8080
export HTTPS_PROXY=http://proxy.company.local:8080
export NO_PROXY=localhost,127.0.0.1,.company.local
NO_PROXYには、プロキシを経由しないアドレスを列挙します。社内サーバーやローカルホストはここに含めるのが一般的です。
プロキシに認証が必要な場合は、URLにユーザー名とパスワードを含めます。
export HTTPS_PROXY=http://username:password@proxy.company.local:8080
ただし、パスワードを直接記述するのはセキュリティ上望ましくありません。可能であればNTLM認証や統合Windows認証を使う、専用ツール（cntlmなど）を間に挟む方法を検討しましょう。
プロキシ設定の確認コマンド：
echo $HTTPS_PROXY # 設定値を表示
curl -v https://api.anthropic.com # 接続テスト
curl -vで接続テストを行うと、どこで止まっているか詳細な情報が得られます。
企業ネットワーク特有の問題
会社で使う場合、家庭環境にはない様々な制約が存在します。代表的なものを押さえておきましょう。
1つ目は「ホワイトリスト方式のファイアウォール」です。許可されたドメインだけアクセスできる方式で、ClaudeCodeが通信するドメインが許可されていないと一切繋がりません。情報システム部門に以下のドメインを開放してもらう必要があります。
ClaudeCode が通信する主なドメイン：
- api.anthropic.com
- *.anthropic.com
- claude.ai
- statsig.anthropic.com（テレメトリ用）
2つ目は「ポート制限」です。多くの企業ネットワークでは443番ポート（HTTPS）以外を遮断しています。ClaudeCodeは基本的に443番を使うので問題ありませんが、特殊なポートが必要なプラグインがあれば事前に確認しましょう。
3つ目は「DLP（情報漏洩防止）システム」です。送信内容を監視して、機密キーワードを含む通信をブロックする仕組みです。コードの一部が誤ってブロックされることがあります。エラー時はネットワーク管理者にログを見てもらいましょう。
4つ目は「セッション切断ポリシー」です。一定時間アイドル状態が続くと自動で接続が切られる設定で、ClaudeCodeの長時間作業に影響します。
企業ネットワークでチェックするポイント：
□ 必要なドメインが許可されているか
□ プロキシ設定が正しいか
□ 社内CA証明書がインストールされているか
□ ポート443が開いているか
□ DLPによる誤検知がないか
これらを情報システム部門と協力して確認すれば、ほとんどのエラーは解決します。
VPN利用時に起こりやすいトラブル
リモートワークでVPNを使っている方は、VPN固有の問題に注意が必要です。VPNはセキュリティを高める一方、通信経路が複雑になるためトラブルの温床にもなります。
最も多いのが「VPN経由で速度が極端に遅い」問題です。海外経由のVPNだと往復距離が長くなり、ClaudeCodeの応答が著しく遅くなります。解決策は近いリージョンのVPNサーバーを選ぶか、業務に支障がない範囲でVPNをオフにすることです。
次に多いのが「Split Tunnelの設定不備」です。Split Tunnelとは「特定の通信だけVPNを通し、他は直接インターネットに出す」設定のこと。ClaudeCodeをVPN経由にすべきか直接接続にすべきか、会社のポリシーを確認してください。
VPN関連トラブルの切り分け：
1. VPN接続中：エラーが出るか確認
2. VPN切断後：エラーが消えるか確認
3. 消えれば → VPN設定の問題
4. 残るなら → VPN以外の原因
VPNソフトによっては、DNS設定を強制的に変更するものがあります。これが原因でAnthropicのドメインが解決できなくなるケースもあります。VPNソフトの設定で「DNSを強制しない」「Split DNSを使う」オプションがあれば試してみてください。
# DNSが正しいか確認
nslookup api.anthropic.com
# 8.8.8.8（Google DNS）で再確認
nslookup api.anthropic.com 8.8.8.8
結果が違えば、VPN側のDNS設定に問題があります。
ファイアウォールとアンチウイルスの影響
OS標準のファイアウォールや、サードパーティ製のアンチウイルスソフトもネットワークエラーの原因になります。これらは「セキュリティを守る」という重要な役割を担っていますが、時に正常な通信までブロックしてしまうことがあります。
WindowsならWindows Defender、macOSならアプリケーションファイアウォール、Linuxならiptablesやufwといった標準機能があります。これらでClaudeCodeの通信が遮断されていないか確認しましょう。
# macOSの場合、アプリのファイアウォール許可を確認
sudo /usr/libexec/ApplicationFirewall/socketfilterfw \
--listapps
# Windowsの場合、Defenderのログ確認
Get-WinEvent -LogName Microsoft-Windows-Windows\ Firewall*/Firewall
アンチウイルスソフト（McAfee、Norton、Trend Microなど）には「Web保護」「HTTPS検査」といった機能があり、これがClaudeCodeの通信を妨げることがあります。一時的にこの機能を無効化して、症状が改善するか試してみてください。改善すれば、ClaudeCodeを例外として登録すれば恒久的に解決します。
試す順序：
1. アンチウイルスのWeb保護を一時停止
2. ClaudeCodeで通信を試す
3. 通信が成功すれば原因確定
4. 例外設定を追加
5. Web保護を再度有効化
ただし、無効化したまま放置するのは禁物です。テストが終わったら必ず再有効化してください。
ネットワーク設定をリセットする方法
色々試してもうまくいかない時の最終手段が「ネットワーク設定のリセット」です。すべての設定をデフォルトに戻すので、効果は大きいですが、Wi-Fiパスワードなども消えるため、再設定の手間がかかります。
# macOSの場合
sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder
# Windowsの場合（管理者権限PowerShell）
ipconfig /flushdns
netsh winsock reset
netsh int ip reset
# Linuxの場合
sudo systemctl restart systemd-resolved
これらでDNSキャッシュやネットワークスタックがリセットされます。一時的な不調なら、これだけで解決することも珍しくありません。
加えて、ClaudeCode自体の設定もリセットしてみると良いでしょう。
# ClaudeCodeの設定ディレクトリを退避（バックアップ）
mv ~/.claude ~/.claude.backup
# 再起動して新しい設定で動かす
claude
問題が解決すれば、設定ファイルの破損が原因だったと分かります。バックアップから必要な部分だけ戻せばOKです。
FAQ
Q1. 自宅では使えるのに会社では使えません。何が原因ですか？
会社のネットワーク特有の制限（プロキシ、ファイアウォール、SSL検査、ドメインホワイトリスト）が原因の可能性が高いです。情報システム部門に「ClaudeCodeを使いたいので、api.anthropic.comへのHTTPS接続を許可してほしい」と相談してください。プロキシ設定とCA証明書の情報も合わせて受け取りましょう。
Q2. VPN接続中だけClaudeCodeが遅くなります。どうすれば？
VPNサーバーが遠い場所にある可能性が高いです。会社のポリシーで許可されているなら、業務通信以外はSplit Tunnelで直接接続するよう設定するか、より近いVPNサーバーに切り替えてみてください。
Q3. SSL検証を無効化すれば動きますが、これでも大丈夫ですか？
応急処置としては動きますが、長期的には絶対に避けてください。中間者攻撃を受けても気づけなくなります。正規の手順で社内CA証明書を信頼ストアに追加するのが正しい解決法です。
Q4. プロキシのパスワードに記号が含まれているとエラーになります
URL内で使う特殊文字はURLエンコードが必要です。たとえば@は%40、#は%23、!は%21に変換します。オンラインのURLエンコーダーで変換するか、専用のプロキシ認証ツール（cntlmなど）を使うと安全です。
Q5. エラーメッセージに「ENOTFOUND」と出ました。意味は？
DNS解決ができていない状態です。api.anthropic.comという名前を、コンピュータがIPアドレスに変換できていません。DNSサーバーの設定を見直すか、Wi-Fiルーターの再起動、8.8.8.8（Google DNS）への変更などを試してください。
Q6. テザリングのモバイル回線では動きますか？
動きます。むしろ会社ネットワークの問題を切り分けるのに便利です。テザリングで動けば「家庭・モバイル回線では問題なし、会社ネットワーク特有の問題」と判断できます。ただしデータ通信量に注意してください。
Q7. ネットワークエラーが時々しか出ないのですが、原因を特定できますか？
時間帯と症状をメモしておきましょう。「朝の始業時間に集中している」「会議室に移動すると出る」など、パターンが見つかれば原因の手がかりになります。ログを残す--verboseオプションがあれば有効にすると、後から原因を追いやすくなります。
まとめ
ClaudeCodeのネットワークエラーは、原因が多岐にわたるため一見難しく感じますが、「基本確認→タイムアウト→SSL→プロキシ→VPN→ファイアウォール」と順を追って切り分ければ、必ず解決の糸口が見つかります。特に会社のネットワークで使う場合は、情報システム部門との連携が欠かせません。「api.anthropic.comへの接続許可」「プロキシ設定」「社内CA証明書」の3点セットを最初に確認してもらえば、多くの問題は事前に防げます。本記事で紹介したコマンドや設定例をブックマークしておけば、いざという時の心強い味方になります。ネットワークは「目に見えないけれど確実に存在する」という性質上、最初は怖く感じるかもしれませんが、一度乗り越えればグッと自信がつきます。