Environment Variables¶

Alle Environment-Variablen die Claude Code steuern.

Wichtig: Wo setzen?¶

Nicht in .bashrc

Claude Code liest .bashrc nicht zuverlässig.

Immer in ~/.claude/settings.json:

{
  "env": {
    "VARIABLE_NAME": "value"
  }
}

Authentifizierung¶

ANTHROPIC_API_KEY¶

API-Key für direkte Anthropic API:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-api03-..."
  }
}

AWS Bedrock¶

{
  "env": {
    "CLAUDE_CODE_USE_BEDROCK": "1",
    "AWS_REGION": "us-east-1",
    "AWS_ACCESS_KEY_ID": "AKIA...",
    "AWS_SECRET_ACCESS_KEY": "..."
  }
}

Google Vertex AI¶

{
  "env": {
    "CLAUDE_CODE_USE_VERTEX": "1",
    "GOOGLE_CLOUD_PROJECT": "my-project",
    "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
  }
}

Model-Konfiguration¶

CLAUDE_CODE_MAX_OUTPUT_TOKENS¶

Maximale Output-Länge:

{
  "env": {
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8192"
  }
}

Default: 4096

CLAUDE_CODE_MODEL¶

Alternatives Model (überschreibt settings.json):

{
  "env": {
    "CLAUDE_CODE_MODEL": "claude-opus-4-20250514"
  }
}

Verhalten¶

CLAUDE_CODE_DISABLE_BACKGROUND_TASKS¶

Background Tasks deaktivieren:

{
  "env": {
    "CLAUDE_CODE_DISABLE_BACKGROUND_TASKS": "1"
  }
}

CLAUDE_CODE_TASK_LIST_ID¶

Shared Task-Liste zwischen Sessions:

{
  "env": {
    "CLAUDE_CODE_TASK_LIST_ID": "my-project"
  }
}

Tasks werden in ~/.claude/tasks/my-project/ gespeichert.

CLAUDE_CODE_GIT_BASH_PATH¶

Windows: Pfad zu Git Bash:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

MCP-Konfiguration¶

MCP_TIMEOUT¶

Timeout für MCP-Server-Start (ms):

{
  "env": {
    "MCP_TIMEOUT": "10000"
  }
}

Default: 5000 (5 Sekunden)

MAX_MCP_OUTPUT_TOKENS¶

Max Tokens für MCP-Tool-Output:

{
  "env": {
    "MAX_MCP_OUTPUT_TOKENS": "50000"
  }
}

Default: 10000. Warnung wenn überschritten.

Debugging¶

DEBUG¶

Debug-Logging aktivieren:

{
  "env": {
    "DEBUG": "claude:*"
  }
}

Patterns: - claude:* - Alles - claude:api - API-Calls - claude:tools - Tool-Ausführung - claude:mcp - MCP-Server

Referenz-Tabelle¶

Variable	Default	Beschreibung
`ANTHROPIC_API_KEY`	-	API Key
`CLAUDE_CODE_USE_BEDROCK`	0	AWS Bedrock nutzen
`CLAUDE_CODE_USE_VERTEX`	0	Google Vertex nutzen
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	4096	Max Output
`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`	0	Background Tasks aus
`CLAUDE_CODE_TASK_LIST_ID`	-	Shared Task-Liste
`MCP_TIMEOUT`	5000	MCP Startup Timeout
`MAX_MCP_OUTPUT_TOKENS`	10000	MCP Output Limit
`DEBUG`	-	Debug-Logging

Beispiel: Vollständige Konfiguration¶

{
  "model": "claude-sonnet-4-20250514",
  "maxTokens": 8192,
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-api03-...",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8192",
    "MCP_TIMEOUT": "10000",
    "DEBUG": "claude:api,claude:tools"
  }
}

Umgebungsvariablen prüfen¶

Im Claude Code Terminal:

Show me my current environment configuration

Oder direkt:

claude --print-config