Claude Code — Umgebungsvariablen Referenz

{
  "env": {
    "ANTHROPIC_MODEL": "opus",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "CLAUDE_CODE_EFFORT_LEVEL": "medium",
    "DISABLE_PROMPT_CACHING": "0",
    "USE_BUILTIN_RIPGREP": "0"
  }
}

# .env (nie committen!)
ANTHROPIC_API_KEY=sk-ant-production-key
ANTHROPIC_MODEL=opus

# Alternative für Staging:
# ANTHROPIC_API_KEY=sk-ant-staging-key
# ANTHROPIC_MODEL=sonnet

# Benutzung:
claude code "code task"
# → Nutzt Opus mit Production Key

# .claude/settings.json (Projekt-Level)
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://custom-gateway.mycompany.com",
    "ANTHROPIC_API_VERSION": "2024-06",
    "ANTHROPIC_MODEL": "sonnet"
  }
}

# Alle im Team nutzen jetzt den Custom Gateway
# automatisch, ohne individuelle Setup

# Windows:
set HTTP_PROXY=http://corp-proxy.company.com:8080
set HTTPS_PROXY=http://corp-proxy.company.com:8080
set NODE_EXTRA_CA_CERTS=C:\certs\corporate-ca.pem

# Linux/Mac:
export HTTP_PROXY=http://corp-proxy.company.com:8080
export HTTPS_PROXY=http://corp-proxy.company.com:8080
export NODE_EXTRA_CA_CERTS=/etc/ssl/certs/corporate-ca.pem

# Start Claude Code
claude code "task"

# settings.json
{
  "env": {
    "ANTHROPIC_MODEL": "opus",
    "CLAUDE_CODE_DISABLE_1M_CONTEXT": "0",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "DISABLE_PROMPT_CACHING": "0"
  }
}

# Nutzt volles 1M Context Window + Maximum Reasoning
# Für komplexe Refactorings großer Repos

1. Shell:     ANTHROPIC_MODEL=opus
2. Project:   .claude/settings.json → ANTHROPIC_MODEL=sonnet
3. User:      ~/.claude/settings.json → ANTHROPIC_MODEL=haiku

Welche gewinnt?

Antwort: Shell (höchste Priorität!)

claude code "complex task"
→ Nutzt OPUS, nicht sonnet, nicht haiku

# ✓ Richtig
export ANTHROPIC_API_KEY=$(cat ~/.secrets/api-key.enc | decrypt)

# ✓ Richtig (mit Pass/1Password/LastPass)
export ANTHROPIC_API_KEY=$(pass show anthropic/api-key)

# ✗ FALSCH
export ANTHROPIC_API_KEY=sk-ant-abc123  # In Shell History!

# ✗ FALSCH (in File sichtbar)
echo "ANTHROPIC_API_KEY=sk-ant-abc123" >> ~/.bashrc
# Andere User können das lesen!

# ✗ Proxy-Password in Text
HTTP_PROXY=http://user:[email protected]:8080

# ✓ Proxy-Password anderswo speichern
HTTP_PROXY=http://proxy.com:8080
# (authentifizierung über .netrc oder credential manager)

# Logging aktivieren
export CLAUDE_CODE_DEBUG=1

# Alle API Calls werden geloggt
# Überprüfe was Claude Code sendet

echo $ANTHROPIC_API_KEY
# Wenn leer → Variable nicht gesetzt

# Fix:
export ANTHROPIC_API_KEY=sk-ant-...
# Oder in settings.json

curl -X POST https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  # Falls timeout → Proxy-Fehler

# Fix:
export HTTPS_PROXY=http://proxy:port
export NODE_EXTRA_CA_CERTS=/path/to/ca.pem

echo $ANTHROPIC_MODEL
# Falls "default" → Wird automatisch zu aktuellem Model

# Explizit setzen:
export ANTHROPIC_MODEL=claude-opus-4-6

export CLAUDE_CODE_DISABLE_SANDBOX=1
claude code "ls -la /"  # Sollte jetzt ohne Sandbox laufen

# Verifizieren:
echo $CLAUDE_CODE_DISABLE_SANDBOX

# Default: 1M Context deaktiviert = 128K
export CLAUDE_CODE_DISABLE_1M_CONTEXT=0

# Jetzt: Voller 1M Token Context für dein Projekt
# Claude sieht ALLES auf einmal

# Default: 30 Sekunden Warten pro Turn
# Erhöhe es für große Operationen

export CLAUDE_CODE_MAX_TURNS=100
# (benützt weiterhin 30s/Turn, aber max 100 Turns)

export NODE_OPTIONS=--max-old-space-size=4096
# Erhöhe Node.js Memory zu 4GB (von default 2GB)

# .claude/settings.json (ins Git)
{
  "env": {
    "ANTHROPIC_API_VERSION": "2024-06",
    "ANTHROPIC_MODEL": "sonnet",
    "CLAUDE_CODE_EFFORT_LEVEL": "medium",
    "DISABLE_PROMPT_CACHING": "0"
  }
}

# Commit und push
git add .claude/settings.json
git commit -m "Configure Claude Code for team"

# User machen einmalig:
export ANTHROPIC_API_KEY=their-own-key

# Oder in Home-Directory:
~/.claude/settings.json (NIEMALS versioniert!)
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-user-key"
  }
}