Claude Code 環境変数まとめてみた

Claude Code 環境変数リファレンス完全ガイド

Claude Codeの環境変数を体系的に整理しました。シェル設定での起動前適用と、settings.jsonのenvキーによるセッション・チーム単位での適用の両方に対応しています。

参考: code.claude.com/docs/ja/env-vars

設定方法

方法1: シェルで一時的に設定する

export ANTHROPIC_API_KEY="your-api-key"
claude

方法2: settings.json で永続化する

{
  "env": {
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1"
  }
}

settings.jsonのスコープ（user / project / managed）によって、個人・チーム・組織全体への適用範囲が決まります。

カテゴリ別 環境変数一覧

1. 認証・API接続

Claude APIへの認証とエンドポイント設定に使用します。

2. モデル設定

使用するモデルとエイリアスを制御します。

バージョン固定の例（Bedrock）:

export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-6-v1'
export ANTHROPIC_DEFAULT_SONNET_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

3. 動作・UX 制御

Claude Codeのインタラクションと出力フォーマットを制御します。

4. Bash・ツール実行

コマンド実行の動作を制御します。

5. コンテキスト・パフォーマンス最適化

コンテキストウィンドウとキャッシュ管理の設定です。

6. MCP（Model Context Protocol）

MCPサーバーの接続と操作を制御します。

MCP出力トークン数を増やす例:

export MAX_MCP_OUTPUT_TOKENS=50000

7. テレメトリ・監視（OpenTelemetry）

使用量測定とオブザーバビリティの設定です。

settings.jsonでテレメトリを有効化:

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

参考: code.claude.com/docs/ja/monitoring-usage

8. AWS Bedrock 連携

AWS Bedrock経由でClaudeを利用する設定です。

• AWS_REGIONは必須
• Claude Codeは.aws設定ファイルを読み込みません
• Bedrock使用時は/login・/logoutコマンドが無効化されます

設定例:

# 推論プロファイルIDを使用
export ANTHROPIC_MODEL='global.anthropic.claude-sonnet-4-6'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

# アプリケーション推論プロファイルARNを使用
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

# オプション: プロンプトキャッシュを無効化
export DISABLE_PROMPT_CACHING=1

参考: code.claude.com/docs/ja/amazon-bedrock

9. Google Vertex AI 連携

Google Vertex AI経由でClaudeを利用する設定です。

要件:

• 課金が有効なGCPプロジェクト
• Vertex AI APIの有効化
• Claudeモデルへのアクセス
• Google Cloud SDK（gcloud）のインストールと設定
• 対象リージョンでのクォータ割り当て

10. ネットワーク・プロキシ

ネットワーク接続を制御します。

11. ファイル・ディレクトリ設定

設定ファイルと作業ディレクトリの設定です。

12. IDE 連携

VS Code、Cursorなどとの統合設定です。

13. デバッグ・開発

デバッグとトラブルシューティングの設定です。

14. コマンド制限（エンタープライズ向け）

特定のコマンドや機能を無効化します（主にエンタープライズ展開向け）。

15. CI / CD・クラウド環境

CI/CDやクラウドプラットフォームで自動検出される変数です。

チートシート

個人開発：APIキーを設定する

# ~/.zshrc or ~/.bashrc に追加
export ANTHROPIC_API_KEY="your-api-key-here"

/statusで認証方法を確認できます。claude.aiサブスクリプションユーザーは、従量課金を避けるためにANTHROPIC_API_KEYを設定しないでください。

チーム展開：settings.json で共通設定を管理する

{
  "env": {
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "BASH_DEFAULT_TIMEOUT_MS": "30000",
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "https://your-otel-endpoint"
  }
}

AWS Bedrock 経由で利用する

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=my-bedrock-profile

# モデルバージョンを固定（推奨）
export ANTHROPIC_DEFAULT_SONNET_MODEL='us.anthropic.claude-sonnet-4-6'

Google Vertex AI 経由で利用する

export CLAUDE_CODE_USE_VERTEX=1
export ANTHROPIC_VERTEX_PROJECT_ID=my-gcp-project
export CLOUD_ML_REGION=us-east5
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

CI 環境で自動承認モードで動かす

export CLAUDE_CODE_ACTION=bypassPermissions
export ANTHROPIC_API_KEY="$CI_ANTHROPIC_KEY"

プロキシ経由でアクセスする

export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1

Docker / WSL でファイル監視を安定させる

export CHOKIDAR_USEPOLLING=true
export CHOKIDAR_INTERVAL=500

設定の優先順位

Claude Codeは以下の優先順位で設定を適用します（上が最優先）:

1. Managed — MDMまたはmanaged-settings.jsonによる展開
2. コマンドライン引数 — 起動時の--modelなどのフラグ
3. プロジェクト設定 — .claude/settings.json
4. ユーザー設定 — ~/.claude/settings.json

settings.jsonのenvキーで環境変数を管理すると、スコープに基づいた制御が可能になります。

参考リンク

• 公式: 環境変数リファレンス
• 公式: Claude Code設定
• 公式: モデル設定
• 公式: Amazon Bedrock連携