Claude Code と Cursor は同じプロキシ設定で動きますか？

どちらも最終的には Anthropic API や関連ホストへ HTTPS で出ますが、起動方法やサンドボックス、拡張機能の有無が異なるため、IDE ごとに環境変数の継承がずれることがあります。共通のシェル設定に加え、各 IDE のターミナル起動環境を個別に確認してください。

Anthropic API がタイムアウトするのはプロキシだけが原因ですか？

単一出入口のボトルネック、DNS の失敗、TLS インターセプト、API キーの期限切れ、レート制限、モデル名の誤指定など、複合要因が普通です。プロキシログと Claude Code のエラーメッセージを突き合わせて切り分けます。

npm install だけ失敗するときは何を疑えばよいですか？

registry.npmjs.org や tarball 配信元がルールに載っていない、IPv6 経路が迂回不良、社内ミラーとプロキシの二重設定などが典型です。npm config get registry で向き先を確認し、Clash ログで実際の FQDN を拾ってください。

Claude Opus 4.7 を使うときネットワーク設定は変わりますか？

エンドポイントのホスト名はモデル世代で大きく変わることは少ないですが、長いコンテキストやエージェント実行では応答時間が伸び、短いデフォルトタイムアウトで切断に見えることがあります。経路安定化に加え、クライアント側のタイムアウト値も現実的な RTT に合わせてください。

Claude Code·Clash Verge Rev

2026 年に入り、Claude Opus 4.7 やエージェント型ワークフローが開発現場の話題になる一方、ターミナルから動かす Claude Code を試した開発者から「Anthropic API がタイムアウトする」「npm install だけ途中で止まる」という声が増えています。原因の多くは API キーや課金ではなく、経路の分裂——ブラウザは通るのに CLI は直結、IDE 内ターミナルだけ別設定、といった状態——にあります。本稿は Clash Verge Rev を前提に、ルール分岐で api.anthropic.com、コンソール、npm／GitHub 関連ホストを明示的に扱い、 Claude Code を含む Anthropic 開発環境を安定させるための実務ガイドです。

Claude Code の画面ラベルや CLI フラグは更新頻度が高いため、具体操作は Anthropic 公式ドキュメントとリリースノートを一次情報にしてください。ここでは再現性の高いネットワーク設計と切り分けの順序に絞ります。 Cursor など他 IDE との比較は末尾で触れますが、本稿の主役は Claude Code と Clash の組み合わせです。

1. なぜ Claude Code では「API だけ」「npm だけ」失敗しやすいのか

Claude Code は、ローカルのプロジェクトディレクトリを読み、Anthropic API へストリーミングリクエストを送る CLI 型ツールです。その過程で、設定ファイルの取得、依存パッケージのインストール、Git 操作、場合によってはブラウザでの OAuth やコンソール確認が絡みます。各ステップが別プロセス・別プロキシ設定を参照するため、「会話は始まるが途中で固まる」「初回だけ npm が落ちる」といった部分成功が起きやすい構造です。

さらに 2026 年時点では Claude Opus 4.7 のような大規模モデル利用で応答時間が伸び、ネットワークがやや不安定なだけでクライアント側の短いタイムアウトに先に到達し、「API が落ちている」ように見えるケースもあります。対処の第一歩は、単に「代理 ON／OFF」を切り替えることではなく、 どのホスト集合をどのポリシーに寄せるかを Clash のルールで明示することです。

2. 事前準備：プロファイル、DNS、TUN とシステムプロキシ

まず購読 URL または手元の YAML が信頼できる入手経路から来ていることを確認してください。ルールを書く前に壊れたプロファイルでは議論にならません。続いて DNS を決めます。企業ネットワークでは社内リゾルバがサードパーティ DNS を上書きし、 api.anthropic.com だけ解決が遅延する、といった偏りが出ます。 Clash の nameserver と fallback を整えてから API 疎通を見てください。

Claude Code はターミナル起動が基本のため、ブラウザ向けのシステムプロキシだけでは不十分なことが多いです。 ブラウザ中心で CLI は軽いならシステムプロキシで足りる一方、 Node 製ツールや子プロセスまで同一ポリシーで透過したいならTUN（または同等の全トラフィックキャプチャ）が安定します。 TUN は管理者権限やドライバ許可を要することがあるため、会社端末では事前申請が必要です。いずれにせよ、トグルを頻繁に切り替えるより、ルールで用途別に振り分ける方がログも残り、後から説明しやすいです。

