Claude Codeの環境変数完全ガイド：ANTHROPIC_API_KEY、BASE_URL、MAX_THINKING_TOKENSの設定方法

Claude Codeの環境変数、全部わかってますか？ANTHROPIC_API_KEYから上級設定まで完全解説

Claude Codeの環境変数とは何か、settings.jsonとの違い

設定の優先順位は高い方から次の通りです。

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-xxxxx",
    "MAX_THINKING_TOKENS": "10000"
  }
}

ANTHROPIC_API_KEY：最も重要な環境変数の設定方法

セッション限定（ターミナルを閉じるとリセット）：

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxx"
claude

シェル設定ファイルに永続化（macOS/Linux）：

# ~/.zshrc または ~/.bashrc に追記
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Windows（PowerShell）：

$env:ANTHROPIC_API_KEY = "sk-ant-xxxxxxxxxxxxxxxxxx"
# または永続化する場合
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-xxxxxxxxxxxxxxxxxx", "User")

ANTHROPIC_BASE_URL：プロキシ経由でClaude Codeを使う方法

export ANTHROPIC_BASE_URL="https://your-proxy.example.com"

export ANTHROPIC_CUSTOM_HEADERS="X-Organization-ID: myorg
X-Environment: production"

AWSで使う：ANTHROPIC_BEDROCK_BASE_URLとBedrock連携の設定

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION="us-east-1"
# AWS認証情報はAWS CLIの設定またはIAMロールで管理

MAX_THINKING_TOKENS：思考バジェットを制御する

export MAX_THINKING_TOKENS="10000"

export MAX_THINKING_TOKENS="0"
# または専用変数で
export CLAUDE_CODE_DISABLE_THINKING=1

コンテキスト管理に関わる環境変数

MCP環境変数：claude code mcp 環境変数の設定

# MCPサーバーの起動タイムアウト
export MCP_TIMEOUT=30000

# MCPツールの実行タイムアウト
export MCP_TOOL_TIMEOUT=60000

settings.jsonでMCPサーバーを設定する

{
  "env": {
    "GITHUB_TOKEN": "ghp_xxxx"
  }
}

VSCodeでの環境変数設定：vscode claude code 環境変数

便利な運用系環境変数：設定を極める

# 仕事用
alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'
# プライベート用（デフォルト）
# claude

コスト警告とAPIタイムアウト

よく使う環境変数クイックリファレンス

個人利用（APIキーで使う）

# ~/.zshrc に追記
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxx"

企業内プロキシ経由で使う

export ANTHROPIC_BASE_URL="https://your-corporate-proxy.example.com"
export ANTHROPIC_AUTH_TOKEN="your-proxy-auth-token"
export ENABLE_TOOL_SEARCH=true

AWS Bedrock経由で使う

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION="us-east-1"
export ENABLE_PROMPT_CACHING_1H_BEDROCK=1  # キャッシュTTL延長

思考バジェットを固定値に制御する

export CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1
export MAX_THINKING_TOKENS="8000"

自動化・パイプラインで使う

export DISABLE_AUTOUPDATER=1
export DISABLE_COST_WARNINGS=1
export MCP_CONNECTION_NONBLOCKING=true

よくある質問とトラブルシューティング

まとめ：Claude Code環境変数の使い分け方

• 認証情報（ANTHROPIC_API_KEYなど）はシェル設定ファイルかユーザーレベルのsettings.jsonで管理する
• プロジェクトのsettings.jsonには絶対に書かない
• 環境変数はsettings.jsonのenvキーにも書けるので、チーム設定はそちらで管理する
• ANTHROPIC_API_KEYを設定するとサブスクリプションよりAPIキーが優先される点に注意
• 用途が決まったら、その用途に必要な変数だけ設定するのがシンプルで管理しやすい

---

出典

• Environment variables - Claude Code Docs（公式）
• Claude Code の設定 - Anthropic公式ドキュメント（日本語）