Claude Codeのproxy設定完全ガイド【2026年最新】：HTTPS_PROXY・NO_PROXY・APIゲートウェイ・LiteLLMまで徹底解説

Claude Codeのproxy設定完全ガイド【2026年最新】：HTTPS_PROXY・NO_PROXY・APIゲートウェイ・LiteLLMまで徹底解説

Claude Codeのproxyとは？なぜ必要なのか

• api.anthropic.com — Claude APIエンドポイント
• claude.ai — claude.aiアカウントでの認証
• platform.claude.com — Anthropic Consoleアカウントでの認証

環境変数でHTTPS_PROXY・HTTP_PROXYを設定する

# HTTPS proxy（推奨）
export HTTPS_PROXY=https://proxy.example.com:8080

# HTTP proxy（HTTPS_PROXYが使えない場合）
export HTTP_PROXY=http://proxy.example.com:8080

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

# ~/.bashrc または ~/.zshrc に追記
export HTTPS_PROXY=https://proxy.example.com:8080
export NO_PROXY="localhost,127.0.0.1"

{
  "env": {
    "HTTPS_PROXY": "https://proxy.example.com:8080",
    "NO_PROXY": "localhost,127.0.0.1"
  }
}

NO_PROXYで除外ホストを設定する

# カンマ区切り
export NO_PROXY="localhost,192.168.1.1,example.com,.example.com"

# スペース区切りも有効
export NO_PROXY="localhost 192.168.1.1 example.com .example.com"

# プロキシを完全に無効化する（全ホストをバイパス）
export NO_PROXY="*"

settings.jsonのnetwork設定でポートを指定する

{
  "sandbox": {
    "enabled": true,
    "network": {
      "httpProxyPort": 8080,
      "socksProxyPort": 8081
    }
  }
}

{
  "sandbox": {
    "enabled": true,
    "enableWeakerNetworkIsolation": true
  }
}

ANTHROPIC_BASE_URLでAPIゲートウェイ・プロキシを経由する

# LiteLLMのプロキシサーバーを経由する例
export ANTHROPIC_BASE_URL=https://litellm-server:4000

# OpenRouterを経由する例
export ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1

# LiteLLMのAPIキーを使う場合
export ANTHROPIC_BASE_URL=https://litellm-server:4000
export ANTHROPIC_AUTH_TOKEN=sk-litellm-static-key

社内ネットワーク（コーポレートプロキシ）への対応

export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca-cert.pem

1. HTTPS_PROXYでプロキシURLを設定
2. NO_PROXYでローカル・社内ホストを除外
3. SSL/TLSインスペクションがある場合はNODE_EXTRA_CA_CERTSでCA証明書を追加
4. これで繋がらない場合は、そもそもプロキシ自体がapi.anthropic.comへのアクセスを許可しているか確認

LiteLLMをプロキシとして使う

export ANTHROPIC_BASE_URL=https://litellm-server:4000
export ANTHROPIC_AUTH_TOKEN=sk-litellm-static-key

export ANTHROPIC_BASE_URL=https://litellm-server:4000/anthropic

{
  "apiKeyHelper": "~/bin/get-litellm-key.sh"
}

export CLAUDE_CODE_API_KEY_HELPER_TTL_MS=3600000

OpenRouterをプロキシとして使う

export ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1
export ANTHROPIC_AUTH_TOKEN=sk-or-v1-xxxxxxxx

カスタムCA証明書とmTLS認証

# 会社のカスタムCA証明書を追加
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

# クライアント証明書
export CLAUDE_CODE_CLIENT_CERT=/path/to/client-cert.pem

# クライアントの秘密鍵
export CLAUDE_CODE_CLIENT_KEY=/path/to/client-key.pem

# 秘密鍵にパスフレーズがある場合（オプション）
export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"

プロキシ設定のトラブルシューティング

接続できない・タイムアウトする

echo $HTTPS_PROXY
echo $NO_PROXY

curl -v --proxy https://proxy.example.com:8080 https://api.anthropic.com

これでエラーが出る場合、プロキシサーバーへのアクセス自体に問題があります。

NO_PROXYが効かない

# Claude Codeを最新版に更新
claude update

MCPサーバーが外部接続できない

{
  "env": {
    "HTTPS_PROXY": "https://proxy.example.com:8080"
  }
}

プロキシ設定を一元管理するベストプラクティス

よくある質問

SOCKSプロキシは使えますか？

settings.jsonのnetwork.socksProxyPortはSOCKSプロキシを使う設定では？

プロキシ設定してもMCPが動かないのですが？

claude code proxy apiという形でAPIアクセスを制限できますか？

OllamaをClaude Codeのプロキシとして使えますか？

まとめ

---

出典

• Enterprise network configuration - Claude Code Docs
• LLM gateway configuration - Claude Code Docs
• Claude Code settings - docs.anthropic.com