3. Anthropic API とコンソールをルールで固定する

API 呼び出しの中心は api.anthropic.com です。管理や課金確認では console.anthropic.com、ドキュメントは docs.anthropic.com、場合によっては claude.ai 系のホストも HTTPS で並列に開きます。購読提供者のデフォルトルールが「漏れたものだけ DIRECT」だと、CDN やリージョンの組み合わせで一部だけ別経路に落ち、認証 Cookie やリダイレクトが微妙にズレることがあります。

実装イメージとしては、プロファイルの上位で Anthropic 関連サフィックスを明示し、希望するプロキシグループへ寄せます。ここでは説明用に疑似 YAML を置きますが、実際のキー名やインデントは手元のコア仕様に合わせてください。

# Illustrative rule snippet — adapt keys to your profile schema
rules:
  - DOMAIN-SUFFIX,anthropic.com,Proxy
  - DOMAIN-SUFFIX,claude.ai,Proxy
  - DOMAIN,api.anthropic.com,Proxy

anthropic.com のような広いサフィックスは他サービスと衝突しにくい一方、社内ポリシーでサブドメインを直結させたい場合は、ログで実際にヒットした FQDN だけをピンポイントで追加する方が安全です。 Claude Code からのリクエストはほぼ必ず api.anthropic.com に集約されるため、まずここが期待ポリシーに載っているかを Clash Verge Rev のログで確認するのが近道です。

TLS インターセプトを行うプロキシ配下では、ルート証明書を OS と Node ランタイムの両方に信頼させないと、ブラウザだけ成功して Claude Code が証明書エラーになる、という分裂が起きます。まずはブラウザとターミナルで同じ失敗メッセージかを見比べてください。

4. Claude Opus 4.7 と長時間ストリーム：タイムアウトをネットワークと切り分ける

モデル名を Claude Opus 4.7 に指定した場合、コンテキストが大きいほど初回トークンまでの待ち時間が伸びます。プロキシ経由でレイテンシが跳ねていると、CLI のデフォルトが短いままだと「接続失敗」と誤認しやすいです。経路を安定させたうえで、クライアントやラッパーのタイムアウトを現実的な RTT に合わせてください。

切り分けの順番は次がおすすめです。 ① DNS が期待どおりか、② TLS が途中で置換されていないか、③ プロキシ経由でパケットロスがないか、④ API キーと組織の利用枠は十分か。 ④ まで問題なければ、モデル指定やエージェントループ側のロジックを疑います。「Opus 4.7 だけ遅い」のではなく、同じホストでもペイロードが大きいと時間がかかる——という理解があると混乱が減ります。

5. npm・GitHub・パッケージレジストリを別バケツに切り出す

Claude Code のセットアップやプラグイン導入では npm install や npx が走ります。典型的なホストは registry.npmjs.org、tarball 配信元、raw.githubusercontent.com などです。 API はプロキシ経由で通っているのに、npm だけ DIRECT のまま残っていると、「会話はできるが依存が入らない」という状態になります。

# npm / GitHub (illustrative)
rules:
  - DOMAIN-SUFFIX,npmjs.org,Proxy
  - DOMAIN-SUFFIX,npmjs.com,Proxy
  - DOMAIN-SUFFIX,github.com,Proxy
  - DOMAIN-SUFFIX,githubusercontent.com,Proxy

社内ミラー（例：プライベート Verdaccio）を使う場合は、その FQDN を NO_PROXY に入れ、パブリックレジストリだけをプロキシへ送る二段構えが無難です。 npm config get registry で向き先を確認し、Clash ログで実際にマッチしたドメインを拾ってルールを足してください。中国本土などで公式レジストリが不安定な場合は、ミラー URL をレジストリに設定したうえで、そのミラーのホストもルールに含めます。

6. 環境変数：CLI・IDE・Claude Code にプロキシ方針を伝える

Node 系 CLI は HTTPS_PROXY、HTTP_PROXY、NO_PROXY を解釈します。グローバルシェルに書くより、プロジェクトの .env を読み込むラッパーや、 IDE の「統合ターミナル起動環境」に閉じた方が事故が減ります。 Claude Code を起動したシェルと、別タブのシェルで変数が違うと、再現不能な失敗が増えます。

