Claude Codeは環境変数を通じて標準的なHTTP/HTTPSプロキシ設定をサポートしています。これにより、セキュリティ、コンプライアンス、監視の目的で、すべてのClaude Codeトラフィックを組織のプロキシサーバー経由でルーティングできます。

基本的なプロキシ設定

環境変数

Claude Codeは標準的なプロキシ環境変数を尊重します:

# HTTPSプロキシ(推奨)
export HTTPS_PROXY=https://proxy.example.com:8080

# HTTPプロキシ(HTTPSが利用できない場合)
export HTTP_PROXY=http://proxy.example.com:8080

Claude Codeは現在NO_PROXY環境変数をサポートしていません。すべてのトラフィックは設定されたプロキシ経由でルーティングされます。

Claude CodeはSOCKSプロキシをサポートしていません。

認証

基本認証

プロキシが基本認証を必要とする場合、プロキシURLに認証情報を含めてください:

export HTTPS_PROXY=http://username:password@proxy.example.com:8080

スクリプトにパスワードをハードコーディングすることは避けてください。代わりに環境変数や安全な認証情報ストレージを使用してください。

高度な認証(NTLM、Kerberosなど)を必要とするプロキシの場合、お使いの認証方法をサポートするLLM Gatewayサービスの使用を検討してください。

SSL証明書の問題

プロキシがカスタムSSL証明書を使用している場合、証明書エラーが発生する可能性があります。

正しい証明書バンドルパスを設定してください:

export SSL_CERT_FILE=/path/to/certificate-bundle.crt
export NODE_EXTRA_CA_CERTS=/path/to/certificate-bundle.crt

ネットワークアクセス要件

Claude Codeは以下のURLへのアクセスが必要です:

  • api.anthropic.com - Claude APIエンドポイント
  • statsig.anthropic.com - テレメトリとメトリクス
  • sentry.io - エラーレポート

これらのURLがプロキシ設定とファイアウォールルールで許可リストに登録されていることを確認してください。これは、コンテナ化された環境や制限されたネットワーク環境でClaude Codeを使用する場合に特に重要です。

追加リソース