最小権限の列挙。ローカルホスト、社内 Git、プライベートレジストリだけを直結。
ワイルドカードの濫用禁止。NO_PROXY を広げすぎると、Anthropic 系が迂回漏れする例もあります。
大文字小文字の二重管理。一部ツールは https_proxy のみを読みます。セットアップスクリプトで両方に同期すると安定します。

Windows と Unix で変数の継承順が異なる点にも注意してください。「ターミナルでは curl が通るが IDE から起動した Claude Code だけ失敗する」は、親プロセスがサービスとして動きユーザー環境を読まないパターンが多いです。その場合は IDE 側の proxy 設定とシェルの export を突き合わせます。

7. Claude Code と Cursor：同じ Anthropic でも経路は揃わない

「Claude Code vs Cursor」という比較記事が増えていますが、ネットワーク設計の観点では共通点と相違点があります。どちらも最終的には Anthropic の HTTPS エンドポイントへ向かう一方、 Cursor は独自のインデックスや拡張機能経由で別ホストにも触れることがあります。 Claude Code はより CLI・リポジトリ直結に近いため、ターミナルのプロキシ設定がそのまま効くかが成否を分けます。

両方を併用する開発者は、共通の Clash プロファイルに Anthropic と npm／GitHub を載せ、 IDE ごとの差は NO_PROXY のみ最小限で調整するのがおすすめです。片方だけ TUN、片方だけシステムプロキシ、という構成はログが読みにくくなります。

8. API キー・認証・レート制限：ネットワーク以外の典型原因

プロキシを整えても 401／403／429 が続く場合は、ネットワーク以外を疑います。組織アカウントの利用上限、API キーのスコープ、請求ステータス、モデル名の typo（claude-opus-4-7 など公式表記との差）が典型です。単体で curl を使い、同じキー・同じホストへ最小リクエストを送ると切り分けが早いです。

セキュリティ面では、API キーをシェル履歴やスクリーンショットに残さない、プロキシログに機密ヘッダが出ないよう運用する、といった基本がエージェント利用ほど重要になります。 Clash 自体が MITM しない構成でも、上流プロバイダのポリシーは確認してください。

9. ログ駆動の改善とチェックリスト

ルール追加は推測だけで進めないでください。 Clash Verge Rev のログに出るマッチ結果を見ながら、意図しない DIRECT／REJECT を潰します。 Anthropic や npm は CDN・計測ドメインが増えがちなので、一度通したあとでもプロファイル更新で FQDN 集合が変わることがあります。

プロファイル入手経路と整合性確認が済んでいる。
api.anthropic.com とコンソール系がログで期待ポリシーに一致。
registry.npmjs.org 等、npm／GitHub が同じポリシーか意図的に分離されている。
HTTPS_PROXY と NO_PROXY が Claude Code 起動シェルと IDE で齟齬がない。
長時間ストリーム時のタイムアウトが現実の RTT に合っている。

ここまで整えれば、Claude Code を軸にした試行は「ネットワークが謎に不安定」という曖昧なブロッカーから解放され、 Claude Opus 4.7 を含むモデル評価やエージェント動作の検証に時間を使えるようになります。 Windows での初期セットアップは Windows 10 向け Clash Verge Rev インストール記事、一般的なプロファイル運用は Windows 向け設定ガイドを参照してください。 AWS エコシステム向けの類似手順は AWS Agent Toolkit 向け安定ルーティング記事にまとめてあります。

10. よくある質問

Claude Code だけ 403 になるのはプロキシのせいですか？ 必ずしもそうではありません。地域制限、組織ポリシー、キーの権限不足も多いです。プロキシを一時 OFF にして同一キーで再現するか、公式ステータスとドキュメントを確認してください。

TUN と会社 VPN は両立できますか？ 競合し得ます。既定ルートや DNS が二重にかかると抜け穴ができます。まずはどちらか片方を一時停止して再現性を確認し、必要なら分割トンネルを設計し直してください。

ルールを増やすほど安全ですか？ いいえ。明示性は上がりますが、レビュー負債も増えます。ログで実測した FQDN から最小追加を繰り返すのが現実的です。

本稿は Claude Code の機能説明ですか？ いいえ。入出力仕様や対応コマンドは Anthropic 公式が最速です。本稿はあくまでClash Verge Rev で経路を安定させるための型です。組み合わせて読むと迷子になりにくいです。

Claude Code 開発実測：Clash Verge Rev で Anthropic API と npm を安定ルーティングする